What it does
The API returns historical open, high, low, close and volume candles for a token, in JSON, at daily, 4h or 1h intervals. A token can be specified by its CoinGecko ID, or by a contract address together with a chain name, in which case GeckoTerminal supplies the on-chain data. Each response reports the candles, the token identifier, the interval, the number of days returned and the data source. The default is daily candles over 30 days, with a maximum of 365 days.
It suits technical analysis, backtesting, trend detection and charting. Swap quotes, news and funding rates are handled by other tools in the same catalogue, not by this one.
It is available as an MCP tool and as an HTTP endpoint, with both GET and POST variants. Each call costs $0.005, paid in USDC on Base L2 through the x402 protocol, so no API key or signup is needed. Any x402-aware client can handle the payment flow. Payments are settled through Coinbase CDP, with PayAI as fallback, and the endpoint is also reachable via ATXP.
Limitations and requirements
Each call requires a wallet holding USDC on Base L2 to pay $0.005 through x402; HTTP use requires an x402-aware client. Contract lookups support only base, ethereum, solana, arbitrum, polygon, optimism and bsc. History is limited to 365 days, to 90 days for 4h candles, and to 2 days for 1h candles.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
Token OHLCV History API
Historical OHLCV candles for any token. CoinGecko + GeckoTerminal on-chain. x402.
v1.1.0As shown on registry.modelcontextprotocol.io when we last read it