Reference

API Changelog for Developers

A selection of notable changes to the contract of the API, newest first; it is not exhaustive. Current contract: v1, OpenAPI version 1.0.2.

#Versioning

The paths are /v1; the contract itself is numbered by info.version (semver, see the Versioning page). Not breaking, and shipped without notice: a new route, a new field in a response, a new optional parameter, a new error.code, a new value in an informative text. Write clients that ignore unknown fields.

Breaking: removing or renaming a route, a field, a parameter or an error.code, changing a unit or the meaning of a field. A breaking change takes effect with a new MAJOR version of the contract, on the day that version is published: info.version says which version is live. The MCP server has its own version (serverInfo.version, and mcp_version on every response), which follows the same rule.

#Changes

Follow this journal with any feed reader: /changelog.xml (RSS, in English).

2026-11-13 · MCP 1.1.0: <code>context</code>, each value in its own history

  • New on the MCP server: context gives, for each series, where its latest value sits in its own recent history: percentile (0-100), z-score, the points compared and the window.
  • Always in get_pair_brief; on get_pair_data, get_options_data and get_market_overview with context=true.
  • The reference history is read by the server: the same window on every plan, no quota.
  • New dry_run and max_quota_cost on every tool that uses quota: an agent can see the cost of a call before making it, and refuse any call above its budget.
  • Additive: nothing changes for a client that does not read context.
  • Documentation fix: get_pair_brief costs two quota requests per pair, plus one (the documentation said about one per pair).

2026-11-07 · Contract 1.0.0, a new starting point

  • The contract restarts at version 1.0.0: previous versions and their archives are withdrawn. Each new version stays archived at /openapi/1.0.0.json and the following ones, listed by /openapi/index.json.
  • Breaking: /v1/eth/gas and /v1/eth/gas/history no longer return safe_gas_price_gwei, propose_gas_price_gwei or fast_gas_price_gwei. Use base_fee_gwei and gas_used_ratio.
  • Ethereum history goes back further: total supply and market cap since 2015-07-30, burnt fees, deflation and gas since the London upgrade (2021-08-05). The supply served from 08/06 to 02/09/2026, wrong at the previous source, is corrected. On older days the supply breakdown (execution_issuance_cumulative, consensus_rewards_cumulative, burnt_fees_cumulative, withdrawn_cumulative) can be null; total_supply is always set.
  • /v1/btc/active-addresses, /v1/btc/nvt and /v1/btc/revenue-per-difficulty are now computed directly from Bitcoin blocks, history included since 2013; their values frozen since 29/10 by an outage of the previous source are replaced.
  • nvt_signal follows the original definition: the day’s market cap divided by the 90-day average of on-chain volume in USD. Its label compares it with its own last 730 days: undervalued (below 25 %), fair (from 25 %), overvalued (from 75 %), bubble (from 95 %).