← Torna a la guia d'ús
Exemples de dades externes

Comença amb dades públiques gratuïtes per provar

Si has connectat la teva BD però no hi tens res per posar, comença amb un d'aquests tres. Tots són gratuïts i sense clau d'API, i inclouen l'script de càrrega i els valors exactes que cal triar a la pantalla (taula, columnes). L'script està pensat per afegir-hi analitzadors: si vols una altra font, només cal una entrada més.

Abans de començar — Primer cal connectar la BD i crear un compte de només lectura — Guia de Supabase

Obtén els fetchers

Clona el repositori de fetchers al VPS (el servidor on hi ha l'agent). L'única dependència és pg. ★ El DATABASE_URL del .env ha de ser un compte d'escriptura. És normal que un compte de només lectura rebutgi l'INSERT; aquell compte és només per a la integració amb SoriTrading.

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 · Codi obert · una carpeta = un fetcher · registre automàtic al cron

Els tres de sota són **exemples per començar**. Al repositori n'hi ha més: VIX, volatilitat implícita cripto (DVOL), diferencial de tipus, índex del dòlar, capitalització de stablecoins, DeFi TVL… tots gratuïts i sense clau. Executa `node run.mjs list` per veure la llista completa. Les dades de mercat no tenen valor els festius dels EUA (absent, no 0), i DVOL comença el març de 2021.

Com llegir la pantalla de Configuració de dades

Gestió d'agents → tria un agent → pestanya Configuració de dades. Només tu hi afegeixes i esborres conjunts de dades — la IA només els llegeix, i la cadena de connexió no s'enganxa mai al xat. De dalt a baix, la pantalla té aquestes parts.

  1. Connexió a BD externa — Introdueix un nom de connexió (p. ex. main) i la cadena de connexió. Es desa xifrada només al dispositiu de l'agent i no arriba mai al servidor. En obrir la pantalla, l'agent llegeix automàticament la llista de taules ([Comprova la connexió] per tornar-la a llegir).
  2. Taules i conjunts de dades — Una fila per cada taula de la BD: nom de la taula · nombre aproximat de files · comentari de la taula, i a sota els conjunts de dades que llegeixen aquella taula.
  3. Nivell de visibilitat per a la IA (a la dreta de la fila) — Privat (per defecte — la IA ni tan sols sap que la taula existeix) · només nom · fins a columnes · fins a mostra · consulta permesa. Tria'n un i prem [Desa la visibilitat]. Els nivells columnes, mostra i consulta envien dades reals a la IA, així que no obris taules amb informació personal. Només es poden obrir taules de l'esquema public.
  4. Noms dels conjunts de dades (sota la fila de la taula) — És el valor que l'estratègia crida amb ctx.data(nom). [+ Afegeix un conjunt de dades d'aquesta taula] → tria el nom, la columna d'hora i la columna de valor; la descripció s'omple amb el comentari de la taula, i [Desa] només s'activa després de superar [Prova]. Una taula pot tenir diversos noms (quan un filtre separa sèries per exchange o valor, o quan una estratègia antiga fa servir un altre nom). Insígnia d'estat: utilitzable · pendent de comprovar · sense connexió. Prem la insígnia de temps real del costat per desplegar la configuració de despertar (poll · notify · redis) — en la majoria de casos, el valor per defecte ja va bé.
  5. Conjunts de dades calculats (SQL) — Valors que cal calcular, com mitjanes mòbils, valors amb retard o combinacions de diverses taules. Com que l'SQL pot llegir diverses taules, s'agrupen a part i no sota una taula concreta. La majoria de càlculs es poden fer al codi de l'estratègia amb dues crides a ctx.data; fes servir SQL només quan el càlcul necessiti tot l'historial (mitjanes mòbils, rànquings). L'SQL registrat a l'antiga també és aquí: [SQL revisat] · [Esborra], o si té una forma simple es pot convertir en bloc a selecció de taula.
  6. Conjunts de dades sense taula trobada — Quan una taula declarada no és a la llista actual, el conjunt de dades no desapareix: es queda aquí amb el motiu — encara no s'ha rebut la llista de taules (no vol dir que no existeixi) · la BD no té aquesta taula (reanomenada o eliminada) · aquest dispositiu no té aquest nom de connexió.
  7. Hi ha dos àmbits — El nivell de visibilitat per a la IA només es desa al dispositiu que tens obert. Els conjunts de dades s'apliquen a tots els dispositius amb el mateix nom de connexió. Si tens diversos dispositius, tria la visibilitat a cadascun.

