Esittelyssä Bitculator Data API

Jokainen Bitculatorin kaavio, taulukko ja mittari toimii saman datamoottorin varassa: noin minuutin välein päivittyvät reaaliaikaiset hinnat, tuhansia markkinoita eri pörsseissä, tunnelmamittarit, tekniset indikaattorit, likvidaatiot ja maailmanlaajuinen markkinahistoria.

Tänään avaamme tämän moottorin kaikkien käyttöön. Bitculator Data API on nyt saatavilla - Bearer-todennusta käyttävä JSON-rajapinta, jossa on 85 päätepistettä 15 ryhmässä, ilmaistaso ja dokumentaatio 19 kielellä.

Ensimmäinen kutsusi on yhden rivin mittainen:

curl "https://bitculator.com/api/v1/coins?per_page=5" \ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : “...”} }

Luo avain kehittäjäkonsolissasi, niin kutsu toimii heti. 

API on jaettu 15 resurssiryhmään, ja niistä löytyy kaikki, mitä alusta näyttää:

• Kolikot & hinnat - koko kryptovaraluettelo, reaaliaikaiset noteeraukset, historialliset hinnat, OHLC ja tarjontatiedot.
• Markkinat & pörssit - parit, kaupankäyntitunnukset, volyymit ja pörssien tiedot seuraamiltamme kauppapaikoilta.
• Lompakot - lompakkohakemisto, tekniset tiedot ja tuetut kryptovarat.
• Globaalit markkinat - kokonaismarkkina-arvo, volyymi ja dominanssi sekä historialliset aikasarjat.
• Markkinatunnelma & indikaattorit - pelko & ahneus, nousu- ja laskumarkkinoiden signaalit sekä kryptovarakohtaiset tekniset indikaattorit (RSI, liukuvat keskiarvot ja muut).
• Likvidaatiot - pitkien ja lyhyiden positioiden likvidaatiotiedot.
• Muunnokset & laskurit - krypto↔fiat-muunnokset reaaliaikaisilla kursseilla ja alustan laskuripäätepisteet.
• Toimituksellinen sisältö - artikkelit ja sanastosisältö.
• Hälytykset & webhookit - luo hintahälytyksiä API-rajapinnan kautta ja vastaanota allekirjoitettuja webhook-viestejä, kun ne laukeavat.
• Metatiedot - käyttö, tilauspaketit ja koneluettava määrittely.

Täydellinen viiteopas ja suoritettavat esimerkit jokaiselle päätepisteelle löytyvät API-dokumentaatiosta.

Muutama suunnitteluratkaisu, joista emme suostuneet tinkimään:

• Desimaalimerkkijonojen tarkkuus. Hinnat, kurssit ja tarjontamäärät palautetaan merkkijonoina, ei koskaan liukulukuina. Liukuluku ei pysty esittämään lukua 0.00000001842 täysin tarkasti, joten emme vaadi sitä siltä. Jäsentimesi säilyttää jokaisen markkinoiden tuottaman numeron.
• Sama rakenne kaikkialla. Onnistuneiden vastausten muoto on { data, meta }; jokaisen virheen-4xx tai 5xx-muoto on { "error": { "code", "message", "details" } }. Käytä tunnistamiseen error.code-kenttää: viestien sanamuoto voi muuttua, koodit pysyvät samoina.
• Kiintiötietosi kulkevat jokaisen vastauksen mukana. X-Quota-Limit-, X-Quota-Used- ja X-Quota-Reset-otsakkeet palautetaan jokaisen kutsun yhteydessä, joten sinun ei koskaan tarvitse arvailla tilannettasi—voit tosin myös kysyä sitä suoraan kutsulla GET /usage. 
• Ennakoitavat rajat. per_page-enimmäisarvot määräytyvät tilauspaketin mukaan, ja rajan ylitys palauttaa rehellisesti koodin 422. API ei koskaan rajoita pyyntöäsi huomaamatta ja palauta vähemmän kuin pyysit.
• Allekirjoitetut webhookit. Hälytysviestien mukana on Stripe-tyylinen X-Bitculator-Signature-otsake, jotta voit varmistaa aitouden ennen viestin sisältöön luottamista.
• Julkinen määrittely. Koko rajapinta on kuvattu OpenAPI-määrittelyssä, ja dokumentaatio tarjoaa valmiin Postman-kokoelman.

Data API -rajapinnalla on oma kuukausikiintiönsä, joka on erillinen Bitculatorin upotettavista widgeteistä. Ilmaistaso ei vaadi maksukorttia - hanki avain ja aloita kehittäminen. Maksulliset paketit kasvattavat kuukausittaista kutsukiintiötä ja per_page -enimmäisarvoa; tarkemmat tiedot ja ajantasaiset hinnat löytyvät Data API -sivulta.

API-rajapinnan rinnalla julkaisemme kahdeksan virallista MIT-lisensoitua SDK:ta - TypeScript, Python, PHP, Go, Rust, Java, C# ja C++ - joista jokainen kattaa kaikki 85 päätepistettä ja sisältää automaattisen sivutuksen, tyypitetyt virheet, älykkäät uudelleenyritykset ja takuun desimaalimerkkijonojen käytöstä. Kaikkien kahdeksan asennuskomennot, logot ja lähdekoodivarastojen linkit löytyvät API-sivun SDK-osiosta, ja lähdekoodi on avoimesti saatavilla osoitteessa github.com/bitculator. Mutta selvyyden vuoksi: et tarvitse SDK:ta. Kyse on tavallisesta HTTP:stä Bearer-otsakkeella - curl, fetch, requests tai Guzzle toimivat juuri niin kuin odotat.

1. Tutustu tilauspaketteihin, kiintiöihin ja pikaohjeeseen Data API -sivulla.
2. Luo avaimesi kehittäjäkonsolissa
3. Tee ensimmäinen kutsusi - ja tarkista sen mukana palautuvat X-Quota-*-otsakkeet.

Rakensimme tämän API-rajapinnan, koska halusimme sen olevan olemassa. Jos rakennat jotain sen avulla, kuulisimme siitä todella mielellämme.