Changelog
Každá změna Data API a jeho kontraktu, nejnovější první. Čísla verzí se řídí zásadami verzování a ukončování podpory.
/mcp nyní přijímá MCP klíč také v hlavičce X-API-Key: YOUR_API_KEY, a to pro případy, kdy si klient nebo brána, například Smithery, vyhrazuje hlavičku Authorization pro vlastní přihlášení. Authorization: Bearer funguje dál a zůstává zdokumentovaným výchozím způsobem; pokud jsou odeslány obě hlavičky, ověřuje se klíč z X-API-Key. Data API na /api/v1 nadále přijímá pouze Bearer klíče. Neúspěšné pokusy o autentizaci se nyní omezují nejen podle IP, ale i podle klíče, takže neplatný klíč jednoho klienta už nezablokuje ostatní klienty za stejnou IP adresou.
GET /calculators/compound-interest zaokrouhloval dobu trvání na celá úrokovací období, takže doba končící uprostřed období se simulovala příliš dlouhá nebo příliš krátká: 6 měsíců s úrokováním annually proběhlo jako celý rok (12 vkladů a úrok za celý rok) a 5 měsíců neproběhlo jako žádné období (žádné vklady, žádný úrok). Celá období se nyní počítají jako dříve, poslední neúplné období nese úrok poměrně (jednoduchý úrok za jeho část) a započítá se každý vklad v rámci doby trvání. Pokud doba trvání odpovídá celému počtu úrokovacích období, výsledky se nemění; parametry a pole odpovědi zůstávají beze změny.
API i jeho dokumentace pracovaly s rate jako se sazbou za úrokovací období, zatímco kalkulačka na webu a její návod používaly roční sazbu. GET /calculators/compound-interest uplatňoval rate v plné výši na každé úrokovací období, takže 5 % s měsíčním úročením rostlo jako 5 % za měsíc. rate je nyní roční nominální sazba: každé období připíše rate vydělenou počtem období za rok (5 % s měsíčním úročením znamená 5/12 % za měsíc), jak nyní uvádí meta.note. Parametry ani pole odpovědi se nemění; výsledky se liší u všech frekvencí úročení kromě annually. Nezávisle na této změně: pokud mají contribution_frequency i compound_frequency stejnou hodnotu daily nebo weekly, vklady se už kvůli zaokrouhlování v plovoucí řádové čárce neopožďují ani nevypadávají, takže total_contributions může při duration_unit=months obsahovat o jeden vklad více. Tím se mění význam existujícího parametru: pro zopakování dřívějších výsledků vynásobte rate počtem úrokovacích období za rok.
Každá hodnota Fear & Greed nyní obsahuje index vedle score: index Fear & Greed 0–100 přesně tak, jak jej zobrazuje Bitculator (0–19 extrémní strach, 20–39 strach, 40–59 neutrální, 60–79 chamtivost, 80–100 extrémní chamtivost) — používejte jej k zobrazení. score se nemění: jde o surovou složenou hodnotu −100…+100, ze které se index odvozuje. Týká se GET /sentiment/fear-greed (hlavní hodnota i každá položka v intervals), fear_greed v GET /global a meta.fear_greed v GET /global/heatmap. Pouze doplnění; žádné stávající pole se nezměnilo.
GET /coins/{slug} vracel fully_diluted_valuation jako 0 u coinů bez maximální nabídky (například Solana a Ethereum, jejichž nabídka není omezena). Nyní se použije celková nabídka a hodnota je null, pokud není známa ani jedna, jak už kontrakt OpenAPI dokumentoval.
marketcap a dominance mohou být null u kryptoměny bez oběžné zásoby a score a breakdown skóre důvěry jsou null u burzy bez pořadí. POST /alarms vrací 422, když kryptoměna nemá pro zvolenou metriku aktuální hodnotu. /coins/recently-added a /wallets/timeline nyní respektují sort. /coins/gainers a /coins/losers jsou řazeny podle samotné změny (dříve fakticky podle tržní kapitalizace) a losers vylučují kryptoměny na 0.00. Vzestupné řazení vrací hodnoty null na konci. /prices přiřadí nejednoznačný symbol aktivní kryptoměně s nejvyšším hodnocením. Kontrakt OpenAPI označuje tržní pole, která mohou být null, a typuje 24h objem jako číslo.
Publikovaný kontrakt nyní nese příklady na úrovni media type, jedno sdílené chybové schéma odkazované z každé odpovědi 4xx/5xx, odpovědi 401, 429 a 500, které může vrátit každé volání s klíčem, hlavičky X-RateLimit-* a X-Quota-* u každé úspěšné odpovědi, doručení alarm.triggered jako callback na POST /webhooks a metadata kontaktu, licence a podmínek. Žádný požadavek ani odpověď se nezměnily - jen způsob, jakým jsou popsány.
Nově: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), balík JSON Schema se sdílenými tvary odpovědí, veřejná stavová stránka s JSON dvojčetem, tento changelog a zásady verzování a ukončování podpory.
MCP server přešel na vlastní klíče a plány, vytvářené v MCP konzoli. Klíče Data API se na /mcp už nepřijímají; každé volání nástroje stále stojí jeden požadavek.
MCP server Bitculatoru byl spuštěn na /mcp: 19 nástrojů pouze pro čtení přes Streamable HTTP pro Claude, Cursor, VS Code a jakéhokoli MCP klienta, vracejících stejná data v desetinných řetězcích jako REST API.
Klienti pro TypeScript, Python, PHP, Go, Rust, Javu, C# a C++, každý pokrývá všechny endpointy nad stejným transportním jádrem: Bearer autentizace, rozbalení obálky, zachycení X-Quota-*, opakování při 429 a 5xx, typované chyby a stránkování.
Některé endpointy a delší okna indikátorů nyní vyžadují Starter nebo Pro. Volání mimo váš plán vrátí 403 plan_required s details.required_plan, které jmenuje plán, jenž ho odemyká, a nečerpá kvótu.
Spuštění: 85 operací v 15 skupinách - coiny, ceny, trhy, burzy, peněženky, globální data, sentiment, indikátory, likvidace, převody, kalkulačky, redakční obsah, alarmy, webhooky a meta. Bearer klíče se schopností data-api, obálka { data, meta }, přesnost desetinných řetězců, hlavičky X-Quota-*, podepsané webhooky a plány Free, Starter a Pro, každý s vlastní měsíční kvótou.
Ukončení podpory se oznamuje zde a e-mailem každému majiteli klíče nejméně šest měsíců před odstraněním - viz zásady ukončování podpory. Strojově čitelný index na /apis.json nese datum nejnovějšího záznamu jako svůj údaj modified.