Changelog
Ogni modifica alla Data API e al suo contratto, dalla più recente. I numeri di versione seguono la politica di versionamento e deprecazione.
/mcp ora accetta la chiave MCP anche come header X-API-Key: YOUR_API_KEY, per i client e i gateway che, come Smithery, riservano l'header Authorization al proprio accesso. Authorization: Bearer continua a funzionare e resta l'opzione predefinita documentata; quando vengono inviati entrambi gli header, viene verificata la chiave di X-API-Key. La Data API su /api/v1 continua ad accettare solo chiavi Bearer. I tentativi di autenticazione falliti ora vengono limitati per chiave oltre che per IP, quindi la chiave non valida di un client non blocca più gli altri client dietro lo stesso indirizzo IP.
GET /calculators/compound-interest arrotondava la durata a periodi di capitalizzazione interi, quindi una durata che terminava a metà periodo veniva simulata troppo lunga o troppo corta: 6 mesi con capitalizzazione annually coprivano un anno intero (12 versamenti e un anno pieno di interessi), mentre 5 mesi non coprivano alcun periodo (nessun versamento, nessun interesse). Ora i periodi interi vengono calcolati come prima, l'ultimo periodo parziale matura interessi pro rata (interesse semplice sulla frazione) e ogni versamento entro la durata viene conteggiato. I risultati restano invariati quando la durata è un numero intero di periodi di capitalizzazione; parametri e campi della risposta restano invariati.
L’API e la sua documentazione trattavano rate come tasso per periodo di capitalizzazione, mentre il calcolatore del sito e la relativa guida usavano un tasso annuo. GET /calculators/compound-interest applicava rate per intero a ogni periodo di capitalizzazione, quindi il 5% con capitalizzazione mensile cresceva come un 5% al mese. rate è ora il tasso nominale annuo: ogni periodo matura rate diviso per il numero di periodi all'anno (il 5% con capitalizzazione mensile matura il 5/12% al mese), come ora indica meta.note. Parametri e campi della risposta non cambiano; i risultati cambiano con tutte le frequenze di capitalizzazione tranne annually. Inoltre, quando contribution_frequency e compound_frequency valgono entrambe daily o entrambe weekly, i depositi non vengono più ritardati né persi a causa degli arrotondamenti in virgola mobile, quindi total_contributions può includere un deposito in più con duration_unit=months. Cambia così il significato di un parametro esistente: per riprodurre i risultati precedenti, moltiplica il tuo rate per il numero di periodi di capitalizzazione all'anno.
Ogni lettura Fear & Greed ora include index accanto a score: l'indice Fear & Greed da 0 a 100 esattamente come mostrato su Bitculator (0–19 paura estrema, 20–39 paura, 40–59 neutrale, 60–79 avidità, 80–100 avidità estrema) — usalo per la visualizzazione. score è invariato: il composito grezzo da −100…+100 da cui deriva index. Vale per GET /sentiment/fear-greed (la lettura principale e ogni voce di intervals), fear_greed su GET /global e meta.fear_greed su GET /global/heatmap. Solo un'aggiunta; nessun campo esistente è cambiato.
GET /coins/{slug} restituiva fully_diluted_valuation come 0 per le monete senza offerta massima (ad esempio Solana ed Ethereum, la cui offerta non ha un tetto). Ora ripiega sull'offerta totale ed è null quando nessuna delle due è nota, come già documentato dal contratto OpenAPI.
marketcap e dominance possono essere null per una coin senza offerta circolante, e lo score e il breakdown del trust score sono null per un exchange non classificato. POST /alarms restituisce 422 quando la coin non ha un valore attuale per la metrica scelta. /coins/recently-added e /wallets/timeline ora rispettano sort. /coins/gainers e /coins/losers sono ordinati in base alla variazione stessa (in precedenza, di fatto, per capitalizzazione di mercato), e i losers escludono le coin a 0.00. Gli ordinamenti crescenti restituiscono i valori null per ultimi. /prices risolve un simbolo ambiguo nella coin attiva con il rank più alto. Il contratto OpenAPI segnala i campi di mercato che possono essere null e tipizza il volume 24h come numero.
Il contratto pubblicato ora include esempi a livello di media type, un unico schema di errore condiviso referenziato da ogni risposta 4xx/5xx, le risposte 401, 429 e 500 che ogni chiamata con chiave può restituire, gli header X-RateLimit-* e X-Quota-* su ogni risposta riuscita, la consegna alarm.triggered come callback su POST /webhooks, e i metadati di contatto, licenza e termini. Nessuna richiesta o risposta è cambiata - solo il modo in cui viene descritta.
Novità: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), un bundle JSON Schema delle forme di risposta condivise, una pagina di stato pubblica con il suo gemello JSON, questo changelog e la politica di versionamento e deprecazione.
Il server MCP è passato a chiavi e piani propri, generati nella console MCP. Le chiavi Data API non sono più accettate su /mcp; ogni chiamata a uno strumento costa comunque una richiesta.
Il server MCP di Bitculator è andato online su /mcp: 19 strumenti in sola lettura su Streamable HTTP per Claude, Cursor, VS Code e qualsiasi client MCP, che restituiscono gli stessi dati a stringhe decimali della REST API.
Client TypeScript, Python, PHP, Go, Rust, Java, C# e C++, ciascuno copre ogni endpoint sullo stesso core di trasporto: autenticazione Bearer, unwrapping dell'envelope, cattura di X-Quota-*, retry su 429 e 5xx, errori tipizzati e paginazione.
Alcuni endpoint e le finestre più lunghe degli indicatori ora richiedono Starter o Pro. Una chiamata fuori dal tuo piano restituisce 403 plan_required con details.required_plan che indica il piano che la sblocca, e non consuma quota.
Lancio: 85 operazioni in 15 gruppi - coin, prezzi, mercati, exchange, wallet, global, sentiment, indicatori, liquidazioni, conversione, calcolatori, editoriale, allarmi, webhook e meta. Chiavi Bearer con l'abilità data-api, l'envelope { data, meta }, precisione a stringhe decimali, header X-Quota-*, webhook firmati e i piani Free, Starter e Pro con la propria quota mensile.
Le deprecazioni vengono annunciate qui e via email a ogni titolare di chiave almeno sei mesi prima della rimozione - vedi la politica di deprecazione. L'indice leggibile dalle macchine su /apis.json riporta la data della voce più recente come marcatura modified.