← Nazaj na dokumentacijo
Primeri zunanjih podatkov

Začnite z brezplačnimi javnimi nabori podatkov

Ste povezali bazo, a nimate česa vanjo dati? Začnite z enim od teh treh. Vsi so brezplačni, brez API ključa, s skripto za nalaganje in točnimi vrednostmi, ki jih izberete na zaslonu (tabela, stolpci). Skripta je zgrajena okoli preslikave razčlenjevalnikov — dodajanje lastnega vira je le še en vnos.

Preden začnete — Najprej povežite bazo podatkov in ustvarite račun samo za branje — vodnik za Supabase

Prenesite zbiralnike

Repozitorij zbiralnikov klonirajte na napravo, na kateri teče vaš agent. Edina odvisnost je pg. ★ DATABASE_URL v .env mora biti račun s pravico pisanja. Račun samo za branje mora INSERT zavrniti; ta je namenjen integraciji s 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 · Odprta koda · ena mapa na zbiralnik · cron vključen

Spodnji trije so **začetni primeri**. Repozitorij vsebuje še VIX, implicitno volatilnost kriptovalut (DVOL), krivuljo donosnosti, dolarski indeks, tržno kapitalizacijo stabilnih kovancev in DeFi TVL — vse brezplačno, brez API ključa. Za celoten seznam zaženite `node run.mjs list`. Tržne serije ob ameriških praznikih nimajo vrednosti (manjka, ni nič), DVOL pa se začne marca 2021.

Branje zaslona nastavitev podatkov

Agenti → izberite agenta → zavihek Viri podatkov. Nabore podatkov dodajate ali brišete le vi, na tem zaslonu — AI jih le bere, povezovalni nizi pa nikoli ne gredo v klepet. Zaslon ima od zgoraj navzdol te dele.

  1. Zunanja baza podatkov — Vnesite ime povezave (npr. main) in povezovalni niz. Šifrirano je shranjen le na napravi agenta in nikoli ne doseže strežnika. Ko se zaslon odpre, agent samodejno prebere seznam tabel ([Preveri povezavo] ga prebere znova).
  2. Tabele in nabori podatkov — Ena vrstica na tabelo v bazi: ime tabele, približno število vrstic, komentar tabele — in pod njo nabori podatkov, ki to tabelo berejo.
  3. Vidnost za AI (desna stran vrstice tabele) — Zasebno (privzeto — AI sploh ne ve, da tabela obstaja) · ime · stolpci · vzorec · poizvedba. Izberite, nato [Shrani vidnost]. Ravni stolpcev, vzorca in poizvedbe pošiljajo AI prave podatke, zato ne odpirajte tabel z osebnimi podatki. Odpreti je mogoče le tabele v shemi public.
  4. Imena naborov podatkov (pod vrstico tabele) — Vrednosti, ki jih strategija kliče s ctx.data(ime). [+ Dodaj nabor podatkov iz te tabele] → izberite ime, časovni stolpec in stolpec vrednosti; opis se vnaprej izpolni iz komentarja tabele, [Shrani] pa se odklene šele, ko [Test] uspe. Ena tabela ima lahko več imen (filter po seriji borze ali instrumenta ali starejša strategija, ki uporablja drugo ime). Značka stanja: v redu · čaka · pokvarjeno. Kliknite značko za realni čas zraven za nastavitve prebujanja (poll · notify · redis) — za večino zadošča privzeto.
  5. Izračunani nabori podatkov (SQL) — Vrednosti, ki zahtevajo izračun — drseča povprečja, zamiki, kombinacija več tabel. SQL lahko bere več tabel, zato so ti zbrani ločeno, ne pod tabelo. Večino izračunov je mogoče opraviti v kodi strategije z dvema klicema ctx.data; SQL uporabite le, ko izračun potrebuje celotno zgodovino (drseča povprečja, razvrstitve). Tu so tudi starejše deklaracije SQL: [SQL pregledan] · [Izbriši] ali preproste množično pretvorite v izbiro tabele.
  6. Nabori podatkov, katerih tabele ni bilo mogoče najti — Ko deklarirane tabele ni na trenutnem seznamu, nabor podatkov ne izgine — ostane tukaj z razlogom: seznam tabel še ni prejet (ne pomeni, da manjka) · baza nima take tabele (preimenovana ali izbrisana) · ta naprava nima takega imena povezave.
  7. Dva obsega — Vidnost za AI je shranjena le na napravi, ki jo imate odprto. Nabori podatkov veljajo za vse naprave z istim imenom povezave. Pri več napravah izberite vidnost na vsaki posebej.

