Dnevnik promena
Svaka promena Data API-ja i njegovog ugovora, najnovije prvo. Brojevi verzija prate politiku verzionisanja i ukidanja.
/mcp sada prihvata MCP ključ i kao zaglavlje X-API-Key: YOUR_API_KEY, za klijente i mrežne prolaze koji rezervišu Authorization za sopstvenu prijavu, kao što je Smithery. Authorization: Bearer nastavlja da radi i ostaje podrazumevani način opisan u dokumentaciji; kada se pošalju oba zaglavlja, proverava se upravo ključ iz X-API-Key. Data API na /api/v1 i dalje prihvata samo Bearer ključeve. Neuspešni pokušaji autentifikacije se sada ograničavaju ne samo po IP adresi već i po ključu, pa nevažeći ključ jednog klijenta više ne blokira druge klijente iza iste IP adrese.
GET /calculators/compound-interest je zaokruživao trajanje na cele periode kapitalizacije, pa je trajanje koje se završava usred perioda simulirano predugo ili prekratko: 6 meseci uz kapitalizaciju annually trajalo je celu godinu (12 uplata i kamata za celu godinu), a 5 meseci nije činilo nijedan period (bez uplata, bez kamate). Celi periodi se sada računaju kao i ranije, poslednji delimični period donosi kamatu srazmerno (prosta kamata za taj deo), a svaka uplata unutar trajanja se uračunava. Rezultati su nepromenjeni kada je trajanje ceo broj perioda kapitalizacije; parametri i polja odgovora su nepromenjeni.
API i njegova dokumentacija tretirali su rate kao stopu po periodu ukamaćivanja, dok su kalkulator na sajtu i njegovo uputstvo koristili godišnju stopu. GET /calculators/compound-interest je primenjivao ceo rate na svaki period ukamaćivanja, pa je 5% uz mesečno ukamaćivanje raslo kao 5% mesečno. rate je sada nominalna godišnja stopa: svaki period donosi rate podeljenu brojem perioda u godini (5% uz mesečno ukamaćivanje donosi 5/12% mesečno), kao što sada navodi i meta.note. Parametri i polja odgovora se ne menjaju; rezultati se menjaju za sve učestalosti ukamaćivanja osim annually. Nezavisno od toga, kada contribution_frequency i compound_frequency imaju istu vrednost, daily ili weekly, depoziti se više ne odlažu niti izostaju zbog zaokruživanja brojeva u pokretnom zarezu, pa total_contributions uz duration_unit=months može da sadrži jedan depozit više. Ovim se menja značenje postojećeg parametra: da biste reprodukovali ranije rezultate, pomnožite rate brojem perioda kapitalizacije godišnje.
Svako Fear & Greed očitavanje sada sadrži polje index pored polja score: Fear & Greed indeks od 0 do 100 tačno onako kako ga prikazuje Bitculator (0–19 ekstremni strah, 20–39 strah, 40–59 neutralno, 60–79 pohlepa, 80–100 ekstremna pohlepa) — koristite ga za prikaz. Polje score je nepromenjeno: sirova složena vrednost od −100…+100 iz koje se izvodi index. Odnosi se na GET /sentiment/fear-greed (glavno očitavanje i svaku stavku u polju intervals), polje fear_greed u odgovoru GET /global i polje meta.fear_greed u odgovoru GET /global/heatmap. Samo dodatak; nijedno postojeće polje nije promenjeno.
GET /coins/{slug} je vraćao fully_diluted_valuation kao 0 za kriptovalute bez maksimalne ponude (na primer Solana i Ethereum, čija ponuda nije ograničena). Sada se koristi ukupna ponuda, a vrednost je null kada nijedna nije poznata, kako je OpenAPI ugovor već dokumentovao.
marketcap i dominance mogu biti null za kovanicu bez cirkulišuće ponude, a score i breakdown u oceni pouzdanosti su null za berzu bez ranga. POST /alarms vraća 422 kada kovanica nema trenutnu vrednost za izabranu metriku. /coins/recently-added i /wallets/timeline sada poštuju sort. /coins/gainers i /coins/losers sortiraju se po samoj promeni (ranije praktično po tržišnoj kapitalizaciji), a gubitnici isključuju kovanice na 0.00. Rastuća sortiranja vraćaju null vrednosti na kraju. /prices razrešava dvosmislen simbol u najbolje rangiranu aktivnu kovanicu. OpenAPI ugovor označava tržišna polja koja mogu biti null i tipizira promet za 24h kao broj.
Objavljeni ugovor sada nosi primere na nivou medijskog tipa, jednu zajedničku šemu greške na koju se poziva svaki 4xx/5xx odgovor, odgovore 401, 429 i 500 koje može vratiti svaki poziv sa ključem, zaglavlja X-RateLimit-* i X-Quota-* u svakom uspešnom odgovoru, dostavu alarm.triggered kao povratni poziv na POST /webhooks, kao i metapodatke o kontaktu, licenci i uslovima. Nijedan zahtev ni odgovor nije promenjen - promenjen je samo njihov opis.
Novo: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), JSON Schema paket zajedničkih oblika odgovora, javna stranica statusa sa svojim JSON blizancem, ovaj dnevnik promena i politika verzionisanja i ukidanja.
MCP server je prešao na sopstvene ključeve i planove, koji se izdaju u MCP konzoli. Ključevi Data API-ja se više ne prihvataju na /mcp; svaki poziv alatke i dalje troši jedan zahtev.
Bitculator MCP server je pušten u rad na /mcp: 19 alatki samo za čitanje preko Streamable HTTP-a, za Claude, Cursor, VS Code i svaki MCP klijent, koje vraćaju iste podatke u obliku decimalnih stringova kao REST API.
Klijenti za TypeScript, Python, PHP, Go, Rust, Java, C# i C++, svaki pokriva sve krajnje tačke na istom transportnom jezgru: Bearer autentifikacija, raspakivanje omota, hvatanje X-Quota-*, ponovni pokušaji na 429 i 5xx, tipizirane greške i paginacija.
Neke krajnje tačke i duži intervali indikatora sada zahtevaju Starter ili Pro. Poziv izvan vašeg plana vraća 403 plan_required sa details.required_plan, gde je naveden plan koji ga otključava, i ne troši kvotu.
Lansiranje: 85 operacija u 15 grupa - kovanice, cene, tržišta, berze, novčanici, globalni podaci, sentiment, indikatori, likvidacije, konverzija, kalkulatori, uredništvo, alarmi, webhook-ovi i meta. Bearer ključevi sa dozvolom data-api, omot { data, meta }, precizni decimalni stringovi, zaglavlja X-Quota-*, potpisani webhook-ovi i planovi Free, Starter i Pro sa sopstvenom mesečnom kvotom.
Ukidanja se objavljuju ovde i e-poštom svim vlasnicima ključeva najmanje šest meseci pre uklanjanja - pogledajte politiku ukidanja. Mašinski čitljiv indeks na /apis.json nosi datum najnovijeg unosa kao svoju modified oznaku.