Vă prezentăm API-ul de date Bitculator

Fiecare grafic, tabel și indicator de pe Bitculator funcționează cu ajutorul unui singur motor de date: prețuri live actualizate aproximativ o dată pe minut, mii de piețe de pe exchange-uri, indicatori de sentiment, indicatori tehnici, lichidări și istoricul pieței globale.

Astăzi deschidem accesul la acest motor. Bitculator Data API este disponibilă - o API JSON cu autentificare Bearer, cu 85 de endpoint-uri în 15 grupuri, un nivel gratuit și documentație în 19 limbi.

Prima ta solicitare se rezumă la o singură linie:

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

Creează o cheie în consola pentru dezvoltatori și solicitarea va funcționa imediat. 

API-ul este organizat în 15 grupuri de resurse și include tot ce afișează platforma:

• Monede și prețuri - catalogul complet de active, cotații live, prețuri istorice, OHLC și date despre supply.
• Piețe și exchange-uri - perechi, tickere, volume și detalii despre exchange-urile pe care le monitorizăm.
• Wallet-uri - directorul de wallet-uri, cu specificații și active acceptate.
• Piața globală - marketcap-ul total, volumele și dominanța, inclusiv serii istorice.
• Sentiment și indicatori - fear & greed, semnale privind regimul bull/bear și indicatori tehnici (RSI, medii mobile și altele) pentru fiecare activ.
• Lichidări - date despre lichidările long/short.
• Conversii și calculatoare - conversii crypto↔fiat la cursuri live și endpoint-urile calculatoarelor platformei.
• Conținut editorial - articole și conținutul glosarului.
• Alerte și webhook-uri - creează alerte de preț prin API și primește webhook-uri semnate când acestea se declanșează.
• Meta - utilizare, planuri și specificația într-un format lizibil automat.

Documentația completă, cu exemple executabile pentru fiecare endpoint, se găsește în documentația API-ului.

Câteva decizii de proiectare asupra cărora nu am fost dispuși să facem compromisuri:

• Precizie prin șiruri zecimale. Prețurile, cursurile și supply-ul sunt returnate ca șiruri de caractere, niciodată ca numere float. Un număr float nu poate reprezenta cu fidelitate 0.00000001842, așa că nu ne bazăm pe el. Parserul tău păstrează fiecare cifră furnizată de piață.
• Un singur format de răspuns, peste tot. Răspunsurile reușite au formatul { data, meta }; toate erorile - 4xx sau 5xx - au formatul { "error": { "code", "message", "details" } }. Verifică error.code: mesajele se pot schimba, codurile rămân stabile.
• Cota ta este inclusă în fiecare răspuns. Antetele X-Quota-Limit, X-Quota-Used și X-Quota-Reset sunt returnate la fiecare solicitare, ca să știi mereu unde te situezi — deși poți apela pur și simplu GET /usage. 
• Limite previzibile. Limitele per_page depind de plan, iar depășirea unei limite returnează un răspuns 422 explicit. API-ul nu limitează în tăcere solicitarea și nu returnează mai puțin decât ai cerut.
• Webhook-uri semnate. Alertele livrate includ un antet X-Bitculator-Signature similar cu cel de la Stripe, pentru a putea verifica autenticitatea înainte de a avea încredere în conținutul transmis.
• O specificație publică. Întreaga API este descrisă în specificația OpenAPI, iar documentația include o colecție Postman gata de utilizare.

Data API are o cotă lunară proprie, separată de widget-urile încorporabile Bitculator. Nivelul gratuit nu necesită un card - obține o cheie și începe să construiești. Planurile plătite măresc numărul lunar de solicitări și limita per_page ; detaliile și prețurile actuale sunt pe pagina Data API.

Pe lângă API, oferim opt SDK-uri oficiale, cu licență MIT - TypeScript, Python, PHP, Go, Rust, Java, C# și C++ - fiecare acoperind toate cele 85 de endpoint-uri și incluzând paginare automată, erori tipizate, reîncercări inteligente și garanția utilizării șirurilor zecimale. Comenzile de instalare, siglele și linkurile către repository-urile tuturor celor opt sunt în secțiunea SDK-uri a paginii API, iar codul sursă este disponibil public pe github.com/bitculator. Dar, ca să fie clar: nu ai nevoie de un SDK. Este HTTP simplu, cu un antet Bearer - curl, fetch, requests sau Guzzle funcționează exact cum te-ai aștepta.

1. Răsfoiește pagina Data API pentru planuri, cote și ghidul de pornire rapidă.
2. Creează-ți cheia în consola pentru dezvoltatori
3. Trimite prima solicitare și verifică antetele X-Quota-* din răspuns.

Am creat acest API pentru că ne-am dorit să existe. Dacă construiești ceva cu el, chiar ne-ar plăcea să ne povestești.