← Itzuli erabilera-gidara
Kanpoko datuen adibideak

Hasi probarako datu publiko doakoekin

Zure DBa konektatu baduzu baina ez baduzu zer sartu, hasi hiru hauetako batekin. Denak doakoak dira eta API gakorik gabe, kargatzeko script-a eta pantailan aukeratu beharreko balio zehatzak (taula, zutabeak) barne. Script-a analizatzaileak gehitzeko egituratuta dago: beste iturri bat nahi baduzu, sarrera bat gehiago besterik ez.

Hasi aurretik — Lehenik DBa konektatu eta irakurtzeko soilik den kontu bat sortu behar da — Supabase gida

Lortu fetcher-ak

Klonatu fetcher-en biltegia VPSan (agentea dagoen zerbitzarian). Mendekotasun bakarra pg da. ★ .env-eko DATABASE_URL idazteko kontu bat izan behar da. Normala da irakurtzeko soilik den kontuak INSERT-a baztertzea; kontu hori SoriTrading-en integraziorako soilik da.

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 · Kode irekia · karpeta bat = fetcher bat · cron-ean automatikoki erregistratua

Beheko hirurak **hasteko adibideak** dira. Biltegian gehiago daude: VIX, kriptoen hegazkortasun inplizitua (DVOL), epe luze-laburreko interes-aldea, dolarraren indizea, stablecoinen kapitalizazioa, DeFi TVL… denak doakoak eta gakorik gabe. Exekutatu `node run.mjs list` zerrenda osoa ikusteko. Merkatu-datuek ez dute baliorik AEBko jaiegunetan (ez dago, ez da 0), eta DVOL 2021eko martxoan hasten da.

Nola irakurri Datu-ezarpenen pantaila

Agenteen kudeaketa → aukeratu agentea → Datu-ezarpenak fitxa. Zuk bakarrik gehitzen eta ezabatzen dituzu datu-multzoak pantaila honetan — AAk irakurri besterik ez ditu egiten, eta konexio-katea ez da inoiz txatean itsasten. Goitik behera, pantailak atal hauek ditu.

  1. Kanpoko DBaren konexioa — Sartu konexio-izen bat (adib. main) eta konexio-katea. Agentearen gailuan soilik gordetzen da enkriptatuta, eta ez da inoiz zerbitzarira iristen. Pantaila irekitzean, agenteak automatikoki irakurtzen du taulen zerrenda ([Egiaztatu konexioa] berriro irakurtzeko).
  2. Taulak eta datu-multzoak — Lerro bat DBko taula bakoitzeko: taularen izena · gutxi gorabeherako errenkada kopurua · taularen iruzkina, eta azpian taula hori irakurtzen duten datu-multzoak.
  3. AArentzako ikusgarritasun-maila (taularen lerroaren eskuinean) — Pribatua (lehenetsia — AAk ez daki taula badagoenik ere) · izena soilik · zutabeak arte · lagina arte · kontsulta baimenduta. Aukeratu eta sakatu [Gorde ikusgarritasuna]. Zutabeak, lagina eta kontsulta mailek benetako datuak bidaltzen dizkiote AAri, beraz ez ireki informazio pertsonala duten taulak. public eskemako taulak soilik ireki daitezke.
  4. Datu-multzoen izenak (taularen lerroaren azpian) — Estrategiak ctx.data(izena) bidez deitzen duen balioa da. [+ Gehitu datu-multzoa taula honetatik] → aukeratu izena, ordu-zutabea eta balio-zutabea; deskribapena taularen iruzkinarekin betetzen da, eta [Gorde] [Probatu] gainditu ondoren soilik gaitzen da. Taula batek hainbat izen izan ditzake (iragazki batek serieak exchange-ka edo sinboloka bereizten dituenean, edo estrategia zahar batek beste izen bat erabiltzen duenean). Egoera-ikurra: erabilgarri · egiaztatu gabe · konexiorik gabe. Ondoko denbora errealeko ikurra sakatuz esnatze-ezarpenak (poll · notify · redis) zabaltzen dira — gehienetan balio lehenetsia nahikoa da.
  5. Datu-multzo kalkulatuak (SQL) — Kalkulua behar duten balioak: batez besteko higikorrak, atzeratutako balioak, hainbat taularen konbinazioak. SQLak hainbat taula irakur ditzakeenez, bereiz biltzen dira, ez taula jakin baten azpian. Kalkulu gehienak estrategiaren kodean egin daitezke bi ctx.data deirekin; erabili SQL kalkuluak historia osoa behar duenean soilik (batez besteko higikorrak, sailkapenak). Lehengo eran erregistratutako SQLa ere hemen dago: [SQLa berrikusita] · [Ezabatu], edo forma sinplea badu, taula-hautapenera bihur daiteke multzoka.
  6. Taula aurkitu ez zaien datu-multzoak — Adierazitako taula uneko zerrendan ez dagoenean, datu-multzoa ez da desagertzen: hemen geratzen da arrazoiarekin — taulen zerrenda oraindik ez da jaso (ez du esan nahi ez dagoenik) · DBak ez du taula hori (izenez aldatua edo ezabatua) · gailu honek ez du konexio-izen hori.
  7. Bi esparru daude — AArentzako ikusgarritasun-maila irekita duzun gailuan soilik gordetzen da. Datu-multzoak konexio-izen bera duten gailu guztiei aplikatzen zaizkie. Gailu bat baino gehiago badituzu, aukeratu ikusgarritasuna bakoitzean.

