Changelog
Todas as alterações na Data API e no seu contrato, as mais recentes primeiro. Os números de versão seguem a política de versionamento e descontinuação.
/mcp agora também aceita a chave MCP como cabeçalho X-API-Key: YOUR_API_KEY, para clientes e gateways que, como o Smithery, reservam o cabeçalho Authorization para o próprio login. Authorization: Bearer segue funcionando e continua sendo o padrão documentado; quando os dois cabeçalhos são enviados, a chave verificada é a do X-API-Key. A Data API em /api/v1 ainda aceita somente chaves Bearer. As tentativas de autenticação malsucedidas agora são limitadas tanto por chave quanto por IP, de modo que a chave inválida de um cliente não bloqueia mais outros clientes atrás do mesmo endereço IP.
GET /calculators/compound-interest arredondava a duração para períodos de capitalização inteiros, pelo que uma duração que terminava a meio de um período era simulada demasiado longa ou demasiado curta: 6 meses com capitalização annually abrangiam um ano inteiro (12 aportes e um ano completo de juros) e 5 meses não abrangiam nenhum período (sem aportes, sem juros). Os períodos inteiros são agora calculados como antes, o último período parcial rende juros pro rata (juros simples sobre a fração) e cada aporte dentro da duração é contado. Os resultados não mudam quando a duração é um número inteiro de períodos de capitalização; os parâmetros e os campos de resposta não mudam.
A API e a sua documentação tratavam rate como a taxa por período de capitalização, enquanto a calculadora do site e o seu guia usavam uma taxa anual. GET /calculators/compound-interest aplicava rate por inteiro a cada período de capitalização, de modo que 5% com capitalização mensal cresciam como 5% ao mês. rate é agora a taxa nominal anual: cada período rende rate dividida pelo número de períodos por ano (5% com capitalização mensal rendem 5/12% ao mês), como meta.note agora indica. Os parâmetros e os campos da resposta não mudam; os resultados mudam em todas as frequências de capitalização, exceto annually. Além disso, quando contribution_frequency e compound_frequency são ambas daily ou ambas weekly, os depósitos deixam de ser atrasados ou perdidos por arredondamentos de vírgula flutuante, pelo que total_contributions pode incluir mais um depósito com duration_unit=months. Isto altera o significado de um parâmetro existente: para reproduzir os resultados anteriores, multiplique o seu rate pelo número de períodos de capitalização por ano.
Cada leitura de Fear & Greed agora inclui index ao lado de score: o índice Fear & Greed de 0 a 100 exatamente como exibido na Bitculator (0–19 medo extremo, 20–39 medo, 40–59 neutro, 60–79 ganância, 80–100 ganância extrema) — use-o para exibição. score não mudou: é o composto bruto de −100…+100 do qual index é derivado. Aplica-se a GET /sentiment/fear-greed (a leitura principal e cada entrada de intervals), a fear_greed em GET /global e a meta.fear_greed em GET /global/heatmap. Apenas uma adição; nenhum campo existente foi alterado.
GET /coins/{slug} retornava fully_diluted_valuation como 0 para moedas sem oferta máxima (por exemplo Solana e Ethereum, cuja oferta não tem teto). Agora recorre à oferta total e é null quando nenhuma é conhecida, como o contrato OpenAPI já documentava.
marketcap e dominance podem ser null para uma moeda sem oferta em circulação, e o score e o breakdown do trust score são null para uma exchange sem ranking. POST /alarms retorna 422 quando a moeda não tem valor atual para a métrica escolhida. /coins/recently-added e /wallets/timeline passam a respeitar sort. /coins/gainers e /coins/losers são ordenados pela própria variação (antes, na prática, pela capitalização de mercado), e os losers excluem as moedas em 0.00. As ordenações ascendentes retornam os valores nulos por último. /prices resolve um símbolo ambíguo para a moeda ativa mais bem classificada. O contrato OpenAPI marca os campos de mercado que podem ser null e tipa o volume 24h como número.
O contrato publicado agora traz exemplos no nível do media type, um único esquema de erro compartilhado referenciado por todas as respostas 4xx/5xx, as respostas 401, 429 e 500 que qualquer chamada com chave pode retornar, os cabeçalhos X-RateLimit-* e X-Quota-* em todas as respostas de sucesso, a entrega alarm.triggered como callback em POST /webhooks, e os metadados de contato, licença e termos. Nenhuma solicitação ou resposta mudou - apenas a forma como são descritas.
Novo: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), um bundle JSON Schema com os formatos de resposta compartilhados, uma página de status pública com sua versão gêmea em JSON, este changelog e a política de versionamento e descontinuação.
O servidor MCP passou a ter suas próprias chaves e planos, criados no console MCP. Chaves da Data API não são mais aceitas em /mcp; cada chamada de ferramenta continua custando uma solicitação.
O servidor MCP da Bitculator entrou no ar em /mcp: 19 ferramentas somente leitura via Streamable HTTP para Claude, Cursor, VS Code e qualquer cliente MCP, retornando os mesmos dados em strings decimais da REST API.
Clientes TypeScript, Python, PHP, Go, Rust, Java, C# e C++, cada um cobrindo todos os endpoints sobre o mesmo núcleo de transporte: autenticação Bearer, desempacotamento do envelope, captura de X-Quota-*, novas tentativas em 429 e 5xx, erros tipados e paginação.
Alguns endpoints e as janelas mais longas de indicadores agora exigem Starter ou Pro. Uma chamada fora do seu plano retorna 403 plan_required com details.required_plan indicando o plano que a desbloqueia, e não consome cota.
Lançamento: 85 operações em 15 grupos - moedas, preços, mercados, exchanges, wallets, global, sentimento, indicadores, liquidações, conversão, calculadoras, editorial, alarmes, webhooks e meta. Chaves Bearer com a capacidade data-api, o envelope { data, meta }, precisão em strings decimais, cabeçalhos X-Quota-*, webhooks assinados e os planos Free, Starter e Pro com sua própria cota mensal.
As descontinuações são anunciadas aqui e por e-mail a todos os titulares de chave pelo menos seis meses antes da remoção - veja a política de descontinuação. O índice legível por máquina em /apis.json traz a data da entrada mais recente como seu carimbo modified.