← Zpět na dokumentaci
Příklady externích dat

Začněte s bezplatnými veřejnými daty

Připojili jste DB, ale nemáte co do ní dát? Začněte jedním z těchto tří. Vše zdarma, bez API klíče, se skriptem pro nahrání a přesnými hodnotami k výběru na obrazovce (tabulka, sloupce). Skript je postaven na mapě parserů — přidat vlastní zdroj znamená jednu položku navíc.

Než začnete — Nejprve připojte DB a vytvořte účet jen pro čtení — Návod pro Supabase

Získat fetchery

Naklonujte repozitář fetcherů na stroj, kde běží váš agent. Jedinou závislostí je pg. ★ DATABASE_URL v .env musí být účet se zápisem. Účet jen pro čtení má INSERT odmítnout; ten slouží pro integraci se 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 · jedna složka = jeden fetcher · včetně cronu

Tři níže jsou **pro začátek**. Repozitář obsahuje také VIX, implikovanou volatilitu kryptoměn (DVOL), výnosovou křivku, dolarový index, tržní kapitalizaci stablecoinů a DeFi TVL — vše zdarma, bez API klíče. Úplný seznam zobrazí `node run.mjs list`. Tržní řady nemají hodnotu ve dnech amerických svátků (chybí, nejsou nula) a DVOL začíná v březnu 2021.

Jak číst obrazovku nastavení dat

Agenti → vyberte agenta → karta Zdroje dat. Datasety přidáváte a mažete jen vy, na této obrazovce — AI je pouze čte a připojovací řetězce nikdy nepatří do chatu. Odshora dolů má obrazovka tyto části.

  1. Externí DB — Zadejte název připojení (např. main) a připojovací řetězec. Ukládá se šifrovaně jen na stroji agenta a na server se nikdy nedostane. Po otevření obrazovky agent automaticky načte seznam tabulek ([Ověřit připojení] ho načte znovu).
  2. Tabulky a datasety — Jeden řádek na tabulku v DB: název tabulky, přibližný počet řádků, komentář tabulky — a pod ním datasety, které z této tabulky čtou.
  3. Viditelnost pro AI (vpravo na řádku tabulky) — Soukromé (výchozí — AI ani neví, že tabulka existuje) · název · sloupce · vzorek · dotaz. Vyberte a pak [Uložit viditelnost]. Úrovně sloupce, vzorek a dotaz posílají AI skutečná data, proto neotevírejte tabulky s osobními údaji. Otevřít lze jen tabulky ve schématu public.
  4. Názvy datasetů (pod řádkem tabulky) — Hodnoty, které strategie volá přes ctx.data(název). [+ Přidat dataset z této tabulky] → vyberte název, sloupec času a sloupec hodnoty; popis se předvyplní z komentáře tabulky a [Uložit] se odemkne až po úspěšném [Test]. Jedna tabulka může mít více názvů (filtr pro řady jednotlivých burz či symbolů, nebo starší strategie s jiným názvem). Odznak stavu: ok · čeká · nefunkční. Kliknutím na odznak reálného času vedle něj otevřete nastavení probouzení (poll · notify · redis) — pro většinu stačí výchozí.
  5. Vypočtené datasety (SQL) — Hodnoty, které vyžadují výpočet — klouzavé průměry, zpoždění, kombinace více tabulek. SQL může číst více tabulek, proto jsou seskupeny zvlášť, ne pod tabulkou. Většinu výpočtů zvládne kód strategie se dvěma voláními ctx.data; SQL používejte jen tehdy, když výpočet potřebuje celou historii (klouzavé průměry, pořadí). Najdete zde i starší deklarace SQL: [SQL zkontrolováno] · [Smazat], nebo jednoduché hromadně převeďte na výběr tabulky.
  6. Datasety, jejichž tabulka nebyla nalezena — Když deklarovaná tabulka v aktuálním seznamu není, dataset nezmizí — zůstane zde s důvodem: seznam tabulek ještě nepřišel (neznamená to, že chybí) · DB takovou tabulku nemá (přejmenována nebo smazána) · toto zařízení nemá takový název připojení.
  7. Dva rozsahy — Viditelnost pro AI se ukládá jen na zařízení, které máte otevřené. Datasety platí pro všechna zařízení se stejným názvem připojení. Máte-li více zařízení, zvolte viditelnost na každém zvlášť.

