← Vissza a használati útmutatóhoz
Példák külső adatokra

Kezdés nyilvános tesztadatokkal

Ha csatlakoztatta az adatbázisát, de nincs mit beletennie, kezdjen az alábbi három egyikével. Mindegyik ingyenes és API-kulcs nélkül letölthető; elég lépésről lépésre követni a betöltő szkriptet és a képernyőn választandó értékeket (táblázat, oszlop). A szkript elemzőkkel bővíthető, így ha más forrást szeretne, elég egyetlen tételt hozzáírni.

Kezdés előtt — Előbb adatbázis-kapcsolat és csak olvasható fiók kell — Supabase-integrációs útmutató

A gyűjtő letöltése

Klónozza a fetcher-repót a VPS-re (arra a szerverre, ahol az ügynök van). Egyetlen függősége a pg. ★ A .env DATABASE_URL értéke írási jogú fiók legyen. A csak olvasható fióknál az INSERT elutasítása normális — az a fiók kizárólag a SoriTrading-integrációhoz való.

git clone https://github.com/Value-Connect-Global-Inc/soritrading-fetchers ~/soritrading-fetchers
cd ~/soritrading-fetchers && npm install
cp .env.example .env    # DATABASE_URL

https://github.com/Value-Connect-Global-Inc/soritrading-fetchers · Nyílt forráskód · egy mappa = egy fetcher · automatikus cron-regisztráció

Az alábbi három **kezdő példa**. A repóban további adatok is vannak: VIX, kriptó implikált volatilitás (DVOL), hozamgörbe-meredekség, dollárindex, stablecoin-piaci kapitalizáció, DeFi TVL stb. — mind ingyenes, kulcs nélkül. A teljes listát a `node run.mjs list` mutatja. A piaci adatoknak az amerikai munkaszüneti napokon nincs értéke (nem 0, hanem hiányzik), a DVOL 2021 márciusától érhető el.

Hogyan olvassa az adatbeállítások képernyőt

Ügynökök kezelése → ügynök kiválasztása → Adatbeállítások fül. Regisztrálni és törölni ezen a képernyőn csak Ön tud — az MI csak olvassa az adatkészleteket, a kapcsolati karakterláncot pedig soha ne illessze be a csevegésbe. A képernyő felülről lefelé ebben a sorrendben épül fel.

  1. Külső adatbázis csatlakoztatása — Adja meg a kapcsolat nevét (pl. main) és a kapcsolati karakterláncot. Csak az ügynökeszközön tárolódik titkosítva, a szerverre nem kerül. A képernyő megnyitásakor az ügynök automatikusan beolvassa a táblázatlistát (a [Kapcsolat ellenőrzése] az újraolvasáshoz kell).
  2. Táblázatok és adatkészletek — Az adatbázis minden táblázatához egy sor tartozik: táblázatnév · hozzávetőleges sorszám · táblázat-megjegyzés, alatta pedig az adott táblázatot olvasó adatkészletek.
  3. MI-nyilvánossági szint (a táblázatsor jobb oldalán) — Privát (alapértelmezés — az MI azt sem tudja, hogy a táblázat létezik) · csak név · oszlopokkal · mintával · lekérdezés engedélyezve. Kiválasztás után [Nyilvánossági beállítás mentése]. Oszlop-, minta- és lekérdezési szinten valódi adatok mennek az MI-hez, ezért személyes adatokat tartalmazó táblázatot ne nyisson meg. Csak a public séma táblázatai nyithatók meg.
  4. Adatkészletnevek (a táblázatsor alatt) — Ezen a néven hívja a stratégia: ctx.data(név). [+ Adatkészlet hozzáadása ebből a táblázatból] → név, időbélyeg-oszlop és értékoszlop kiválasztása után a leírást a táblázat-megjegyzés tölti ki, és a [Mentés] csak a [Teszt] sikere után válik elérhetővé. Egy táblázathoz több név is tartozhat (ha szűrővel tőzsdénként vagy instrumentumonként bontja a sorozatot, vagy ha régi stratégia más nevet használ). Állapotjelzők: elérhető · ellenőrzés előtt · nincs kapcsolat. A jelző melletti valós idejű jelzőre kattintva kinyílnak az ébresztési beállítások (poll, notify, redis) — többnyire az alapérték megfelel.
  5. Számított adatkészlet (SQL) — Számítást igénylő értékek, például mozgóátlag, késleltetett érték vagy több táblázat kombinációja. Mivel az SQL több táblázatot is olvashat, nem egy adott táblázat alatt, hanem külön gyűjtjük. A legtöbb számítás a stratégiakódban két ctx.data hívással is elvégezhető, ezért SQL-t csak akkor használjon, ha a számításhoz a teljes múltbeli időszak kell (mozgóátlag, rangsor). A korábbi módon regisztrált SQL itt [SQL ellenőrizve] vagy [Törlés] lehet, egyszerű szerkezet esetén pedig tömegesen átalakítható táblázatválasztós formára.
  6. Táblázat nélkül maradt adatkészletek — Ha a deklarált táblázat jelenleg nincs a listában, az adatkészlet nem tűnik el, hanem az okkal együtt itt marad — a táblázatlista még nem érkezett meg (ez nem azt jelenti, hogy nincs) · abban az adatbázisban nincs ilyen táblázat (átnevezés vagy törlés) · ezen az eszközön nincs ilyen kapcsolatnév.
  7. Két hatókör van — Az MI-nyilvánossági szint csak azon az eszközön tárolódik, amelyen éppen megnyitotta. Az adatkészletek minden olyan eszközre vonatkoznak, amelyen ugyanaz a kapcsolatnév van. Több eszköz esetén a nyilvánossági szintet eszközönként külön kell beállítani.

