Przedstawiamy Bitculator Data API

Każdy wykres, tabela i wskaźnik na Bitculator działa na jednym silniku danych: ceny na żywo odświeżane co około minutę, tysiące rynków na giełdach, wskaźniki nastrojów, wskaźniki techniczne, likwidacje, historia rynku globalnego.

Dzisiaj otwieramy ten silnik. Bitculator Data API działa na żywo - JSON API z Bearer uwierzytelnianiem z 85 punktami końcowymi w 15 grupach, darmowy tier i dokumentacja w 19 języków.

Twoje pierwsze wywołanie to jedna linia:

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

Utwórz klucz w konsoli deweloperskiej i to wywołanie działa już teraz. 

API jest zorganizowane w 15 grup zasobów, a wszystko, co platforma pokazuje, jest tam:

• Kryptowaluty i ceny - pełny katalog aktywów, ceny na żywo, ceny historyczne, OHLC, dane o podaży.
• Rynki i giełdy - pary, notowania, wolumeny i szczegóły giełd w miejscach, które śledzimy.
• Portfele - katalog portfeli z specyfikacją i obsługiwanymi aktywami.
• Rynek globalny - łączna kapitalizacja rynkowa, wolumen i dominacja, w tym serie historyczne.
• Nastrój i wskaźniki - strach i chciwość, sygnały byka i niedźwiedzia, oraz wskaźniki techniczne (RSI, średnie kroczące i inne) dla każdego aktywa.
• Likwidacje - dane dotyczące likwidacji long/short.
• Konwersje i kalkulatory - konwersja kryptowalut ↔ fiat po bieżących kursach i punkty końcowe kalkulatora platformy.
• Redakcja - artykuły i treści słownika/glossarium.
• Alarmy i webhooki - twórz alarmy cen za pomocą API i otrzymuj podpisane dostawy webhooków, gdy zostaną uruchomione.
• Meta - zużycie, plany i specyfikacja w formacie maszynowo czytelnym.

Pełna referencja, z działającymi przykładami dla każdego punktu końcowego, znajduje się w dokumentacji API.

Kilka decyzji projektowych, na których nie chcieliśmy iść na kompromis:

• Precyzja w formie ciągów dziesiętnych. Ceny, stopy i podaże zwracane są jako ciągi znaków, a nie liczby zmiennoprzecinkowe. Liczba zmiennoprzecinkowa nie może dokładnie przechować 0.00000001842, więc jej nie prosimy o to. Twój parser zachowuje każdą cyfrę wyprodukowaną przez rynek.
• Jedna koperta, wszędzie. Prawidłowe odpowiedzi to { data, meta }; każdy błąd-4xx lub 5xx to { "error": { "code", "message", "details" } }. Dopasuj według error.code: wiadomości mogą być redagowane, kody są stabilne.
• Twój limit zależy od każdej odpowiedzi. nagłówki X-Quota-Limit, X-Quota-Used i X-Quota-Reset wracają przy każdej próbie, więc nigdy nie musisz zgadywać, gdzie stojisz—choć możesz również po prostu zapytać GET /usage. 
• Przewidywalne limity. ograniczenia per_page zależą od planu, a przekroczenie limitu zwraca uczciwy 422. API nigdy nie zaciska twojego żądania w milczeniu i nie zwraca mniej niż prosiłeś.
• Podpisane webhooki. Dostawy alarmów zawierają nagłówek w stylu Stripe X-Bitculator-Signature, dzięki czemu możesz zweryfikować autentyczność przed zaufaniem ładunkowi.
• Publiczna specyfikacja. Cała powierzchnia opisana jest w specyfikacji OpenAPI, a dokumentacja oferuje gotową kolekcję Postman.

Data API ma własny miesięczny limit, oddzielny od osadzalnych widgetów Bitculatora. Darmowy poziom nie wymaga karty - zdobądź klucz i zacznij budować. Płatne plany zwiększają pulę wywołań miesięcznych i ograniczenie per_page; szczegóły i aktualne ceny znajdują się na stronie Data API.

Wraz z API dostarczamy osiem oficjalnych, licencjonowanych na MIT SDK - TypeScript, Python, PHP, Go, Rust, Java, C# i C++ - każdy obejmuje wszystkie 85 punktów końcowych z automatyczną paginacją, typowanymi błędami, inteligentnymi ponownymi próbami i gwarancją zapisu dziesiętnego wbudowaną. Instalacyjne polecenia, logotypy i linki do repozytoriów dla wszystkich ośmiu znajdują się w sekcji SDK na stronie API, a źródło jest otwarte na github.com/bitculator. Ale dla jasności: nie potrzebujesz SDK. To zwykłe HTTP z nagłówkiem Bearer - curl, fetch, requests lub Guzzle działają dokładnie tak, jak byś się spodziewał.

1. Przejrzyj stronę Data API w poszukiwaniu planów, limitów i szybkiego uruchomienia.
2. Stwórz swój klucz w konsoli deweloperskiej
3. Wykonaj pierwsze wywołanie - i sprawdź nagłówki X-Quota-*, które wracają wraz z nim.

Zbudowaliśmy to API, ponieważ chcieliśmy, aby istniało. Jeśli zeń skorzystasz i coś zrobisz, naprawdę chcielibyśmy o tym usłyszeć.