Predstavujeme Bitculator Data API

Každý graf, tabuľka a ukazovateľ na platforme Bitculator využíva jeden dátový engine: aktuálne ceny obnovované približne každú minútu, tisíce trhov naprieč burzami, ukazovatele sentimentu, technické indikátory, likvidácie a históriu globálneho trhu.

Dnes tento engine sprístupňujeme. Bitculator Data API je spustené - JSON API s autentifikáciou Bearer, 85 endpointmi v 15 skupinách, bezplatným programom a dokumentáciou v 19 jazykoch.

Na prvé volanie vám stačí jeden riadok:

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, "..." : “...”} }

Vytvorte si kľúč vo svojej vývojárskej konzole a toto volanie bude fungovať okamžite. 

API je rozdelené do 15 skupín zdrojov a nájdete v ňom všetko, čo platforma zobrazuje:

• Kryptomeny & ceny - kompletný katalóg aktív, aktuálne kotácie, historické ceny, OHLC, údaje o ponuke.
• Trhy & burzy - páry, tickery, objemy a podrobnosti o burzách naprieč sledovanými obchodnými platformami.
• Peňaženky - adresár peňaženiek so špecifikáciami a podporovanými aktívami.
• Globálny trh - celková trhová kapitalizácia, objem a dominancia vrátane historických časových radov.
• Sentiment & indikátory - strach & chamtivosť, signály býčieho/medvedieho trhu a technické indikátory (RSI, kĺzavé priemery a ďalšie) pre jednotlivé aktíva.
• Likvidácie - údaje o likvidáciách dlhých/krátkych pozícií.
• Prevod & kalkulačky - prevod kryptomien↔fiat mien pri aktuálnych kurzoch a endpointy kalkulačiek platformy.
• Redakčný obsah - články a obsah slovníka pojmov.
• Upozornenia & webhooky - vytvárajte cenové upozornenia cez API a pri ich spustení prijímajte podpísané webhookové správy.
• Meta - využitie, programy a strojovo čitateľná špecifikácia.

Úplnú referenčnú príručku so spustiteľnými príkladmi pre každý endpoint nájdete v dokumentácii API.

Niekoľko návrhových rozhodnutí, pri ktorých sme odmietli kompromisy:

• Presnosť desatinných čísel v reťazcoch. Ceny, kurzy a množstvá v ponuke sa vracajú ako reťazce, nikdy nie ako čísla s pohyblivou rádovou čiarkou. Typ float nedokáže verne zachytiť 0.00000001842, preto to od neho ani nežiadame. Váš parser zachová každú číslicu, ktorú trh vytvoril.
• Jednotná štruktúra, všade. Úspešné odpovede majú tvar { data, meta }; každá chyba-4xx alebo 5xx-má tvar { "error": { "code", "message", "details" } }. Riaďte sa hodnotou error.code: znenie správ sa môže meniť, kódy zostávajú stabilné.
• Údaje o kvóte v každej odpovedi. Hlavičky X-Quota-Limit, X-Quota-Used a X-Quota-Reset sa vracajú pri každom volaní, takže nikdy nemusíte hádať, ako na tom ste—hoci sa môžete jednoducho opýtať aj cez GET /usage. 
• Predvídateľné limity. Maximálne hodnoty per_page závisia od programu a prekročenie limitu vráti poctivú chybu 422. API nikdy potichu neobmedzí vašu požiadavku a nevráti menej, než ste žiadali.
• Podpísané webhooky. Správy s upozorneniami obsahujú hlavičku X-Bitculator-Signature v štýle Stripe, aby ste mohli overiť pravosť prijatých dát skôr, než im začnete dôverovať.
• Verejná špecifikácia. Celé rozhranie je opísané v špecifikácii OpenAPI a dokumentácia ponúka hotovú kolekciu pre Postman.

Data API má vlastnú mesačnú kvótu, oddelenú od vložiteľných widgetov platformy Bitculator. Bezplatný program nevyžaduje platobnú kartu - získajte kľúč a začnite tvoriť. Platené programy zvyšujú mesačný počet volaní a limit per_page ; podrobnosti a aktuálne ceny nájdete na stránke Data API.

Spolu s API prinášame osem oficiálnych SDK pod licenciou MIT - TypeScript, Python, PHP, Go, Rust, Java, C# a C++ - každé pokrýva všetkých 85 endpointov a má zabudované automatické stránkovanie, typované chyby, inteligentné opakovanie požiadaviek a záruku desatinných čísel vo forme reťazcov. Inštalačné príkazy, logá a odkazy na repozitáre všetkých ôsmich nájdete v sekcii SDK na stránke API a zdrojový kód je verejne dostupný na github.com/bitculator. Aby však bolo jasné: SDK nepotrebujete. Je to obyčajné HTTP s hlavičkou Bearer - curl, fetch, requests či Guzzle fungujú presne tak, ako by ste očakávali.

1. Pozrite si stránku Data API s programami, kvótami a stručným návodom na začiatok.
2. Vytvorte si kľúč vo vývojárskej konzole
3. Vykonajte prvé volanie - a skontrolujte hlavičky X-Quota-*, ktoré sa s ním vrátia.

Toto API sme vytvorili, pretože sme chceli, aby existovalo. Ak na ňom niečo postavíte, naozaj o tom radi počujeme.