Referencia

Registro de cambios para desarrolladores

Una selección de los cambios notables del contrato de la API, de lo más reciente a lo más antiguo; no es exhaustiva. Contrato actual: v1, versión OpenAPI 1.0.2.

#Versiones

Las rutas son /v1; el contrato en sí se numera con info.version (semver, ver la página Versiones). No rompen la compatibilidad, y se publican sin preaviso: una ruta nueva, un campo nuevo en una respuesta, un parámetro opcional nuevo, un error.code nuevo, un valor nuevo en un texto informativo. Escribe clientes que ignoren los campos desconocidos.

Incompatible: eliminar o renombrar una ruta, un campo, un parámetro o un error.code, cambiar una unidad o el significado de un campo. Un cambio incompatible entra en vigor con una nueva versión MAYOR del contrato, el día en que se publica esa versión: info.version indica qué versión está en servicio. El servidor MCP tiene su propia versión (serverInfo.version, y mcp_version en cada respuesta), que sigue la misma regla.

#Cambios

Sigue este registro con cualquier lector de feeds: /changelog.xml (RSS, en inglés).

2026-11-13 · MCP 1.1.0: <code>context</code>, cada valor en su propio historial

  • Nuevo en el servidor MCP: context da, para cada serie, la posición de su último valor en su propio historial reciente: percentil (0-100), z-score, los puntos comparados y la ventana.
  • Siempre en get_pair_brief; en get_pair_data, get_options_data y get_market_overview con context=true.
  • El historial de referencia lo lee el servidor: la misma ventana en todos los planes, sin cuota.
  • Nuevos dry_run y max_quota_cost en cada herramienta que consume cuota: un agente ve el coste de una llamada antes de hacerla y rechaza cualquier llamada por encima de su presupuesto.
  • Solo añade: nada cambia para un cliente que no lee context.
  • Corrección de la documentación: get_pair_brief cuesta dos peticiones de cuota por par, más una (la documentación decía alrededor de una por par).

2026-11-07 · Contrato 1.0.0, un nuevo punto de partida

  • El contrato vuelve a empezar en la versión 1.0.0: las versiones anteriores y sus archivos se retiran. Cada nueva versión queda archivada en /openapi/1.0.0.json y las siguientes, listadas en /openapi/index.json.
  • Incompatible: /v1/eth/gas y /v1/eth/gas/history ya no devuelven safe_gas_price_gwei, propose_gas_price_gwei ni fast_gas_price_gwei. Use base_fee_gwei y gas_used_ratio.
  • El historial de Ethereum llega más atrás: oferta total y capitalización desde el 2015-07-30, ETH quemados, deflación y gas desde la actualización London (2021-08-05). La oferta servida del 08/06 al 02/09/2026, errónea en la fuente anterior, está corregida. En los días antiguos, el desglose de la oferta (execution_issuance_cumulative, consensus_rewards_cumulative, burnt_fees_cumulative, withdrawn_cumulative) puede ser null; total_supply siempre está informado.
  • /v1/btc/active-addresses, /v1/btc/nvt y /v1/btc/revenue-per-difficulty se calculan ahora directamente a partir de los bloques de Bitcoin, historial incluido desde 2013; sus valores congelados desde el 29/10 por una caída de la fuente anterior se sustituyen.
  • nvt_signal sigue la definición original: la capitalización del día dividida por la media de 90 días del volumen on-chain en USD. Su label lo compara con sus propios últimos 730 días: undervalued (menos del 25 %), fair (desde el 25 %), overvalued (desde el 75 %), bubble (desde el 95 %).