← Takaisin käyttöohjeisiin
Ulkoisen datan esimerkit

Aloita julkisilla testidatajoukoilla

Jos olet yhdistänyt oman tietokantasi, mutta sinulla ei ole siihen dataa, aloita jollakin alla olevista kolmesta. Kaikki ovat ilmaisia ja saatavilla ilman API-avainta, ja voit seurata sellaisenaan latausskriptiä ja näytöllä valittavia arvoja (taulu, sarakkeet). Skripti perustuu jäsentimien lisäämiseen, joten oman lähteen lisääminen vaatii vain yhden uuden kohdan.

Ennen aloitusta — Ensin tarvitaan tietokantayhteys ja vain luku -tili — Supabase-integraatio-opas

Hae keräimet

Kloonaa hakijarepo VPS:lle (palvelimelle, jossa agentti on). Ainoa riippuvuus on pg. ★ .env-tiedoston DATABASE_URL:ssa käytä kirjoitustiliä. Vain luku -tilin kuuluukin hylätä INSERT, ja se tili on vain SoriTrading-integraatiota varten.

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 · Avoin lähdekoodi · yksi kansio = yksi hakija · cron rekisteröidään automaattisesti

Alla olevat kolme ovat **aloitusesimerkkejä**. Repossa on lisäksi VIX, kryptojen implisiittinen volatiliteetti (DVOL), korkokäyrän ero, dollari-indeksi, stablecoinien markkina-arvo, DeFi TVL ym. — kaikki ilmaisia, avainta ei tarvita. Koko luettelon näet komennolla `node run.mjs list`. Markkinadatalla ei ole arvoa Yhdysvaltain pyhäpäivinä (puuttuu, ei nolla), ja DVOL alkaa maaliskuusta 2021.

Näin luet data-asetusten näkymää

Agenttien hallinta → valitse agentti → Data-asetukset-välilehti. Lisäykset ja poistot teet vain sinä tässä näkymässä — AI vain lukee datajoukkoja, eikä yhteysmerkkijonoa koskaan liitetä chattiin. Näkymässä on ylhäältä alas seuraavat osat.

  1. Ulkoisen tietokannan yhteys — Syötä yhteyden nimi (esim. main) ja yhteysmerkkijono. Ne tallennetaan salattuina vain agenttilaitteelle eivätkä mene palvelimelle. Kun avaat näkymän, agentti lukee taululuettelon automaattisesti ([Tarkista yhteys] lukee sen uudelleen).
  2. Taulut ja datajoukot — Yksi rivi tietokannan jokaista taulua kohden: taulun nimi · likimääräinen rivimäärä · taulun kommentti, ja niiden alla taulua lukevat datajoukot.
  3. AI-julkisuustaso (taulurivin oikealla puolella) — Yksityinen (oletus — AI ei edes tiedä taulun olemassaolosta) · vain nimi · sarakkeet · otos · kyselyt sallittu. Valitse ja paina [Tallenna julkisuusasetus]. Sarake-, otos- ja kyselytasoilla oikeaa dataa lähtee AI:lle, joten älä avaa henkilötietoja sisältäviä tauluja. Vain public-skeeman tauluja voi avata.
  4. Datajoukkojen nimet (taulurivin alla) — Arvot, joita strategia kutsuu ctx.data(nimi) -muodossa. [+ Lisää datajoukko tästä taulusta] → kun valitset nimen, aikasarakkeen ja arvosarakkeen, kuvaus täytetään taulun kommentista, ja [Tallenna] avautuu vasta, kun [Testaa] on läpäisty. Yhdelle taululle voi antaa useita nimiä (kun sarjoja jaetaan suodattimella pörsseittäin tai symboleittain, tai kun vanha strategia käyttää eri nimeä). Tilamerkit: käytettävissä · tarkistamatta · ei yhteyttä. Tilamerkin vieressä olevaa reaaliaikamerkkiä painamalla avautuvat herätysasetukset (poll · notify · redis) — useimmille oletus riittää.
  5. Lasketut datajoukot (SQL) — Arvot, jotka vaativat laskentaa — liukuvat keskiarvot, viivearvot, useiden taulujen yhdistelmät. SQL voi lukea useita tauluja, joten ne kootaan erikseen eikä tietyn taulun alle. Useimmat laskelmat onnistuvat strategiakoodissa kahdella ctx.data-kutsulla, joten käytä SQL:ää vain, kun laskenta vaatii koko historian (liukuvat keskiarvot, järjestysluvut). Aiemmalla tavalla rekisteröidyt SQL-määritykset ovat myös täällä: [SQL tarkistettu] · [Poista], tai yksinkertaiset voi muuntaa kerralla taulunvalintamuotoon.
  6. Datajoukot, joiden taulua ei löytynyt — Kun määritettyä taulua ei ole nykyisessä luettelossa, datajoukko ei katoa, vaan jää tänne syyn kanssa — taululuetteloa ei ole vielä saatu (ei tarkoita, ettei sitä ole) · tietokannassa ei ole taulua (nimetty uudelleen tai poistettu) · tällä laitteella ei ole kyseistä yhteyden nimeä.
  7. Vaikutusalueita on kaksi — AI-julkisuustaso tallennetaan vain parhaillaan avoinna olevalle laitteelle. Datajoukot koskevat kaikkia laitteita, joilla on sama yhteyden nimi. Jos laitteita on useita, julkisuustaso valitaan jokaiselle erikseen.