1. Beldurraren eta gutiziaren indizea

alternative.me

0 (beldur muturrekoa) eta 100 (gutizia muturrekoa) bitartean, egunean behin. Historia osoa 2018ko otsailetik. Prezioak bakarrik erakusten ez duen sentimendu-ardatza — lehen probarako onena.

node run.mjs fear-greed
Datu-ezarpenen pantailan aukeratu beharreko balioak (taularen lerroko [+ Gehitu datu-multzoa taula honetatik])
Konexioa: main   ·   Taula: fear_greed
Izena: fg   ·   Ordu-zutabea: ts   ·   Balio-zutabea: v
Erregistratu ondoren, esan hau AAri
"Nire fg datu-multzoarekin, egin binance BTC 1d-n backtest-a beldurra eta gutizia 20tik behera dagoenean erosi eta 60tik gora dagoenean saltzen duen estrategia batekin"

2. Bitcoinen hash-tasa

blockchain.com

Katearen beraren metrika (TH/s). Prezioaren beste ardatz bat da, eta erregimen-iragazki gisa erabil daiteke. Balioak handiak dira eta joera leuna, beraz batez besteko higikorrarekiko ratioa hobea da balio gordina baino.

node run.mjs btc-hashrate
Datu-ezarpenen pantailan aukeratu beharreko balioak (taularen lerroko [+ Gehitu datu-multzoa taula honetatik])
Konexioa: main   ·   Taula: btc_hashrate
Izena: hashrate   ·   Ordu-zutabea: ts   ·   Balio-zutabea: v
Erregistratu ondoren, esan hau AAri
"Gehitu nire estrategiari hashrate datu-multzoa bere 90 eguneko batez bestekoaren gainetik dagoenean soilik erosten duen iragazki bat"

3. AEBko interes-tasa ofiziala (praktikarako)

FRED (DFF)

Funts federalen eguneko tasa efektiboa — makro-erregimen iragazkien balio klasikoa. ★ Kontuz: balio bera oinarrizko adierazle gisa iristen da dagoeneko, base_fedfunds (ctx.data('base_fedfunds') — agenteak FREDetik biltzen du). Balio bera bi bidetatik sartzen baduzu, emaitzan ezin da jakin zein erabili den; erabili hau integrazioa praktikatzeko soilik.

node run.mjs fed-funds
Datu-ezarpenen pantailan aukeratu beharreko balioak (taularen lerroko [+ Gehitu datu-multzoa taula honetatik])
Konexioa: main   ·   Taula: macro_fed_funds
Izena: dff   ·   Ordu-zutabea: ts   ·   Balio-zutabea: v
Erregistratu ondoren, esan hau AAri
"Erakutsi nire datu-multzoen zerrenda eta egiaztatu dff erabilgarri dagoen (integrazioa egiaztatzeko soilik)"

Aldizkako bilketa (cron)

Fetcher bakoitza bere aldizkakotasunarekin erregistratzen du crontab-ean. Berriro exekutatuta ere lerroak ez dira pilatzen, eta zuk zeuk jarritako cron-ak ez ditu ukitzen. Erregistroak logs karpetako fetcher bakoitzaren fitxategian geratzen dira.

node run.mjs --install-cron
Jakin beharrekoak
  • Ordu-zutaberako epoch segundoak gomendatzen dira (milisegundoak eta ISO ere automatikoki ezagutzen dira, eta egiaztapen-txostenaren tsUnit eremuak dio nola irakurri den).
  • Script-a berriro exekutatzea segurua da — ez dago bikoiztasunik eta balio berrienak soilik eguneratzen dira (upsert). Datu berriak izateko, exekutatu aldian-aldian.
  • Backtest-emaitzek datuen hatz-marka daramate (errenkada kopurua · hash-a) — DBko edukia aldatzen bada, hatz-marka aldatzen da, eta hatz-marka desberdineko bi emaitza ez daude baldintza berberetan.
  • Kanpoko datuak erabiltzen dituzten backtest-ak ere agentean exekutatzen dira — backtest guztiak agentean (nire biltegian) soilik exekutatzen dira.
  • Ikusgarritasun-maila eman diezun taulak AAren eskura geratzen dira (zutabeak, lagina eta kontsulta mailek benetako datuak bidaltzen dituzte) — ez erakutsi informazio pertsonala duten taulak.