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.
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.
- 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).
- 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.
- 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.
- 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é.
- 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.
- 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ó.
- 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.meDe 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
Connexió: main · Taula: fear_greed Nom: fg · Columna d'hora: ts · Columna de valor: v
2. Taxa de hash de Bitcoin
blockchain.comUna 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
Connexió: main · Taula: btc_hashrate Nom: hashrate · Columna d'hora: ts · Columna de valor: v
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
Connexió: main · Taula: macro_fed_funds Nom: dff · Columna d'hora: ts · Columna de valor: v
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
- 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.
Tota la documentació és aquí — Guia d'ús