Historical OHLCV candles for any token. CoinGecko + GeckoTerminal on-chain. x402.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Remote HTTPChoose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (6)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Token OHLCV History API.
token_get_ohlcv_historyGet historical OHLCV candles for any token by ID or contract address
tokenCoinGecko token ID (e.g. bitcoin, ethereum, solana). Use this OR contract+chain.
contractOn-chain contract address (e.g. 0x...). Use with chain parameter for GeckoTerminal lookup.
chainBlockchain network for contract lookup: base, ethereum, solana, arbitrum, polygon, optimism, bsc.
daysNumber of days of history (default 30, max 365). For 1h interval max 2 days, for 4h max 90 days.
intervalCandle interval: daily (default), 4h (if days <= 90), 1h (if days <= 2).
Documentation Overview
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.):
Quickstart -- HTTP (x402)
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:
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:
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
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit
22d ago
Most recent push to the default branch.
Tools exposed
6
Callable tools this server registers over MCP.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Token OHLCV History API
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/token-ohlcv-history-api)HTML Embed
<a href="https://allmcps.com/mcp/token-ohlcv-history-api"><img src="https://allmcps.com/api/badge/token-ohlcv-history-api?style=directory" alt="Token OHLCV History API on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
10/14 checks healthy over the last 45d
51Quality signal: Good · 51/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools24/30
Adoption & activity4/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.