Predstavljamo Bitculator Data API

Svaki grafikon, tabela i pokazivač na Bitculator-u koristi isti mehanizam za podatke: cene uživo koje se osvežavaju otprilike svakog minuta, hiljade tržišta na berzama, pokazatelje sentimenta, tehničke indikatore, likvidacije i globalnu istoriju tržišta.

Danas otvaramo pristup tom mehanizmu. Bitculator Data API je dostupan - JSON API sa Bearer autentifikacijom, 85 endpoint-a 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, "..." : “...”} }

Napravite ključ u svojoj konzoli za developere i poziv će odmah raditi. 

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

• Kriptovalute i cene - kompletan katalog sredstava, cene uživo, istorijske cene, OHLC i podaci o ponudi.
• Tržišta i berze - parovi, tikeri, obimi trgovanja i detalji o berzama koje pratimo.
• Novčanici - direktorijum novčanika sa specifikacijama i podržanim sredstvima.
• Globalno tržište - ukupna tržišna kapitalizacija, obim trgovanja i dominacija, uključujući istorijske serije.
• Sentiment i indikatori - strah i pohlepa, signali bullish/bearish režima i tehnički indikatori (RSI, pokretni proseci i srodni indikatori) za svako sredstvo.
• Likvidacije - podaci o likvidacijama long/short pozicija.
• Konverzija i kalkulatori - konverzija kriptovaluta↔fiat po aktuelnim kursevima i endpoint-i kalkulatora na platformi.
• Urednički sadržaj - članci i sadržaj rečnika.
• Alarmi i webhook-ovi - kreirajte cenovne alarme preko API-ja i primajte potpisane webhook pozive kada se aktiviraju.
• Meta - korišćenje, paketi i mašinski čitljiva specifikacija.

Kompletna referenca, sa primerima za svaki endpoint koje možete odmah pokrenuti, nalazi se u API dokumentaciji.

Nekoliko principa dizajna oko kojih nismo pravili kompromise:

• Preciznost decimalnih vrednosti. Cene, kursevi i ponuda vraćaju se kao stringovi, nikada kao float vrednosti. Float ne može precizno da predstavi 0.00000001842, pa mu to ni ne prepuštamo. Vaš parser čuva svaku cifru koju je tržište proizvelo.
• Jedan format omotača, svuda. Uspešni odgovori su { data, meta }; svaka greška - 4xx ili 5xx - je { "error": { "code", "message", "details" } }. Koristite error.code za prepoznavanje greške: poruke mogu da se preformulišu, kodovi ostaju stabilni.
• Vaša kvota je navedena u svakom odgovoru. Zaglavlja X-Quota-Limit, X-Quota-Used i X-Quota-Reset vraćaju se pri svakom pozivu, tako da uvek znate na čemu ste — a možete jednostavno da pozovete i GET /usage. 
• Predvidiva ograničenja. Ograničenja za per_page zavise od paketa, a prekoračenje limita vraća jasnu grešku 422. API nikada neće neprimetno smanjiti traženu vrednost i vratiti manje rezultata nego što ste tražili.
• Potpisani webhook-ovi. Isporuke alarma sadrže zaglavlje X-Bitculator-Signature, nalik Stripe potpisu, da biste mogli da proverite autentičnost pre nego što prihvatite sadržaj.
• Javna specifikacija. Ceo API je opisan u OpenAPI specifikaciji, a dokumentacija nudi i gotovu Postman kolekciju.

Data API ima sopstvenu mesečnu kvotu, odvojenu od Bitculator-ovih vidžeta za ugradnju. Za besplatan paket nije potrebna kartica - preuzmite ključ i počnite da gradite. Plaćeni paketi povećavaju mesečni broj poziva i per_page limit; detalje i aktuelne cene možete pronaći na Data API stranici.

Uz API nudimo i osam zvaničnih SDK-ova sa MIT licencom - za TypeScript, Python, PHP, Go, Rust, Java, C# i C++ - svaki pokriva svih 85 endpoint-a i uključuje automatsku paginaciju, tipizovane greške, pametne ponovne pokušaje i očuvanje preciznosti decimalnih stringova. Komande za instalaciju, logotipi i linkovi ka repozitorijumima za svih osam nalaze se u odeljku SDK na API stranici, a izvorni kod je javno dostupan na github.com/bitculator. Ipak, da bude jasno: SDK vam nije neophodan. Ovo je običan HTTP sa Bearer zaglavljem - curl, fetch, requests ili Guzzle rade upravo onako kako biste očekivali.

1. Pogledajte Data API stranicu za pakete, kvote i brzi početak.
2. Napravite ključ u konzoli za developere
3. Uputite prvi poziv - i proverite zaglavlja X-Quota-* koja stižu uz njega.

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