Dziennik zmian
Każda zmiana w Data API i jego kontrakcie, od najnowszych. Numery wersji podlegają polityce wersjonowania i wycofywania.
/mcp akceptuje teraz klucz MCP także w nagłówku X-API-Key: YOUR_API_KEY, z myślą o klientach i bramach, takich jak Smithery, które rezerwują nagłówek Authorization na potrzeby własnego logowania. Authorization: Bearer wciąż działa i pozostaje udokumentowaną metodą domyślną; gdy wysyłane są oba nagłówki, sprawdzany jest klucz z X-API-Key. Data API pod /api/v1 nadal akceptuje wyłącznie klucze Bearer. Nieudane próby uwierzytelnienia są teraz ograniczane nie tylko dla każdego adresu IP, ale także dla każdego klucza, więc nieprawidłowy klucz jednego klienta nie blokuje już innych klientów za tym samym adresem IP.
GET /calculators/compound-interest zaokrąglał czas trwania do pełnych okresów kapitalizacji, więc czas trwania kończący się w połowie okresu był symulowany jako zbyt długi lub zbyt krótki: 6 miesięcy przy kapitalizacji annually obejmowało cały rok (12 wpłat i odsetki za pełny rok), a 5 miesięcy nie obejmowało żadnego okresu (brak wpłat i odsetek). Pełne okresy są teraz liczone jak dotąd, ostatni niepełny okres przynosi odsetki proporcjonalnie (odsetki proste za jego część), a każda wpłata w czasie trwania jest uwzględniana. Wyniki się nie zmieniają, gdy czas trwania jest całkowitą liczbą okresów kapitalizacji; parametry i pola odpowiedzi pozostają bez zmian.
API i jego dokumentacja traktowały rate jako stopę na okres kapitalizacji, podczas gdy kalkulator na stronie i jego instrukcja używały stopy rocznej. GET /calculators/compound-interest stosował pełną wartość rate do każdego okresu kapitalizacji, więc 5% przy kapitalizacji miesięcznej rosło jak 5% miesięcznie. rate to teraz nominalna roczna stopa procentowa: każdy okres nalicza rate podzieloną przez liczbę okresów w roku (5% przy kapitalizacji miesięcznej daje 5/12% miesięcznie), co podaje teraz także meta.note. Parametry i pola odpowiedzi się nie zmieniają; wyniki zmieniają się dla każdej częstotliwości kapitalizacji z wyjątkiem annually. Niezależnie od tego, gdy contribution_frequency i compound_frequency mają tę samą wartość daily lub weekly, wpłaty nie są już opóźniane ani pomijane z powodu zaokrągleń zmiennoprzecinkowych, więc total_contributions może przy duration_unit=months obejmować o jedną wpłatę więcej. Zmienia to znaczenie istniejącego parametru: aby odtworzyć wcześniejsze wyniki, pomnóż rate przez liczbę okresów kapitalizacji w roku.
Każdy odczyt Fear & Greed zawiera teraz index obok score: indeks Fear & Greed w skali 0–100 dokładnie taki, jak pokazuje Bitculator (0–19 skrajny strach, 20–39 strach, 40–59 neutralnie, 60–79 chciwość, 80–100 skrajna chciwość) — używaj go do wyświetlania. score się nie zmienia: to surowa wartość złożona −100…+100, z której wyprowadzany jest index. Dotyczy GET /sentiment/fear-greed (odczyt główny i każdy wpis w intervals), fear_greed w GET /global oraz meta.fear_greed w GET /global/heatmap. Wyłącznie dodanie; żadne istniejące pole się nie zmieniło.
GET /coins/{slug} zwracał fully_diluted_valuation jako 0 dla kryptowalut bez maksymalnej podaży (na przykład Solana i Ethereum, których podaż nie ma limitu). Teraz używana jest całkowita podaż, a wartość to null, gdy żadna nie jest znana, jak kontrakt OpenAPI już dokumentował.
marketcap i dominance mogą mieć wartość null dla monety bez podaży w obiegu, a score i breakdown oceny zaufania mają wartość null dla giełdy bez rankingu. POST /alarms zwraca 422, gdy moneta nie ma bieżącej wartości dla wybranej metryki. /coins/recently-added i /wallets/timeline uwzględniają teraz sort. /coins/gainers i /coins/losers są sortowane według samej zmiany (wcześniej w praktyce według kapitalizacji rynkowej), a losers pomijają monety na poziomie 0.00. Sortowanie rosnące zwraca wartości null na końcu. /prices rozwiązuje niejednoznaczny symbol na aktywną monetę o najwyższym rankingu. Kontrakt OpenAPI oznacza pola rynkowe, które mogą mieć wartość null, i typuje wolumen 24h jako liczbę.
Opublikowany kontrakt zawiera teraz przykłady na poziomie typu mediów, jeden wspólny schemat błędu, do którego odwołuje się każda odpowiedź 4xx/5xx, odpowiedzi 401, 429 i 500, które może zwrócić każde wywołanie z kluczem, nagłówki X-RateLimit-* i X-Quota-* w każdej odpowiedzi sukcesu, dostawę alarm.triggered jako callback na POST /webhooks oraz metadane kontaktu, licencji i warunków. Żadne żądanie ani odpowiedź nie uległy zmianie - tylko sposób ich opisu.
Nowość: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), pakiet JSON Schema ze wspólnymi kształtami odpowiedzi, publiczna strona statusu z bliźniaczym JSON-em, ten dziennik zmian oraz polityka wersjonowania i wycofywania.
Serwer MCP przeszedł na własne klucze i plany, tworzone w konsoli MCP. Klucze Data API nie są już akceptowane pod /mcp; każde wywołanie narzędzia nadal kosztuje jedno żądanie.
Serwer MCP Bitculator ruszył pod /mcp: 19 narzędzi tylko do odczytu przez Streamable HTTP dla Claude, Cursor, VS Code i dowolnego klienta MCP, zwracających te same dane w postaci ciągów dziesiętnych co REST API.
Klienty dla TypeScript, Python, PHP, Go, Rust, Java, C# i C++, każdy obejmujący wszystkie endpointy na tym samym rdzeniu transportowym: uwierzytelnianie Bearer, rozpakowywanie koperty, przechwytywanie X-Quota-*, ponawianie przy 429 i 5xx, typowane błędy i stronicowanie.
Niektóre endpointy i dłuższe okna wskaźników wymagają teraz planu Starter lub Pro. Wywołanie spoza Twojego planu zwraca 403 plan_required, a details.required_plan wskazuje plan, który je odblokowuje - i nie zużywa limitu.
Start: 85 operacji w 15 grupach - monety, ceny, rynki, giełdy, portfele, dane globalne, sentyment, wskaźniki, likwidacje, konwersja, kalkulatory, treści redakcyjne, alarmy, webhooki i meta. Klucze Bearer z uprawnieniem data-api, koperta { data, meta }, precyzja ciągów dziesiętnych, nagłówki X-Quota-*, podpisane webhooki oraz plany Free, Starter i Pro z własnym miesięcznym limitem.
Wycofania są ogłaszane tutaj oraz e-mailem do każdego właściciela klucza co najmniej sześć miesięcy przed usunięciem - zobacz politykę wycofywania. Indeks do odczytu maszynowego pod /apis.json niesie datę najnowszego wpisu jako swój znacznik modified.