1. Pelko-ahneusindeksi (Fear & Greed)

alternative.me

0 (äärimmäinen pelko) – 100 (äärimmäinen ahneus), kerran päivässä. Koko historia helmikuusta 2018. Psykologinen akseli, jota pelkkä hinta ei näytä — paras ensimmäiseksi testiksi.

node run.mjs fear-greed
Data-asetuksissa valittavat arvot (taulukon rivin [+ Lisää datajoukko tästä taulusta])
Yhteys: main   ·   Taulu: fear_greed
Nimi: fg   ·   Aikasarake: ts   ·   Arvosarake: v
Rekisteröinnin jälkeen sano AI:lle näin
"Aja datajoukollani fg backtest binance BTC 1d: osta, kun pelko-ahneusindeksi on alle 20, ja myy, kun se on yli 60"

2. Bitcoinin hashrate

blockchain.com

Lohkoketjun oma mittari (TH/s). Se on eri akselilla kuin hinta, joten se sopii markkinatilan suodattimeksi. Arvot ovat suuria ja trendi loiva, joten suhde liukuvaan keskiarvoon toimii paremmin kuin raaka-arvo.

node run.mjs btc-hashrate
Data-asetuksissa valittavat arvot (taulukon rivin [+ Lisää datajoukko tästä taulusta])
Yhteys: main   ·   Taulu: btc_hashrate
Nimi: hashrate   ·   Aikasarake: ts   ·   Arvosarake: v
Rekisteröinnin jälkeen sano AI:lle näin
"Lisää nykyiseen strategiaani suodatin, joka ostaa vain, kun datajoukko hashrate on 90 päivän keskiarvonsa yläpuolella"

3. Yhdysvaltain ohjauskorko (harjoitus)

FRED (DFF)

Päivittäinen efektiivinen Federal Funds -korko. Makrotilan suodattimen tyypillinen arvo. ★ Huom: sama arvo tulee jo perusindikaattorina base_fedfunds (ctx.data('base_fedfunds') — agentti kerää sen FRED:stä). Jos sama arvo syötetään kahta reittiä, tuloksesta ei näe, kumpaa käytettiin, joten käytä tätä vain integraation harjoitteluun.

node run.mjs fed-funds
Data-asetuksissa valittavat arvot (taulukon rivin [+ Lisää datajoukko tästä taulusta])
Yhteys: main   ·   Taulu: macro_fed_funds
Nimi: dff   ·   Aikasarake: ts   ·   Arvosarake: v
Rekisteröinnin jälkeen sano AI:lle näin
"Näytä datajoukkoluetteloni ja tarkista, onko dff käyttökelpoinen (integraation varmistamiseksi)"

Ajastettu keräys (cron)

Rekisteröi jokaisen hakijan (fetcher) ilmoittaman aikataulun crontabiin. Uudelleen ajettaessa rivit eivät kasaudu, eikä itse lisäämiisi cron-merkintöihin kosketa. Lokit tallentuvat logs-kansioon hakijakohtaisiin lokitiedostoihin.

node run.mjs --install-cron
Hyvä tietää
  • Aikasarakkeeseen suositellaan epoch-sekunteja (myös millisekunnit ja ISO tunnistetaan automaattisesti, ja tarkistusraportin tsUnit kertoo, miten se luettiin).
  • Skriptin voi ajaa turvallisesti uudelleen — se päivittää vain uudemmat arvot ilman kaksoiskappaleita (upsert). Uutta dataa varten aja se säännöllisesti uudelleen.
  • Backtestin tulokseen tallentuu datan sormenjälki (rivimäärä, tiiviste) — jos tietokannan sisältö muuttuu, sormenjälki muuttuu, eivätkä kaksi eri sormenjäljen tulosta ole samoilla ehdoilla ajettuja.
  • Myös ulkoista dataa käyttävät backtestit ajetaan agentilla — kaikki backtestit ajetaan vain agentilla (oma varasto).
  • Taulut, joille annat julkisuustason, näkyvät AI:lle (sarake-, otos- ja kyselytasoilla oikeaa dataa lähtee AI:lle) — älä julkista henkilötietoja sisältäviä tauluja.