Predstavljamo Bitculator Data API

Svaki grafikon, tabela i pokazatelj na platformi Bitculator oslanja se na isti sistem podataka: cene uživo koje se osvežavaju otprilike svakog minuta, hiljade tržišta na berzama, pokazatelji sentimenta, tehnički indikatori, likvidacije, istorija globalnog tržišta.

Danas otvaramo pristup tom sistemu. Bitculator Data API je dostupan - JSON API sa Bearer autentifikacijom, 85 krajnjih tačaka u 15 grupa, besplatnim paketom i dokumentacijom na 19 jezika.

Vaš prvi poziv staje u jedan red:

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

Kreirajte ključ u svojoj razvojnoj konzoli i taj poziv će odmah raditi. 

API je organizovan u 15 grupa resursa i sadrži sve što platforma prikazuje:

• Kriptovalute & cene - kompletan katalog imovine, kotacije uživo, istorijske cene, OHLC, podaci o ponudi.
• Tržišta & berze - parovi, tiker simboli, obimi trgovanja i detalji o berzama koje pratimo.
• Novčanici - direktorijum novčanika sa specifikacijama i podržanom imovinom.
• Globalno tržište - ukupna tržišna kapitalizacija, obim trgovanja i dominacija, uključujući istorijske serije.
• Sentiment & indikatori - strah & pohlepa, signali bikovskog/medveđeg tržišnog režima i tehnički indikatori (RSI, pokretni proseci i ostali) za svaku imovinu.
• Likvidacije - podaci o likvidacijama dugih/kratkih pozicija.
• Konverzija & kalkulatori - kripto↔fiat konverzija po aktuelnim kursevima i krajnje tačke kalkulatora platforme.
• Urednički sadržaj - članci i sadržaj pojmovnika.
• Alarmi & webhookovi - kreirajte cenovne alarme putem API-ja i primajte potpisane webhook poruke kada se aktiviraju.
• Meta - potrošnja, paketi i mašinski čitljiva specifikacija.

Kompletan referentni pregled, sa izvršivim primerima za svaku krajnju tačku, nalazi se u API dokumentaciji.

Nekoliko projektnih odluka oko kojih nismo pristajali na kompromise:

• Preciznost decimalnih brojeva u stringovima. Cene, kursevi i količine u ponudi vraćaju se kao stringovi, nikada kao float vrednosti. Float ne može verno da predstavi 0.00000001842, pa to od njega ni ne tražimo. Vaš parser čuva svaku cifru koju je tržište proizvelo.
• Ista struktura odgovora, svuda. Uspešni odgovori imaju oblik { data, meta }; svaka greška-4xx ili 5xx-ima oblik { "error": { "code", "message", "details" } }. Proveravajte error.code: formulacija poruka može da se promeni, kodovi ostaju isti.
• Podaci o vašoj kvoti stižu uz svaki odgovor. Zaglavlja X-Quota-Limit, X-Quota-Used i X-Quota-Reset vraćaju se pri svakom pozivu, tako da nikada ne morate da nagađate koliko vam je preostalo—a možete i jednostavno da pozovete GET /usage. 
• Predvidiva ograničenja. Ograničenja za per_page zavise od paketa, a prekoračenje vraća jasan kod 422. API nikada ne ograničava vaš zahtev prećutno niti vraća manje nego što ste tražili.
• Potpisani webhookovi. Poruke alarma nose zaglavlje X-Bitculator-Signature po uzoru na Stripe, kako biste mogli da proverite autentičnost pre nego što prihvatite podatke kao pouzdane.
• Javna specifikacija. Ceo interfejs opisan je u OpenAPI specifikaciji, a dokumentacija nudi gotovu Postman kolekciju.

Data API ima sopstvenu mesečnu kvotu, odvojenu od Bitculator vidžeta za ugradnju. Za besplatan paket nije potrebna kartica - preuzmite ključ i počnite da razvijate. Plaćeni paketi povećavaju mesečni broj poziva i per_page ograničenje; detalji i aktuelne cene nalaze se na Data API stranici.

Uz API nudimo osam zvaničnih SDK-ova pod MIT licencom - TypeScript, Python, PHP, Go, Rust, Java, C# i C++ - svaki pokriva svih 85 krajnjih tačaka, sa automatskom paginacijom, tipiziranim greškama, pametnim ponavljanjem pokušaja i ugrađenom garancijom da se decimalne vrednosti prenose kao stringovi. Komande za instalaciju, logotipi i linkovi ka repozitorijumima za svih osam nalaze se u SDK odeljku API stranice, a izvorni kod je otvoren na github.com/bitculator. Ali da budemo jasni: SDK vam nije potreban. To je običan HTTP sa Bearer zaglavljem - curl, fetch, requests ili Guzzle rade upravo onako kako biste očekivali.

1. Pregledajte Data API stranicu za pakete, kvote i vodič za brzi početak.
2. Kreirajte svoj ključ u razvojnoj konzoli
3. Uputite prvi poziv - i proverite X-Quota-* zaglavlja koja stižu uz odgovor.

Napravili smo ovaj API jer smo želeli da postoji. Ako napravite nešto pomoću njega, zaista bismo voleli da čujemo o tome.