1. Indeks strahu in pohlepa

alternative.me

Od 0 (skrajni strah) do 100 (skrajni pohlep), dnevno, celotna zgodovina od februarja 2018. Os razpoloženja, ki je cena sama ne pokaže — najboljši prvi preizkus.

node run.mjs fear-greed
Vrednosti, ki jih izberete v nastavitvah podatkov ([+ Dodaj nabor podatkov iz te tabele] v vrstici tabele)
Povezava: main   ·   Tabela: fear_greed
Ime: fg   ·   Časovni stolpec: ts   ·   Stolpec vrednosti: v
Po registraciji AI recite tole
»Z mojim naborom podatkov fg izvedi povratni test binance BTC 1d, ki kupuje pod 20 in prodaja nad 60«

2. Hitrost razpršitve (hash rate) bitcoina

blockchain.com

Kazalnik same verige (TH/s) na drugi osi kot cena, uporaben kot filter režima. Vrednosti so velike in se spreminjajo počasi, zato je razmerje do drsečega povprečja boljše od surove ravni.

node run.mjs btc-hashrate
Vrednosti, ki jih izberete v nastavitvah podatkov ([+ Dodaj nabor podatkov iz te tabele] v vrstici tabele)
Povezava: main   ·   Tabela: btc_hashrate
Ime: hashrate   ·   Časovni stolpec: ts   ·   Stolpec vrednosti: v
Po registraciji AI recite tole
»Moji strategiji dodaj filter, ki kupuje le, ko je nabor podatkov hashrate nad svojim 90-dnevnim povprečjem«

3. Obrestna mera zveznih skladov ZDA (vaja)

FRED (DFF)

Dnevna efektivna obrestna mera zveznih skladov — klasičen filter makro režima. ★ Opomba: ista vrednost že prihaja kot osnovni kazalnik base_fedfunds (ctx.data('base_fedfunds') — agent jo zbira iz FRED). Če isto vrednost vnašate po dveh poteh, iz rezultatov ni jasno, katera je bila uporabljena, zato to uporabljajte le za vajo integracije.

node run.mjs fed-funds
Vrednosti, ki jih izberete v nastavitvah podatkov ([+ Dodaj nabor podatkov iz te tabele] v vrstici tabele)
Povezava: main   ·   Tabela: macro_fed_funds
Ime: dff   ·   Časovni stolpec: ts   ·   Stolpec vrednosti: v
Po registraciji AI recite tole
»Pokaži seznam mojih naborov podatkov in preveri, ali je dff uporaben (le za potrditev, da integracija deluje)«

Načrtovano zbiranje (cron)

Za vsak zbiralnik v crontab namesti njegov urnik. Ponovni zagon zamenja blok, namesto da bi dodajal vrstice, vaši lastni vnosi pa ostanejo nedotaknjeni. Dnevniki se zapisujejo v datoteko za vsak zbiralnik v mapi logs/.

node run.mjs --install-cron
Dobro je vedeti
  • Za časovni stolpec uporabite epoch v sekundah (ms in ISO se zaznata samodejno, polje tsUnit v poročilu o preverjanju pa pove, kako je bil prebran).
  • Ponovni zagon skripte je varen — izvede upsert, zato ni podvojitev in spremenijo se le novejše vrednosti. Za sveže podatke jo občasno zaženite znova.
  • Rezultati povratnih testov nosijo prstni odtis podatkov (število vrstic, zgoščena vrednost). Če se vsebina baze spremeni, se spremeni tudi prstni odtis, dva rezultata z različnima prstnima odtisoma pa nista bila izvedena na istih podatkih.
  • Tudi povratni testi z zunanjimi podatki tečejo v agentu — vsak povratni test teče le v agentu (moja shramba sveč).
  • Tabele, ki jih razkrijete, postanejo vidne AI (ravni stolpcev, vzorca in poizvedbe pošiljajo prave podatke) — ne razkrivajte tabel z osebnimi podatki.