1. Índex de por i cobdícia

alternative.me

De 0 (por extrema) a 100 (cobdícia extrema), un cop al dia. Tot l'historial des del febrer de 2018. Un eix de sentiment que el preu sol no mostra — la millor primera prova.

node run.mjs fear-greed
Valors que cal triar a la pantalla de Configuració de dades ([+ Afegeix un conjunt de dades d'aquesta taula] a la fila de la taula)
Connexió: main   ·   Taula: fear_greed
Nom: fg   ·   Columna d'hora: ts   ·   Columna de valor: v
Un cop registrat, només cal que diguis això a la IA
"Amb el meu conjunt de dades fg, fes un backtest a binance BTC 1d d'una estratègia que compri per sota de 20 de por i cobdícia i vengui per sobre de 60"

2. Taxa de hash de Bitcoin

blockchain.com

Una mètrica de la mateixa cadena (TH/s). És un eix diferent del preu, útil com a filtre de règim. Els valors són grans i la tendència suau, així que funciona millor la ràtio respecte a la mitjana mòbil que el valor brut.

node run.mjs btc-hashrate
Valors que cal triar a la pantalla de Configuració de dades ([+ Afegeix un conjunt de dades d'aquesta taula] a la fila de la taula)
Connexió: main   ·   Taula: btc_hashrate
Nom: hashrate   ·   Columna d'hora: ts   ·   Columna de valor: v
Un cop registrat, només cal que diguis això a la IA
"Afegeix a la meva estratègia actual un filtre que només compri quan el conjunt de dades hashrate estigui per sobre de la seva mitjana de 90 dies"

3. Tipus d'interès oficial dels EUA (pràctica)

FRED (DFF)

Tipus efectiu diari dels fons federals — el valor clàssic per filtrar el règim macroeconòmic. ★ Atenció: aquest mateix valor ja arriba com a indicador base base_fedfunds (ctx.data('base_fedfunds') — l'agent el recull de FRED). Si poses el mateix valor per dos camins, el resultat no deixa clar quin s'ha fet servir; utilitza'l només per practicar la integració.

node run.mjs fed-funds
Valors que cal triar a la pantalla de Configuració de dades ([+ Afegeix un conjunt de dades d'aquesta taula] a la fila de la taula)
Connexió: main   ·   Taula: macro_fed_funds
Nom: dff   ·   Columna d'hora: ts   ·   Columna de valor: v
Un cop registrat, només cal que diguis això a la IA
"Mostra la llista dels meus conjunts de dades i comprova si dff es pot utilitzar (només per confirmar la integració)"

Recollida periòdica (cron)

Registra cada fetcher al crontab amb la seva pròpia periodicitat. Si el tornes a executar, les línies no s'acumulen, i no toca els cron que hagis afegit tu. Els registres queden en un fitxer per fetcher a la carpeta logs.

node run.mjs --install-cron
Cal saber
  • Per a la columna d'hora es recomana l'epoch en segons (també es detecten automàticament mil·lisegons i ISO, i el camp tsUnit de l'informe de verificació indica com s'ha llegit).
  • Tornar a executar l'script és segur — no hi ha duplicats i només s'actualitzen els valors més nous (upsert). Per tenir dades noves, torna'l a executar periòdicament.
  • Els resultats de backtest porten una empremta de les dades (nombre de files · hash) — si el contingut de la BD canvia, l'empremta canvia, i dos resultats amb empremtes diferents no tenen les mateixes condicions.
  • Els backtests amb dades externes també s'executen a l'agent — tots els backtests s'executen només a l'agent (el meu magatzem).
  • Les taules a les quals dones un nivell de visibilitat queden exposades a la IA (els nivells columnes, mostra i consulta envien dades reals) — no exposis taules amb informació personal.