← Înapoi la ghidul de utilizare
Exemple de date externe

Începeți cu date publice de test

Dacă ați integrat propria DB dar nu aveți date de pus, începeți cu una dintre cele trei de mai jos. Toate sunt gratuite, fără cheie API, și puteți urma exact scriptul de încărcare și valorile de ales în ecran (tabel · coloane). Scriptul este construit prin adăugare de parsere, deci pentru o sursă dorită scrieți doar încă un element.

Înainte de a începe — Mai întâi sunt necesare conexiunea DB și un cont doar pentru citire — Ghid de integrare Supabase

Obțineți colectorul

Clonați depozitul de fetchere pe VPS (serverul cu agentul). Singura dependență este pg. ★ DATABASE_URL din .env trebuie să fie un cont cu drept de scriere. Este normal ca un cont doar pentru citire să primească refuz la INSERT; acel cont este doar pentru integrarea 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 · Open source · un dosar = un fetcher · înregistrare automată cron

Cele trei de mai jos sunt **exemple de început**. Depozitul conține mai multe: VIX, volatilitatea implicită crypto (DVOL), diferența de dobânzi pe termen lung/scurt, indicele dolarului, capitalizarea stablecoin-urilor, DeFi TVL etc., toate gratuite și fără cheie — lista completă cu `node run.mjs list`. Datele de piață nu au valori în zilele nelucrătoare din SUA (nu 0, ci lipsă), iar DVOL începe din martie 2021.

Cum se citește ecranul de setări de date

Gestionare agent → alegeți agentul → fila Setări de date. Înregistrarea și ștergerea le faceți doar dumneavoastră, în acest ecran — AI-ul doar citește seturile de date, iar șirul de conexiune nu se lipește niciodată în chat. Ecranul are, de sus în jos, această ordine.

  1. Integrare DB externă — Introduceți numele conexiunii (ex.: main) și șirul de conexiune. Se stochează criptat doar pe dispozitivul agentului și nu ajunge la server. La deschiderea ecranului, agentul citește automat lista de tabele ([Verifică conexiunea] când doriți să recitiți).
  2. Tabele și seturi de date — Câte un rând pentru fiecare tabel din DB. Numele tabelului · numărul aproximativ de rânduri · comentariul tabelului, iar dedesubt seturile de date care citesc acel tabel.
  3. Nivelul de publicare pentru AI (dreapta rândului tabelului) — Privat (implicit — AI-ul nici nu știe că tabelul există) · doar nume · până la coloane · până la eșantion · interogare permisă. După alegere, [Salvează setările de publicare]. La nivelurile coloane · eșantion · interogare ies date reale către AI, deci nu deschideți tabele cu date personale. Se pot deschide doar tabelele din schema public.
  4. Numele seturilor de date (sub rândul tabelului) — Este valoarea pe care strategia o apelează cu ctx.data(nume). [+ Adaugă set de date din acest tabel] → alegeți numele, coloana de timp și coloana de valori; descrierea se completează din comentariul tabelului, iar [Salvează] se activează doar după ce trece [Test]. Unui tabel i se pot da mai multe nume (când separați serii pe burse sau instrumente prin filtru sau când o strategie veche folosește alt nume). Insigne de stare: disponibil · neverificat · neconectat. Apăsând insigna de timp real de lângă, se deschid setările de trezire (poll · notify · redis) — de cele mai multe ori valorile implicite sunt suficiente.
  5. Seturi de date calculate (SQL) — Valori care necesită calcul, precum medii mobile, valori întârziate sau combinații de mai multe tabele. SQL-ul poate citi mai multe tabele, deci nu stă sub un anumit tabel, ci este grupat separat. Majoritatea calculelor se pot face și în codul strategiei cu două ctx.data, așa că folosiți SQL doar pentru calcule care necesită tot intervalul istoric (medii mobile · ranguri). SQL-urile înregistrate prin metoda anterioară pot fi [SQL verificat] · [Șterge] aici sau, dacă au formă simplă, convertite în bloc la metoda de alegere a tabelului.
  6. Seturi de date al căror tabel nu a fost găsit — Când tabelul declarat nu este acum în listă, nu dispare, ci rămâne aici cu motivul — lista de tabele nu a fost încă primită (nu înseamnă că lipsește) · acea DB nu are tabelul (redenumit · șters) · acest dispozitiv nu are acel nume de conexiune.
  7. Există două domenii — Nivelul de publicare pentru AI se salvează doar pe dispozitivul deschis acum. Seturile de date se aplică tuturor dispozitivelor cu același nume de conexiune. Dacă aveți mai multe dispozitive, nivelul de publicare se alege separat pentru fiecare.

