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.
POST /webhooks a POST /webhooks/{id}/test nyní sdílejí limit 5 požadavků za minutu na účet, a to navíc k burst limitu plánu. Požadavky nad tento limit dostanou 429 rate_limited s hlavičkou Retry-After. Testovací událost se nyní odešle jen jednou, bez opakování; ostatní doručení se dál zkoušejí nejvýše 3krát, s prodlevou mezi pokusy. Jde o limit proti zneužití, který nemění měsíční kvótu ani burst limit žádného plánu. Zásady verzování a ukončování podpory se změnily týž den, aby takové limity mohly platit okamžitě; do té doby se snížení jakéhokoli rychlostního limitu, který plán měl, řídilo šestiměsíčním harmonogramem ukončování podpory. U těchto dvou endpointů hlavičky X-RateLimit-* uvádějí ten z obou limitů, ve kterém zbývá méně požadavků.
POST /webhooks už nepřekládá název hostitele z URL. Stále vrací 422, pokud URL nepoužívá https, obsahuje přihlašovací údaje nebo má jako hostitele neveřejnou IP adresu. Název hostitele, který nelze přeložit nebo který se překládá na neveřejnou adresu, dosud dostával 422; nyní je přijat s 201 a započítává se do limitu 5 endpointů na účet. Každé doručení na takový endpoint pak selže bez opakování, pole error v GET /webhooks/{id}/deliveries uvádí důvod a 10 neúspěšných doručení po sobě endpoint deaktivuje. Po vytvoření endpointu na něj odešlete testovací událost přes POST /webhooks/{id}/test a v logu doručení ověřte, že je dosažitelný.
endpoints[].endpoint v GET /usage nyní uvádí šablonu routy místo požadované cesty - api/v1/coins/{slug} místo api/v1/coins/bitcoin - takže každý endpoint má jeden řádek místo jednoho za každý slug nebo id. Požadavky zaznamenané dříve v aktuálním fakturačním období si ponechávají svou cestu, proto se do konce období mohou objevit obě podoby.
GET /exchanges/{slug} a GET /exchanges/{slug}/trust-score od spuštění Data API selhávaly u každé burzy s chybou 500. Oba nyní odpovídají; parametry a pole odpovědi zůstávají beze změny a burza bez pořadí vrací score a breakdown jako null.
Publikovaný OpenAPI kontrakt nyní označuje každé pole, které může být null, jako nullable a typuje desetinné hodnoty jako čísla (například invested v GET /calculators/dca a hodnoty indikátorů); společná pole logo, last_updated a stránkovací pole from/to jsou nullable u všech endpointů a stejně tak name a price coinu u všech endpointů se seznamy coinů a cenami. Dále typuje series u DCA jako pole, dokumentuje odpovědi GET /coins/{slug}/markets, GET /coins/losers, GET /global/history/{metric} a GET /sentiment/altseason, dokumentuje days u GET /sentiment/altseason jako 1–365 (hodnota 0 byla vždy odmítnuta; pro aktuální hodnotu parametr vynechte) a v chybovém schématu uvádí kódy endpoint_unavailable (503) a http_error. Žádný požadavek ani odpověď se nezměnily - jen způsob, jakým jsou popsány.
Neúspěšná autentizace byla dříve omezena na 30 pokusů za minutu na IP adresu a poté dostával 429 každý klíč za touto IP adresou. Nyní smí jeden klíč selhat 30krát za minutu z jedné IP adresy a jedna IP adresa 300krát, klíče, které se úspěšně autentizovaly zhruba v posledních 15 minutách, limit pro IP adresu neblokuje a požadavek bez klíče vrátí 401, aniž by se započítal. Blokované požadavky dostanou 429 rate_limited s hlavičkou Retry-After.
Požadavky GET a HEAD, jejichž cesta má koncové lomítko, zdvojené lomítko nebo úvodní /index.php, nyní místo obsloužení dostanou 301 na čistou URL - například z /api/v1/coins/ na /api/v1/coins. Ostatních metod se změna netýká.
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.
Hodnota Fear & Greed, která ještě neměla skóre, se hlásila jako score: 0. Nyní je null v GET /sentiment/fear-greed a stejně tak fear_greed v GET /global a meta.fear_greed v GET /global/heatmap.
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.
Každý přehled v GET /insights, GET /insights/{id} a GET /coins/{slug}/insights nyní nese generated_by: "ai" a model, který ho napsal. Pouze doplnění; žádné stávající pole se nezměnilo.
Burza Huobi byla přejmenována na HTX a její slug se změnil z huobi na htx; API nesleduje přesměrování slugů, takže /exchanges/huobi nyní vrací 404. CoinEx byla nastavena jako neaktivní a už se nevrací.
change_24h a change_7d jsou nyní null, pokud změny coinu nebyly přepočítány 15 minut, místo aby ukazovaly zastaralý pohyb. Od 18. září totéž platí pro change_rank_24h a change_rank_7d.
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.
Volání MCP nástrojů se přestala započítávat do měsíční kvóty a burst limitu plánu Data API; MCP server má od tohoto dne vlastní klíče a plány. tokens[].kind v GET /usage nyní může být mcp a zpráva 429 při překročení kvóty zní „Your Data API plan has reached its monthly request limit.“ (dříve uváděla embed plán).
Vytvoření nebo rotace klíče Data API ve vývojářské konzoli nyní vyžaduje ověřenou e-mailovou adresu; účty bez e-mailu, například přihlášení přes peněženku, jsou výjimkou. Vytváření klíčů je omezeno na 10 za minutu. Stávající klíče fungují dál.
volume_usd v GET /tickers, GET /pairs, GET /pairs/{id}, GET /coins/{slug}/markets a GET /exchanges/{slug}/tickers se ukládal jako celé číslo, takže se ztrácely centy a trhy pod $0,50 ukazovaly 0. Objemy nyní zachovávají dvě desetinná místa a součty z nich sestavené už zaokrouhlení nedědí.
change v GET /coins/{slug}/sparkline a GET /exchanges/{slug}/sparkline byl pro 30d až 365d zlomek (0,05 znamenalo +5 %), ale pro 24h a 7d procento. Nyní je procentem pro každé období (1.25 znamená +1,25 %), takže hodnoty pro delší období jsou 100krát větší než dříve a pohyby pod 0,5 % se už nezaokrouhlují na 0.
U obou endpointů sparkline pocházely low a high ze souhrnu sestaveného nad jiným oknem a mohly odporovat points - například low nad cenami v řadě. Nyní jsou to skutečné extrémy období, ze kterého se points vzorkují.
GET /wallets, /wallets/timeline, /wallets/compare, /wallets/{slug} a /wallets/{slug}/assets nyní vracejí také peněženky se stavem vaporware, takže status může nést tuto hodnotu.
Zdrojové title a excerpt uvnitř přehledů už neobsahují surové HTML entity, jako je í.
U článku, který nikdy nebyl upraven, ukazovalo updated_at v GET /articles a GET /articles/{slug} poslední okamžik, kdy se záznam z jakéhokoli důvodu změnil, například kvůli počtu zobrazení nebo hlasu. Nyní ukazuje poslední redakční úpravu, s návratem k datu publikace, a POST /articles/{slug}/feedback ho už neposouvá.
Přehledy nyní obsahují sentiment: bullish, bearish, sheepish, nebo null, když není klasifikován.
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í.
Endpointy nyní mohou vyžadovat plán. Při zavedení vyžadoval GET /sentiment/indicators plán Pro a GET /sentiment/bull-bear, GET /sentiment/altseason, GET /global, GET /global/heatmap a GET /global/history/{metric} plán Starter. 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.
Šest endpointů /liquidations bylo vypnuto na všech plánech: vracejí 503 endpoint_unavailable („This endpoint is temporarily unavailable.“) a nečerpají kvótu.
Měsíční kvóta plánu Pro klesla z 500 000 na 250 000 požadavků.
Z obecného GET /coins/{slug}/indicators/{family} se stalo 13 samostatně zdokumentovaných endpointů na stejných cestách: rsi, stoch-rsi, sma, cci, mfi, williams-r, price-volatility, volume-volatility, macd, obv, adx, vwap a cmf. Stávající volání se nemění; neznámý název indikátoru nyní dostane prostou 404 bez seznamu platných názvů.
Při spuštění čerpala volání Data API a požadavky embed widgetů z jednoho měsíčního fondu vázaného na embed plán. Data API nyní má vlastní plány Free, Starter a Pro, předplatné a měsíční kvótu s vlastním fakturačním obdobím: na Free je to kalendářní měsíc v UTC, na placených plánech se odvíjí ode dne obnovení. GET /ping a GET /usage hlásí plán Data API a /usage počítá pouze volání Data API. Limity se při rozdělení nezměnily.
Referenční příručka se přesunula z /{locale}/documentation na /{locale}/documentation/api/v1 a kolekce Postman a OpenAPI YAML z /documentation.postman a /documentation.openapi na /documentation/api/v1.postman a /documentation/api/v1.openapi. Staré cesty byly odstraněny bez přesměrování; /api/v1/openapi.json se nemění.
Spuštění: 73 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-* a podepsané webhooky. Volání Data API a požadavky embed widgetů sdílely jednu měsíční kvótu v rámci embed plánu a delší okna indikátorů vyžadovala Starter.
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.