Changelog
Každá zmena dátového API a jeho kontraktu, od najnovšej. Čísla verzií sa riadia zásadami verziovania a ukončovania podpory.
/mcp teraz prijíma kľúč MCP aj v hlavičke X-API-Key: YOUR_API_KEY, a to pre prípady, keď si klient alebo brána, napríklad Smithery, vyhradzuje hlavičku Authorization na vlastné prihlasovanie. Authorization: Bearer funguje ďalej a zostáva zdokumentovaným predvoleným spôsobom; ak sa odošlú obe hlavičky, overuje sa kľúč z X-API-Key. Dátové API na /api/v1 naďalej prijíma iba kľúče Bearer. Neúspešné pokusy o autentifikáciu sa teraz obmedzujú nielen podľa IP, ale aj podľa kľúča, takže neplatný kľúč jedného klienta už nezablokuje ostatných klientov za tou istou IP adresou.
GET /calculators/compound-interest zaokrúhľoval dobu trvania na celé úročiace obdobia, takže doba končiaca uprostred obdobia sa simulovala ako príliš dlhá alebo príliš krátka: 6 mesiacov s úročením annually prebehlo ako celý rok (12 vkladov a úrok za celý rok) a 5 mesiacov neprebehlo ako žiadne obdobie (žiadne vklady, žiadny úrok). Celé obdobia sa teraz počítajú ako predtým, posledné neúplné obdobie prináša úrok pomerne (jednoduchý úrok za jeho časť) a započíta sa každý vklad v rámci doby trvania. Ak doba trvania zodpovedá celému počtu úročiacich období, výsledky sa nemenia; parametre a polia odpovede zostávajú bez zmeny.
API aj jeho dokumentácia pracovali s rate ako so sadzbou za úročiace obdobie, zatiaľ čo kalkulačka na webe a jej návod používali ročnú sadzbu. GET /calculators/compound-interest uplatňoval rate v plnej výške na každé úročiace obdobie, takže 5 % pri mesačnom úročení rástlo ako 5 % mesačne. rate je teraz ročná nominálna sadzba: každé obdobie pripíše rate vydelenú počtom období za rok (5 % pri mesačnom úročení znamená 5/12 % mesačne), ako teraz uvádza meta.note. Parametre ani polia odpovede sa nemenia; výsledky sa menia pri všetkých frekvenciách úročenia okrem annually. Nezávisle od tejto zmeny: ak majú contribution_frequency aj compound_frequency rovnakú hodnotu daily alebo weekly, vklady sa už v dôsledku zaokrúhľovania v pohyblivej rádovej čiarke neoneskorujú ani nevypadávajú, takže total_contributions môže pri duration_unit=months obsahovať o jeden vklad viac. Tým sa mení význam existujúceho parametra: ak chcete zopakovať skoršie výsledky, vynásobte rate počtom úročiacich období za rok.
Každá hodnota Fear & Greed teraz obsahuje index vedľa score: index Fear & Greed 0–100 presne tak, ako ho zobrazuje Bitculator (0–19 extrémny strach, 20–39 strach, 40–59 neutrálne, 60–79 chamtivosť, 80–100 extrémna chamtivosť) — používajte ho na zobrazenie. score sa nemení: ide o surovú zloženú hodnotu −100…+100, z ktorej sa index odvodzuje. Týka sa GET /sentiment/fear-greed (hlavná hodnota aj každá položka v intervals), fear_greed v GET /global a meta.fear_greed v GET /global/heatmap. Iba doplnenie; žiadne existujúce pole sa nezmenilo.
GET /coins/{slug} vracal fully_diluted_valuation ako 0 pri coinoch bez maximálnej ponuky (napríklad Solana a Ethereum, ktorých ponuka nie je obmedzená). Teraz sa použije celková ponuka a hodnota je null, ak nie je známa ani jedna, ako už kontrakt OpenAPI dokumentoval.
marketcap a dominance môžu byť null pri kryptomene bez obiehajúcej ponuky a score aj breakdown skóre dôvery sú null pri burze bez poradia. POST /alarms vracia 422, keď kryptomena nemá pre zvolenú metriku aktuálnu hodnotu. /coins/recently-added a /wallets/timeline teraz rešpektujú sort. /coins/gainers a /coins/losers sa zoraďujú podľa samotnej zmeny (predtým fakticky podľa trhovej kapitalizácie) a medzi stratovými sa nezobrazujú kryptomeny so zmenou 0.00. Vzostupné zoradenia vracajú hodnoty null až nakoniec. /prices priradí nejednoznačnému symbolu najvyššie umiestnenú aktívnu kryptomenu. Kontrakt OpenAPI označuje trhové polia, ktoré môžu byť null, a objem za 24 h definuje ako číslo.
Zverejnený kontrakt teraz obsahuje príklady na úrovni typu média, jednu spoločnú chybovú schému, na ktorú odkazuje každá odpoveď 4xx/5xx, odpovede 401, 429 a 500, ktoré môže vrátiť každé volanie s kľúčom, hlavičky X-RateLimit-* a X-Quota-* pri každej úspešnej odpovedi, doručenie alarm.triggered ako callback na POST /webhooks a metadáta o kontakte, licencii a podmienkach. Žiadna požiadavka ani odpoveď sa nezmenila – zmenil sa len ich popis.
Novinky: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), balík JSON Schema so spoločnými tvarmi odpovedí, verejná stránka so stavom a jej dvojča vo formáte JSON, tento changelog a zásady verziovania a ukončovania podpory.
Server MCP prešiel na vlastné kľúče a plány, ktoré sa vydávajú v konzole MCP. Kľúče k dátovému API sa už na /mcp neprijímajú; každé volanie nástroja stále stojí jednu požiadavku.
Server MCP Bitculator bol spustený na /mcp: 19 nástrojov len na čítanie cez Streamable HTTP pre Claude, Cursor, VS Code a ľubovoľného klienta MCP, ktoré vracajú tie isté dáta v podobe desatinných reťazcov ako REST API.
Klienti pre TypeScript, Python, PHP, Go, Rust, Java, C# a C++, každý pokrýva všetky koncové body na rovnakom prenosovom jadre: autentifikácia Bearer, rozbalenie obálky, zachytenie X-Quota-*, opakovania pri 429 a 5xx, typované chyby a stránkovanie.
Niektoré koncové body a dlhšie okná indikátorov teraz vyžadujú plán Starter alebo Pro. Volanie mimo vášho plánu vracia 403 plan_required s details.required_plan, ktoré uvádza plán odomykajúci daný koncový bod, a nespotrebúva kvótu.
Spustenie: 85 operácií v 15 skupinách – kryptomeny, ceny, trhy, burzy, peňaženky, globálne dáta, sentiment, indikátory, likvidácie, prevody, kalkulačky, redakčný obsah, alarmy, webhooky a meta. Kľúče Bearer s oprávnením data-api, obálka { data, meta }, presnosť v podobe desatinných reťazcov, hlavičky X-Quota-*, podpísané webhooky a plány Free, Starter a Pro s vlastnou mesačnou kvótou.
Ukončenia podpory oznamujeme tu a e-mailom každému majiteľovi kľúča aspoň šesť mesiacov pred odstránením – pozrite si zásady ukončovania podpory. Strojovo čitateľný index na /apis.json nesie dátum najnovšieho záznamu ako svoju značku modified.