Jurnal de modificări
Fiecare modificare a API-ului de date și a contractului său, cele mai noi primele. Numerele de versiune respectă politica de versionare și de retragere din uz.
/mcp acceptă acum cheia MCP și ca antet X-API-Key: YOUR_API_KEY, pentru clienții și gateway-urile care, cum ar fi Smithery, rezervă antetul Authorization pentru propria autentificare. Authorization: Bearer continuă să funcționeze și rămâne varianta implicită documentată; când sunt trimise ambele antete, se verifică cheia din X-API-Key. API-ul de date de la /api/v1 acceptă în continuare doar chei Bearer. Încercările de autentificare eșuate sunt acum limitate atât per cheie, cât și per IP, astfel încât cheia nevalidă a unui client nu mai blochează accesul altor clienți aflați în spatele aceleiași adrese IP.
GET /calculators/compound-interest rotunjea durata la perioade de capitalizare întregi, astfel încât o durată care se încheia la mijlocul unei perioade era simulată prea lungă sau prea scurtă: 6 luni cu capitalizare annually rulau un an întreg (12 depuneri și dobânda pe un an întreg), iar 5 luni nu rulau nicio perioadă (fără depuneri, fără dobândă). Perioadele întregi rulează acum ca înainte, ultima perioadă parțială aduce dobândă proporțional (dobândă simplă pentru fracțiune) și fiecare depunere din cadrul duratei este luată în calcul. Rezultatele rămân neschimbate atunci când durata este un număr întreg de perioade de capitalizare; parametrii și câmpurile răspunsului rămân neschimbate.
API-ul și documentația sa tratau rate ca rata pe perioadă de capitalizare, în timp ce calculatorul de pe site și ghidul său foloseau o rată anuală. GET /calculators/compound-interest aplica rate integral fiecărei perioade de capitalizare, așa că 5% cu capitalizare lunară creștea ca 5% pe lună. rate este acum rata nominală anuală: fiecare perioadă aduce rate împărțită la numărul de perioade pe an (5% cu capitalizare lunară înseamnă 5/12% pe lună), așa cum indică acum meta.note. Parametrii și câmpurile răspunsului nu se schimbă; rezultatele se schimbă pentru toate frecvențele de capitalizare, cu excepția annually. Independent de aceasta, când contribution_frequency și compound_frequency sunt ambele daily sau ambele weekly, depunerile nu mai sunt amânate și nici omise din cauza rotunjirilor în virgulă mobilă, așa că total_contributions poate include o depunere în plus cu duration_unit=months. Aceasta schimbă semnificația unui parametru existent: pentru a reproduce rezultatele anterioare, înmulțiți rate cu numărul de perioade de capitalizare pe an.
Fiecare citire Fear & Greed conține acum index lângă score: indicele Fear & Greed de la 0 la 100 exact așa cum îl afișează Bitculator (0–19 frică extremă, 20–39 frică, 40–59 neutru, 60–79 lăcomie, 80–100 lăcomie extremă) — folosiți-l pentru afișare. Câmpul score rămâne neschimbat: valoarea compusă brută de −100…+100 din care este derivat index. Se aplică pentru GET /sentiment/fear-greed (citirea principală și fiecare intrare din intervals), câmpului fear_greed din GET /global și câmpului meta.fear_greed din GET /global/heatmap. Doar o adăugare; niciun câmp existent nu s-a schimbat.
GET /coins/{slug} returna fully_diluted_valuation ca 0 pentru monedele fără ofertă maximă (de exemplu Solana și Ethereum, a căror ofertă nu este plafonată). Acum folosește oferta totală și este null când niciuna nu este cunoscută, așa cum documenta deja contractul OpenAPI.
marketcap și dominance pot fi null pentru o monedă fără ofertă circulantă, iar score și breakdown din scorul de încredere sunt null pentru o bursă neclasificată. POST /alarms returnează 422 atunci când moneda nu are o valoare curentă pentru metrica aleasă. /coins/recently-added și /wallets/timeline respectă acum sort. /coins/gainers și /coins/losers sunt ordonate după variația în sine (anterior, în fapt, după capitalizarea de piață), iar lista scăderilor exclude monedele aflate la 0.00. Sortările crescătoare returnează valorile null la final. /prices rezolvă un simbol ambiguu către cea mai bine clasată monedă activă. Contractul OpenAPI marchează câmpurile de piață care pot fi null și tipizează volumul pe 24h drept număr.
Contractul publicat conține acum exemple la nivel de tip media, o singură schemă de eroare comună, la care trimite fiecare răspuns 4xx/5xx, răspunsurile 401, 429 și 500 pe care le poate returna orice apel cu cheie, antetele X-RateLimit-* și X-Quota-* la fiecare răspuns reușit, livrarea alarm.triggered sub formă de callback pe POST /webhooks, precum și metadate de contact, de licență și de termeni. Nicio cerere și niciun răspuns nu s-au modificat - doar felul în care sunt descrise.
Nou: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), un pachet JSON Schema cu formele comune de răspuns, o pagină de stare publică însoțită de o copie în JSON, acest jurnal de modificări și politica de versionare și de retragere din uz.
Serverul MCP a trecut la chei și abonamente proprii, create în consola MCP. Cheile pentru API-ul de date nu mai sunt acceptate la /mcp; fiecare apel de instrument costă în continuare o cerere.
Serverul MCP Bitculator a intrat în funcțiune la /mcp: 19 instrumente doar pentru citire, peste Streamable HTTP, pentru Claude, Cursor, VS Code și orice client MCP, care returnează aceleași date sub formă de șiruri zecimale ca API-ul REST.
Clienți TypeScript, Python, PHP, Go, Rust, Java, C# și C++, fiecare acoperind toate endpointurile pe același nucleu de transport: autentificare Bearer, despachetarea structurii, captarea X-Quota-*, reîncercări la 429 și 5xx, erori tipizate și paginare.
Unele endpointuri și ferestrele mai lungi ale indicatorilor necesită acum Starter sau Pro. Un apel în afara abonamentului dumneavoastră returnează 403 plan_required, cu details.required_plan indicând abonamentul care îl deblochează, și nu consumă din cotă.
Lansare: 85 de operațiuni în 15 grupuri - monede, prețuri, piețe, burse, portofele, global, sentiment, indicatori, lichidări, conversie, calculatoare, editorial, alarme, webhookuri și meta. Chei Bearer cu permisiunea data-api, structura { data, meta }, precizie prin șiruri zecimale, antete X-Quota-*, webhookuri semnate și abonamentele Gratuit, Starter și Pro, fiecare cu propria cotă lunară.
Retragerile din uz sunt anunțate aici și prin e-mail către fiecare deținător de cheie cu cel puțin șase luni înainte de eliminare - vedeți politica de retragere din uz. Indexul citibil automat de la /apis.json poartă data celei mai noi intrări drept marcaj modified.