Bemutatkozik a Bitculator Data API

A Bitculator minden grafikonját, táblázatát és mutatóját egyetlen adatmotor szolgálja ki: nagyjából percenként frissülő élő árfolyamok, több ezer piac különböző tőzsdéken, hangulatmutatók, technikai indikátorok, likvidálások és globális piaci idősorok.

Ma megnyitjuk ezt az adatmotort. Elindult a Bitculator Data API - egy Bearer-hitelesítésű JSON API 85 végponttal, 15 csoportba rendezve, ingyenes csomaggal és 19 nyelven elérhető dokumentációval.

Az első hívásod egyetlen 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 konzolodban, és ez a hívás máris működik. 

Az API 15 erőforráscsoportba szerveződik, és mindent megtalálsz benne, amit a platform megjelenít:

• Kriptovaluták és árfolyamok - a teljes eszközkatalógus, élő árfolyamok, historikus árfolyamok, OHLC, kínálati adatok.
• Piacok és tőzsdék - kereskedési párok, tickerek, forgalmi adatok és tőzsdei részletek az általunk követett kereskedési helyszínekről.
• Tárcák - a tárcák jegyzéke jellemzőkkel és támogatott eszközökkel.
• Globális piac - teljes piaci kapitalizáció, forgalom és dominancia, historikus idősorokkal együtt.
• Hangulat és indikátorok - félelem és kapzsiság, bika- és medvepiaci jelzések, valamint technikai indikátorok (RSI, mozgóátlagok és társaik) eszközönként.
• Likvidálások - long/short likvidálási adatok.
• Átváltás és kalkulátorok - kripto↔fiat átváltás élő árfolyamokon és a platform kalkulátorainak végpontjai.
• Szerkesztőségi tartalmak - cikkek és fogalomtári tartalmak.
• Riasztások és webhookok - hozz létre árfolyamriasztásokat az API segítségével, és fogadj aláírt webhook-értesítéseket, amikor aktiválódnak.
• Meta - használat, csomagok és a géppel olvasható specifikáció.

A teljes referencialeírást, minden végponthoz futtatható példákkal, az API dokumentációjában találod.

Néhány tervezési döntés, amelynél nem kötöttünk kompromisszumot:

• Pontosság szövegként tárolt tizedesekkel. 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 hűen tárolni a 0.00000001842 értéket, ezért nem is bízzuk rá. A feldolgozód minden, a piac által előállított számjegyet megőriz.
• Egységes válaszstruktúra mindenhol. A sikeres válaszok formátuma { data, meta }; minden hiba-4xx vagy 5xx-formátuma { "error": { "code", "message", "details" } }. Az error.code alapján azonosítsd a hibákat: az üzenetek szövege változhat, a kódok állandók.
• A kvótád minden válaszban szerepel. Az X-Quota-Limit, X-Quota-Used és X-Quota-Reset fejléceket minden hívásnál visszakapod, így sosem kell találgatnod, hol tartasz—de a GET /usage hívással is egyszerűen lekérdezheted. 
• Kiszámítható korlátok. A per_page felső korlátja csomagfüggő, és a túllépése egyértelmű 422-es választ eredményez. Az API soha nem korlátozza csendben a kérésedet, és nem ad vissza kevesebbet, mint amennyit kértél.
• 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ízol a küldött adatokban.
• Nyilvános specifikáció. A teljes 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 saját havi kvótával rendelkezik, a Bitculator beágyazható widgetjeitől függetlenül. Az ingyenes csomaghoz nem kell bankkártya - szerezz egy kulcsot, és kezdj fejleszteni. A fizetős csomagok növelik a havi híváskeretet és a per_page felső korlátját; a részleteket és az aktuális árakat a Data API oldalán találod.

Az API mellett nyolc hivatalos, MIT-licencű SDK-t is kiadunk - TypeScript, Python, PHP, Go, Rust, Java, C# és C++ nyelvekhez - mindegyik lefedi mind a 85 végpontot, beépített automatikus lapozással, típusos hibákkal, intelligens újrapróbálkozással és a tizedesek garantáltan karakterláncos kezelésével. Mind a nyolc telepítési parancsait, logóit és kódtárhivatkozásait az API-oldal SDK szakaszában találod, a forráskód pedig nyíltan elérhető a github.com/bitculator címen. De egyértelműen kijelentjük: nincs szükséged SDK-ra. Ez egyszerű HTTP egy Bearer fejléccel - a curl, fetch, requests vagy 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ési útmutatóért.
2. Hozd létre a kulcsodat a fejlesztői konzolban
3. Indítsd el az első hívásodat - és ellenőrizd a válaszban kapott X-Quota-* fejléceket.

Azért készítettük ezt az API-t, mert szerettük volna, hogy létezzen. Ha építesz rá valamit, őszintén örülnénk, ha mesélnél róla.