Bemutatkozik a Bitculator Data API

A Bitculator minden grafikonja, táblázata és mérőeszköze egyetlen adatmotorra épül: percenként frissülő élő árakra, a tőzsdéken elérhető több ezer piacra, hangulatmérőkre, technikai indikátorokra, likvidálásokra és a globális piac előzményeire.

Ma elérhetővé tesszük ezt az adatmotort. A Bitculator Data API már használható – egy Bearer-hitelesítésű JSON API 15 csoportba rendezett 85 végponttal, ingyenes csomaggal és 19 nyelven elérhető dokumentációval.

Az első API-hívásod egy sor:

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

Hozz létre egy kulcsot a fejlesztői konzolban, és az API-hívás máris működik. 

Az API 15 erőforráscsoportba rendeződik, és megtalálható benne minden, amit a platform megjelenít:

• Coinok és árak - teljes eszközkatalógus, élő árfolyamok, historikus árak, OHLC, kínálati adatok.
• Piacok és tőzsdék - párok, tickerek, forgalmi adatok és tőzsdei részletek az általunk követett platformokon.
• Tárcák - tárcakatalógus műszaki adatokkal és a támogatott eszközökkel.
• Globális piac - teljes market cap, forgalom és dominancia, historikus idősorokkal együtt.
• Hangulat és indikátorok - félelem és kapzsiság, bull/bear trendjelzések, valamint eszközönkénti technikai indikátorok (RSI, mozgóátlagok és egyebek).
• Likvidálások - long/short likvidálási adatok.
• Átváltás és kalkulátorok - kriptovaluta↔fiat átváltás élő árfolyamokon, valamint a platform kalkulátorainak végpontjai.
• Szerkesztőségi tartalom - cikkek és szószedeti tartalmak.
• Riasztások és webhookok - árfolyamriasztások létrehozása az API-n keresztül, és aláírt webhook-értesítések fogadása aktiváláskor.
• Metaadatok - használat, csomagok és géppel olvasható specifikáció.

A teljes referencia minden végponthoz futtatható példákkal az API-dokumentációban található.

Néhány tervezési elv, amelyből nem engedtünk:

• Pontos decimális karakterláncok. Az árakat, árfolyamokat és kínálati adatokat karakterláncként adjuk vissza, soha nem lebegőpontos számként. Egy lebegőpontos szám nem tudja pontosan tárolni a 0.00000001842 értéket, ezért nem is használjuk erre. Az adatok feldolgozásakor a piaci érték minden számjegye megmarad.
• Egységes válaszformátum mindenhol. A sikeres válaszok formátuma { data, meta }; minden hiba – legyen 4xx-es vagy 5xx-ös – formátuma { "error": { "code", "message", "details" } }. Az error.code alapján kezeld a hibát: az üzenetek szövege változhat, a kódok állandók.
• Minden válasz tartalmazza a kvótád adatait. Az X-Quota-Limit, X-Quota-Used és X-Quota-Reset fejléceket minden API-hívás megkapja, így mindig tudod, hol tartasz – de a GET /usage végponttól is lekérdezheted. 
• Kiszámítható korlátok. A per_page felső határa a csomagodtól függ, túllépése pedig egyértelmű 422-es hibát eredményez. Az API soha nem korlátozza csendben a kérésedet, és nem ad vissza a kértnél kevesebb adatot.
• Aláírt webhookok. A riasztási értesítések Stripe-stílusú X-Bitculator-Signature fejlécet tartalmaznak, így ellenőrizheted a hitelességüket, mielőtt megbíznál a payloadban.
• Nyilvános specifikáció. A teljes API-felületet az OpenAPI-specifikáció írja le, a dokumentáció pedig kész Postman-gyűjteményt is kínál.

A Data API havi kvótája különálló a Bitculator beágyazható widgetjeinek kvótájától. Az ingyenes csomaghoz nem kell bankkártya – kérj egy kulcsot, és már kezdhetsz is fejleszteni. A fizetős csomagok nagyobb havi híváskeretet és magasabb per_page korlátot kínálnak; a részleteket és az aktuális árakat a Data API oldalán találod.

Az API mellett nyolc hivatalos, MIT-licencű SDK-t kínálunk TypeScripthez, Pythonhoz, PHP-hez, Go-hoz, Rusthoz, Javához, C#-hoz és C++-hoz. Mind a 85 végpontot lefedik, és automatikus lapozást, típusos hibákat, intelligens újrapróbálkozást, valamint beépített decimális karakterlánc-kezelést biztosítanak. Mind a nyolc SDK telepítési útmutatóját, logóját és tárhivatkozását az API-oldal SDK-kat bemutató részében találod, a forráskód pedig nyíltan elérhető a github.com/bitculator oldalon. Fontos azonban: nincs szükséged SDK-ra. Az API egyszerű HTTP Bearer-fejléccel – a curl, a fetch, a requests vagy a Guzzle pontosan úgy működik, ahogy várnád.

1. Nézd át a Data API oldalát a csomagokért, kvótákért és a gyors kezdésért.
2. Hozz létre egy kulcsot a fejlesztői konzolban
3. Indítsd el az első API-hívást – és ellenőrizd a vele érkező X-Quota-* fejléceket.

Ezt az API-t azért építettük meg, mert szerettük volna, hogy létezzen. Ha készítesz vele valamit, örömmel hallanánk róla.