1. Félelem-kapzsiság index

alternative.me

0 (extrém félelem) és 100 (extrém kapzsiság) között, naponta egyszer. 2018-02-től a teljes időszakra. Az árból nem látható hangulati tengely, ezért ideális első tesztnek.

node run.mjs fear-greed
Az adatbeállítások képernyőn választandó értékek (a táblázatsor [+ Adatkészlet hozzáadása ebből a táblázatból] gombja)
Kapcsolat: main   ·   Táblázat: fear_greed
Név: fg   ·   Időbélyeg-oszlop: ts   ·   Értékoszlop: v
Regisztráció után elég ezt mondania az MI-nek
„A fg adatkészletemmel teszteld vissza binance BTC 1d-n azt a stratégiát, amely 20 alatti félelem-kapzsiság indexnél vesz, 60 felett elad”

2. Bitcoin hashrate

blockchain.com

Magának a láncnak a mutatója (TH/s). Az ártól eltérő tengely, ezért rezsimszűrőnek alkalmas. Az érték nagy és a trend lassú, ezért a nyers érték helyett jobb a mozgóátlaghoz viszonyított arányát használni.

node run.mjs btc-hashrate
Az adatbeállítások képernyőn választandó értékek (a táblázatsor [+ Adatkészlet hozzáadása ebből a táblázatból] gombja)
Kapcsolat: main   ·   Táblázat: btc_hashrate
Név: hashrate   ·   Időbélyeg-oszlop: ts   ·   Értékoszlop: v
Regisztráció után elég ezt mondania az MI-nek
„Tegyél a meglévő stratégiámba egy szűrőt, hogy csak akkor vegyen, ha a hashrate adatkészlet a 90 napos átlaga felett van”

3. Amerikai alapkamat (gyakorláshoz)

FRED (DFF)

Napi tényleges szövetségi alapkamat. A makrorezsim-szűrők tipikus értéke. ★ Figyelem: ugyanez az érték alapmutatóként már érkezik base_fedfunds néven (ctx.data('base_fedfunds') — az ügynök gyűjti a FRED-ből). Ha ugyanazt az értéket két úton adja meg, az eredményből nem derül ki, melyiket használta, ezért ezt csak az integráció gyakorlására használja.

node run.mjs fed-funds
Az adatbeállítások képernyőn választandó értékek (a táblázatsor [+ Adatkészlet hozzáadása ebből a táblázatból] gombja)
Kapcsolat: main   ·   Táblázat: macro_fed_funds
Név: dff   ·   Időbélyeg-oszlop: ts   ·   Értékoszlop: v
Regisztráció után elég ezt mondania az MI-nek
„Mutasd az adatkészletlistát, és ellenőrizd, hogy a dff elérhető állapotban van-e (integrációs ellenőrzés)”

Periodikus gyűjtés (cron)

Minden fetcher a saját deklarált gyakoriságával kerül a crontabba. Újrafuttatáskor sem halmozódnak a sorok, és a kézzel felvett cron-bejegyzésekhez nem nyúl. A naplók a logs mappában, fetcherenkénti naplófájlokban maradnak.

node run.mjs --install-cron
Tudnivalók
  • Az időbélyeg-oszlophoz másodperc alapú epoch ajánlott (ezredmásodperc és ISO is automatikusan felismerhető, és hogy melyikként olvastuk, az ellenőrzési jelentés tsUnit mezőjében látszik).
  • A szkript biztonságosan újrafuttatható — duplikáció nélkül csak a legfrissebb értékeket frissíti (upsert). Új adatokhoz egyszerűen futtassa le rendszeresen.
  • A visszateszt-eredményekben megmarad az adatok ujjlenyomata (sorszám, hash) — ha az adatbázis tartalma változik, az ujjlenyomat is, és két eltérő ujjlenyomatú eredmény nem azonos feltételek mellett készült.
  • A külső adatokat használó visszatesztek is az ügynökben futnak — minden visszateszt kizárólag az ügynökben (saját tárolóban) fut.
  • A nyilvánossági szintet kapott táblázatok láthatók az MI számára (az oszlop-, minta- és lekérdezési szinten valódi adatok mennek ki) — személyes adatokat tartalmazó táblázatot ne tegyen nyilvánossá.