1. Index strachu a chamtivosti

alternative.me

0 (extrémní strach) až 100 (extrémní chamtivost), denně, celá historie od února 2018. Osa nálady, kterou samotná cena neukáže — nejlepší první test.

node run.mjs fear-greed
Hodnoty k výběru v nastavení dat ([+ Přidat dataset z této tabulky] na řádku tabulky)
Připojení: main   ·   Tabulka: fear_greed
Název: fg   ·   Sloupec času: ts   ·   Sloupec hodnoty: v
Po registraci stačí AI napsat toto
„S mým datasetem fg proveď backtest binance BTC 1d s nákupem pod 20 a prodejem nad 60“

2. Hash rate bitcoinu

blockchain.com

Ukazatel přímo z řetězce (TH/s) na jiné ose než cena, užitečný jako filtr režimu. Hodnoty jsou velké a mění se pomalu, takže lépe funguje poměr k jejich klouzavému průměru než samotná úroveň.

node run.mjs btc-hashrate
Hodnoty k výběru v nastavení dat ([+ Přidat dataset z této tabulky] na řádku tabulky)
Připojení: main   ·   Tabulka: btc_hashrate
Název: hashrate   ·   Sloupec času: ts   ·   Sloupec hodnoty: v
Po registraci stačí AI napsat toto
„Přidej do mé strategie filtr, který nakupuje jen tehdy, když je dataset hashrate nad svým 90denním průměrem“

3. Sazba federálních fondů USA (cvičení)

FRED (DFF)

Denní efektivní sazba federálních fondů — klasický filtr makro režimu. ★ Pozor: stejná hodnota už přichází jako základní ukazatel base_fedfunds (ctx.data('base_fedfunds') — agent ji sbírá z FRED). Přivádět stejnou hodnotu dvěma cestami dělá výsledky nejednoznačnými v tom, která byla použita, proto to berte jen jako cvičení integrace.

node run.mjs fed-funds
Hodnoty k výběru v nastavení dat ([+ Přidat dataset z této tabulky] na řádku tabulky)
Připojení: main   ·   Tabulka: macro_fed_funds
Název: dff   ·   Sloupec času: ts   ·   Sloupec hodnoty: v
Po registraci stačí AI napsat toto
„Ukaž seznam mých datasetů a ověř, zda je dff použitelný (jen pro ověření integrace)“

Plánovaný sběr (cron)

Každý fetcher se do crontabu zapíše s vlastním plánem. Opakované spuštění blok nahradí místo přidávání řádků a vaše vlastní záznamy zůstanou nedotčené. Logy se ukládají do souboru pro každý fetcher ve složce logs/.

node run.mjs --install-cron
Dobré vědět
  • Pro sloupec času použijte epoch v sekundách (ms a ISO se rozpoznají automaticky a pole tsUnit ve zprávě o ověření uvádí, jak byl přečten).
  • Opakované spuštění skriptu je bezpečné — provádí upsert, takže nevznikají duplikáty a mění se jen novější hodnoty. Pro čerstvá data ho spouštějte pravidelně.
  • Výsledky backtestu nesou otisk dat (počet řádků, hash). Pokud se obsah DB změní, změní se i otisk, a dva výsledky s různými otisky nebyly spuštěny na stejných datech.
  • Backtesty s externími daty také běží v agentovi — každý backtest běží jen v agentovi (mé úložiště svíček).
  • Zpřístupněné tabulky vidí AI (úrovně sloupce, vzorek a dotaz posílají skutečná data) — tabulky s osobními údaji nezpřístupňujte.