Summary
Pulls historical OHLCV (open, high, low, close, volume) candle data for any token through CoinGecko and GeckoTerminal's on-chain feeds. The x402 suffix suggests this runs on a paid tier or premium endpoint at klymax402.com, likely requiring USDC payment for access. Reach for this when you need programmatic access to token price history for backtesting strategies, building charts, or analyzing market movements across both major exchanges and on-chain DEX data. The SSE transport means it streams responses, which works well for large historical datasets. Sparse documentation on GitHub, but the core use case is clear: get candle data without managing multiple API keys or data sources yourself.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
token_get_ohlcv_historyUse this when you need historical price candlestick data for any token. Returns OHLCV candles in JSON. 1. candles: array of candlestick objects with timestamp, open, high, low, close, volume 2. token5 params
Use this when you need historical price candlestick data for any token. Returns OHLCV candles in JSON. 1. candles: array of candlestick objects with timestamp, open, high, low, close, volume 2. token
Parameters* required
chainstringBlockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc.
contractstringOn-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup.
daysnumberNumber of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days.
intervalstringCandle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2).
tokenstringCoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain.
Token OHLCV History API
Historical OHLCV candles for any token -- daily, 4h, 1h intervals. CoinGecko + GeckoTerminal powered. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"token-ohlcv": {
"url": "https://token-ohlcv.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl "https://token-ohlcv.api.klymax402.com/api/candles"
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
token_get_ohlcv_history | GET | /api/candles | $0.005 | Get historical OHLCV candles for any token by ID or contract address |
token_get_ohlcv_history | POST | /api/candles | $0.005 | Get historical OHLCV candles for any token by ID or contract address (POST variant) |
token_get_ohlcv_history
Use this when you need historical price candlestick data for any token. Returns OHLCV candles in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string | no | CoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain. |
contract | string | no | On-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup. |
chain | string | no | Blockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc. |
days | number | no | Number of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days. |
interval | string | no | Candle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2). |
Returns
candles-- array of candlestick objects with timestamp, open, high, low, close, volumetoken-- token identifier usedinterval-- candle interval (daily, 4h, 1h)days-- number of days of history returnedsource-- data source (CoinGecko or GeckoTerminal)
Example response:
{"candles":[{"timestamp":1712966400,"open":3105.20,"high":3142.80,"low":3089.50,"close":3128.60,"volume":1250000000}],"token":"ethereum","interval":"daily","days":30,"source":"CoinGecko"}
When to use: technical analysis, backtesting, trend detection, and charting. Supports 10,000+ tokens by CoinGecko ID or on-chain contract address via GeckoTerminal.
Not for: swap quotes (use dex_get_swap_quote), news (use crypto_get_latest_news), funding rates (use perp_scan_funding_arbitrage).
token_get_ohlcv_history
Use this when you need historical price candlestick data for any token. Returns OHLCV candles in JSON. POST variant of token_get_ohlcv_history -- same params passed as JSON body instead of query string.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string | no | CoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain. |
contract | string | no | On-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup. |
chain | string | no | Blockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc. |
days | number | no | Number of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days. |
interval | string | no | Candle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2). |
Returns
candles-- array of candlestick objects with timestamp, open, high, low, close, volumetoken-- token identifier usedinterval-- candle interval (daily, 4h, 1h)days-- number of days of history returnedsource-- data source (CoinGecko or GeckoTerminal)
Example response:
{"candles":[{"timestamp":1712966400,"open":3105.20,"high":3142.80,"low":3089.50,"close":3128.60,"volume":1250000000}],"token":"ethereum","interval":"daily","days":30,"source":"CoinGecko"}
When to use: technical analysis, backtesting, trend detection, and charting. Supports 10,000+ tokens by CoinGecko ID or on-chain contract address via GeckoTerminal.
Not for: swap quotes (use dex_get_swap_quote), news (use crypto_get_latest_news), funding rates (use perp_scan_funding_arbitrage).
Example agent prompts
- "Historical price candlestick data for any token"
- "Historical price candlestick data for any token"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →