← Tillbaka till hjälpen
Exempel på extern data

Börja med öppen testdata

Har du anslutit din databas men inget att lägga i den? Börja med ett av de tre nedan. Alla är gratis och utan API-nyckel, med laddningsskript och exakt vilka värden du väljer på skärmen (tabell, kolumner). Skriptet är byggt kring parsers — en egen källa är bara en post till.

Innan du börjar — Anslut först databasen och skapa ett skrivskyddat konto — Supabase-guide

Hämta fetchers

Klona fetcher-repot till VPS:en (servern där din agent körs). Det enda beroendet är pg. ★ DATABASE_URL i .env ska vara ett konto med skrivrätt. Att ett skrivskyddat konto nekar INSERT är normalt — det kontot är bara till för SoriTrading-kopplingen.

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 · Öppen källkod · en mapp = en fetcher · cron läggs in automatiskt

De tre nedan är **startexempel**. Repot innehåller även VIX, implicit kryptovolatilitet (DVOL), räntekurvan, dollarindexet, stablecoins marknadsvärde, DeFi TVL med mera — allt gratis och utan nyckel. Kör `node run.mjs list` för hela listan. Marknadsdata saknar värde på amerikanska helgdagar (saknas, inte 0), och DVOL börjar i mars 2021.

Så läser du skärmen Datainställningar

Agenthantering → välj agent → fliken Datainställningar. Bara du lägger till och tar bort, på den här skärmen — AI:n läser bara dataset, och anslutningssträngar klistras aldrig in i chatten. Uppifrån och ned ser skärmen ut så här.

  1. Extern databaskoppling — Ange ett anslutningsnamn (t.ex. main) och anslutningssträngen. Den sparas krypterad endast på agentenheten och går inte till servern. När skärmen öppnas läser agenten in tabellistan automatiskt ([Kontrollera anslutning] om du vill läsa in igen).
  2. Tabeller och dataset — En rad per tabell i databasen: tabellnamn · ungefärligt antal rader · tabellkommentar, och under den de dataset som läser tabellen.
  3. AI-synlighet (till höger på tabellraden) — Privat (standard — AI:n vet inte ens att tabellen finns) · bara namn · med kolumner · med urval · frågor tillåtna. Välj och klicka på [Spara synlighet]. På nivåerna kolumner, urval och fråga skickas riktig data till AI:n, så öppna inte tabeller med personuppgifter. Bara tabeller i schemat public kan öppnas.
  4. Datasetnamn (under tabellraden) — Värdet som en strategi anropar med ctx.data(namn). [+ Lägg till dataset från den här tabellen] → välj namn, tidskolumn och värdekolumn; beskrivningen fylls i från tabellkommentaren, och [Spara] låses upp först när [Test] har gått igenom. En tabell kan ha flera namn (när ett filter delar upp serier per börs eller symbol, eller när en äldre strategi använder ett annat namn). Statusmärke: användbar · ej kontrollerad · ej ansluten. Klicka på realtidsmärket bredvid för väckningsinställningar (poll · notify · redis) — för det mesta räcker standardvärdet.
  5. Beräknade dataset (SQL) — Värden som kräver en beräkning — glidande medelvärden, fördröjda värden, kombinationer av flera tabeller. SQL kan läsa flera tabeller, så de samlas separat och inte under en viss tabell. De flesta beräkningar går att göra i strategikoden med två ctx.data-anrop; använd SQL bara när beräkningen behöver hela historiken (glidande medelvärden, rangordningar). SQL som registrerats på det gamla sättet kan du här [SQL kontrollerad] · [Ta bort], eller konvertera enkla fall till tabellval i ett svep.
  6. Dataset vars tabell inte hittades — När en angiven tabell inte finns i den aktuella listan försvinner datasetet inte, utan stannar här med orsaken: tabellistan har inte tagits emot än (betyder inte att den saknas) · databasen har ingen sådan tabell (omdöpt eller borttagen) · den här enheten har inte det anslutningsnamnet.
  7. Det finns två omfång — AI-synligheten sparas bara på den enhet som är öppen just nu. Dataset gäller alla enheter med samma anslutningsnamn. Har du flera enheter väljer du synlighet på var och en.

1. Fear & Greed-index

alternative.me

0 (extrem rädsla) till 100 (extrem girighet), en gång per dag. Hela perioden sedan februari 2018. En sentimentaxel som priset ensamt inte visar — det bästa första testet.

node run.mjs fear-greed
Värden att välja i Datainställningar ([+ Lägg till dataset från den här tabellen] på tabellraden)
Anslutning: main   ·   Tabell: fear_greed
Namn: fg   ·   Tidskolumn: ts   ·   Värdekolumn: v
Efter registreringen kan du säga så här till AI:n
"Backtesta med mitt dataset fg en strategi på binance BTC 1d som köper under rädsla/girighet 20 och säljer över 60"

2. Bitcoins hashrate

blockchain.com

Ett mått från själva kedjan (TH/s). En annan axel än priset och därför användbar som regimfilter. Värdena är stora och trenden flack, så kvoten mot det glidande medelvärdet fungerar bättre än råvärdet.

node run.mjs btc-hashrate
Värden att välja i Datainställningar ([+ Lägg till dataset från den här tabellen] på tabellraden)
Anslutning: main   ·   Tabell: btc_hashrate
Namn: hashrate   ·   Tidskolumn: ts   ·   Värdekolumn: v
Efter registreringen kan du säga så här till AI:n
"Lägg till ett filter i min befintliga strategi som bara köper när datasetet hashrate ligger över sitt 90-dagarsgenomsnitt"

3. USA:s styrränta (övning)

FRED (DFF)

Daglig effektiv federal funds rate — det klassiska filtret för makroregim. ★ Obs: samma värde kommer redan in som basindikatorn base_fedfunds (ctx.data('base_fedfunds') — samlas in av din agent från FRED). Om samma värde matas in via två vägar går det inte att se i resultatet vilken som användes, så använd detta bara för att öva på kopplingen.

node run.mjs fed-funds
Värden att välja i Datainställningar ([+ Lägg till dataset från den här tabellen] på tabellraden)
Anslutning: main   ·   Tabell: macro_fed_funds
Namn: dff   ·   Tidskolumn: ts   ·   Värdekolumn: v
Efter registreringen kan du säga så här till AI:n
"Visa min datasetlista och kontrollera om dff är användbart (bara för att kontrollera kopplingen)"

Periodisk insamling (cron)

Lägger in varje fetcher i crontab med dess eget angivna intervall. Kör du igen staplas inga rader, och cron-rader du själv lagt in lämnas orörda. Loggar hamnar i en loggfil per fetcher i mappen logs.

node run.mjs --install-cron
Bra att veta
  • För tidskolumnen rekommenderas epoch i sekunder (millisekunder och ISO känns igen automatiskt, och hur den lästes framgår av fältet tsUnit i verifieringsrapporten).
  • Det är säkert att köra skriptet igen — det uppdaterar bara de senaste värdena utan dubbletter (upsert). Kör det igen regelbundet för ny data.
  • Backtestresultat har ett datafingeravtryck (antal rader, hash). Ändras innehållet i databasen ändras fingeravtrycket, och två resultat med olika fingeravtryck kördes inte under samma villkor.
  • Även backtester med extern data körs på agenten — alla backtester körs enbart på agenten (din egen lagring).
  • Tabeller med en synlighetsnivå blir synliga för AI:n (på nivåerna kolumner, urval och fråga skickas riktig data ut) — gör inte tabeller med personuppgifter synliga.