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.
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.
- 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).
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.me0 (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
Konexioa: main · Taula: fear_greed Izena: fg · Ordu-zutabea: ts · Balio-zutabea: v
2. Bitcoinen hash-tasa
blockchain.comKatearen 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
Konexioa: main · Taula: btc_hashrate Izena: hashrate · Ordu-zutabea: ts · Balio-zutabea: v
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
Konexioa: main · Taula: macro_fed_funds Izena: dff · Ordu-zutabea: ts · Balio-zutabea: v
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
- 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.
Dokumentazio osoa hemen — Gida