1. Indicele frică-lăcomie

alternative.me

0 (frică extremă) ~ 100 (lăcomie extremă), o dată pe zi. Toată perioada din 2018-02. Este o axă psihologică invizibilă doar din preț, deci cel mai bun prim test.

node run.mjs fear-greed
Valori de ales în ecranul de setări de date ([+ Adaugă set de date din acest tabel] de pe rândul tabelului)
Conexiune: main   ·   Tabel: fear_greed
Nume: fg   ·   Coloana de timp: ts   ·   Coloana de valori: v
După înregistrare, spuneți-i AI-ului așa
„Fă backtest pe binance BTC 1d cu setul meu de date fg, cu o strategie care cumpără când frică-lăcomie este sub 20 și vinde peste 60”

2. Hashrate Bitcoin

blockchain.com

Indicator al lanțului însuși (TH/s). Este o axă diferită de preț, deci util ca filtru de regim. Valorile sunt mari și tendința lentă, așa că este mai bine să folosiți raportul față de media mobilă decât valoarea brută.

node run.mjs btc-hashrate
Valori de ales în ecranul de setări de date ([+ Adaugă set de date din acest tabel] de pe rândul tabelului)
Conexiune: main   ·   Tabel: btc_hashrate
Nume: hashrate   ·   Coloana de timp: ts   ·   Coloana de valori: v
După înregistrare, spuneți-i AI-ului așa
„Adaugă la strategia existentă un filtru care cumpără doar când setul de date hashrate este peste media pe 90 de zile”

3. Rata de bază SUA (pentru exersare)

FRED (DFF)

Rata efectivă zilnică a fondurilor federale. Valoarea reprezentativă pentru filtrele de regim macro. ★ Atenție: aceeași valoare vine deja ca indicator de bază base_fedfunds (ctx.data('base_fedfunds') — colectat de agent din FRED). Dacă aceeași valoare intră pe două căi, în rezultat nu se poate distinge care a fost folosită, deci folosiți-o doar pentru exersarea integrării.

node run.mjs fed-funds
Valori de ales în ecranul de setări de date ([+ Adaugă set de date din acest tabel] de pe rândul tabelului)
Conexiune: main   ·   Tabel: macro_fed_funds
Nume: dff   ·   Coloana de timp: ts   ·   Coloana de valori: v
După înregistrare, spuneți-i AI-ului așa
„Arată-mi lista seturilor de date și verifică dacă dff este disponibil (pentru verificarea integrării)”

Colectare periodică (cron)

Fiecare fetcher se înregistrează în crontab cu frecvența declarată. Rularea repetată nu adaugă linii, iar cron-urile adăugate manual nu sunt atinse. Jurnalele rămân în fișierele de jurnal per fetcher din dosarul logs.

node run.mjs --install-cron
De reținut
  • Pentru coloana de timp se recomandă epoch în secunde (milisecundele și ISO sunt recunoscute automat, iar modul de citire rămâne în tsUnit din raportul de verificare).
  • Scriptul poate fi rulat din nou în siguranță — se actualizează doar valorile cele mai noi, fără duplicate (upsert). Pentru date noi, rulați-l periodic.
  • Rezultatele backtestului păstrează amprenta datelor (număr de rânduri · hash) — dacă conținutul DB se schimbă, amprenta diferă, iar două rezultate cu amprente diferite nu au aceleași condiții.
  • Și backtesturile cu date externe rulează în agent — toate backtesturile rulează doar în agent (stocarea mea).
  • Tabelele cu nivel de publicare sunt expuse AI-ului (la nivelurile coloane · eșantion · interogare ies date reale) — nu publicați tabele cu date personale.