Registro de cambios
Todos los cambios de la Data API y de su contrato, primero los más recientes. Los números de versión siguen la política de versionado y obsolescencia.
/mcp ahora también acepta la clave MCP como cabecera X-API-Key: YOUR_API_KEY, para clientes y pasarelas que, como Smithery, reservan la cabecera Authorization para su propio inicio de sesión. Authorization: Bearer sigue funcionando y se mantiene como la opción predeterminada documentada; cuando se envían ambas cabeceras, se comprueba la clave de X-API-Key. La Data API en /api/v1 continúa aceptando solo claves Bearer. Los intentos de autenticación fallidos ahora se limitan tanto por clave como por IP, de modo que la clave no válida de un cliente ya no bloquea a otros clientes detrás de la misma dirección IP.
GET /calculators/compound-interest redondeaba la duración a periodos de capitalización completos, por lo que una duración que terminaba a mitad de un periodo se simulaba demasiado larga o demasiado corta: 6 meses con capitalización annually abarcaban un año completo (12 aportaciones y un año entero de intereses) y 5 meses no abarcaban ningún periodo (ni aportaciones ni intereses). Ahora los periodos completos se calculan como antes, el último periodo parcial genera intereses a prorrata (interés simple sobre la fracción) y se cuenta cada aportación dentro de la duración. Los resultados no cambian cuando la duración es un número entero de periodos de capitalización; los parámetros y los campos de respuesta no cambian.
La API y su documentación trataban rate como la tasa por periodo de capitalización, mientras que la calculadora del sitio web y su guía usaban una tasa anual. GET /calculators/compound-interest aplicaba rate completa a cada periodo de capitalización, de modo que un 5 % con capitalización mensual crecía como un 5 % al mes. rate es ahora la tasa nominal anual: cada periodo genera rate dividida entre el número de periodos por año (un 5 % con capitalización mensual genera un 5/12 % al mes), como indica ahora meta.note. Los parámetros y los campos de la respuesta no cambian; los resultados cambian con todas las frecuencias de capitalización salvo annually. Por otra parte, cuando contribution_frequency y compound_frequency son ambas daily o ambas weekly, los depósitos ya no se retrasan ni se pierden por el redondeo de coma flotante, por lo que total_contributions puede incluir un depósito más con duration_unit=months. Esto cambia el significado de un parámetro existente: para reproducir los resultados anteriores, multiplique su rate por el número de periodos de capitalización por año.
Cada lectura de Fear & Greed incluye ahora index junto a score: el índice Fear & Greed de 0 a 100 exactamente como se muestra en Bitculator (0–19 miedo extremo, 20–39 miedo, 40–59 neutral, 60–79 codicia, 80–100 codicia extrema); úselo para mostrar el valor. score no cambia: es el compuesto bruto de −100…+100 del que se deriva index. Se aplica a GET /sentiment/fear-greed (la lectura principal y cada entrada de intervals), a fear_greed en GET /global y a meta.fear_greed en GET /global/heatmap. Solo se añade; ningún campo existente cambia.
GET /coins/{slug} devolvía fully_diluted_valuation como 0 para monedas sin suministro máximo (por ejemplo Solana y Ethereum, cuyo suministro no tiene límite). Ahora recurre al suministro total y es null cuando no se conoce ninguno, como ya documentaba el contrato OpenAPI.
marketcap y dominance pueden ser null para una moneda sin suministro circulante, y el score y el breakdown del trust score son null para un exchange sin ranking. POST /alarms devuelve 422 cuando la moneda no tiene un valor actual para la métrica elegida. /coins/recently-added y /wallets/timeline ahora respetan sort. /coins/gainers y /coins/losers se ordenan por la propia variación (antes, en la práctica, por capitalización de mercado), y los losers excluyen las monedas en 0.00. Las ordenaciones ascendentes devuelven los valores nulos al final. /prices resuelve un símbolo ambiguo a la moneda activa mejor clasificada. El contrato OpenAPI marca los campos de mercado que admiten null y tipa el volumen 24h como número.
El contrato publicado ahora incluye ejemplos a nivel de media type, un único esquema de error compartido referenciado desde cada respuesta 4xx/5xx, las respuestas 401, 429 y 500 que puede devolver cualquier llamada con clave, las cabeceras X-RateLimit-* y X-Quota-* en cada respuesta correcta, la entrega alarm.triggered como callback de POST /webhooks, y los metadatos de contacto, licencia y términos. Ninguna petición ni respuesta ha cambiado - solo cómo se describen.
Nuevo: /apis.json, /.well-known/api-catalog (RFC 9727), /.well-known/security.txt (RFC 9116), un paquete JSON Schema con las formas de respuesta compartidas, una página de estado pública con su gemelo JSON, este registro de cambios y la política de versionado y obsolescencia.
El servidor MCP pasó a tener sus propias claves y planes, creados en la consola MCP. Las claves de la Data API ya no se aceptan en /mcp; cada llamada a herramienta sigue costando una petición.
El servidor MCP de Bitculator entró en producción en /mcp: 19 herramientas de solo lectura sobre Streamable HTTP para Claude, Cursor, VS Code y cualquier cliente MCP, que devuelven los mismos datos en cadenas decimales que la API REST.
Clientes para TypeScript, Python, PHP, Go, Rust, Java, C# y C++, cada uno cubriendo todos los endpoints sobre el mismo núcleo de transporte: autenticación Bearer, desempaquetado del sobre, captura de X-Quota-*, reintentos ante 429 y 5xx, errores tipados y paginación.
Algunos endpoints y las ventanas de indicadores más largas ahora requieren Starter o Pro. Una llamada fuera de tu plan devuelve 403 plan_required con details.required_plan indicando el plan que la desbloquea, y no consume cuota.
Lanzamiento: 85 operaciones en 15 grupos - coins, precios, mercados, exchanges, wallets, global, sentimiento, indicadores, liquidaciones, conversión, calculadoras, editorial, alarmas, webhooks y meta. Claves Bearer con la habilidad data-api, el sobre { data, meta }, precisión en cadenas decimales, cabeceras X-Quota-*, webhooks firmados y los planes Free, Starter y Pro con su propia cuota mensual.
Cualquier obsolescencia se anuncia aquí y por correo electrónico a cada titular de clave al menos seis meses antes de la eliminación - consulta la política de obsolescencia. El índice legible por máquina en /apis.json lleva la fecha de la entrada más reciente como su marca modified.