Token Ohlcv X402

代币 OHLCV 历史 API

任何代币的历史 OHLCV 蜡烛图——支持日线、4h、1h 时间间隔。由 CoinGecko 和 GeckoTerminal 提供支持。通过 x402 按次付费（Base L2 上的 USDC）——无需 API 密钥、无需注册，也没有速率限制。

这是 klymax402 市场的一部分——为 AI Agent 提供 100 个 x402 微支付 API，一个钱包即可使用 Base 上的 USDC。

快速入门——MCP

添加到 MCP 客户端配置中（Claude Desktop、Cursor、ElizaOS 等）：

{
  "mcpServers": {
    "token-ohlcv": {
      "url": "https://token-ohlcv.api.klymax402.com/mcp"
    }
  }
}

快速入门——HTTP（x402）

curl "https://token-ohlcv.api.klymax402.com/api/candles"
# -> 402 Payment Required, with an x402 payment challenge in the response body

任何兼容 x402 的客户端（@x402/fetch、x402-agent-tools、ATXP）都会自动处理 402 → 签名 → 重试流程。

工具

工具	方法	路径	价格	描述
token_get_ohlcv_history	GET	/api/candles	$0.005	根据 ID 或合约地址获取任何代币的历史 OHLCV 蜡烛图
token_get_ohlcv_history	POST	/api/candles	$0.005	根据 ID 或合约地址获取任何代币的历史 OHLCV 蜡烛图（POST 变体）

token_get_ohlcv_history

需要任何代币的历史价格蜡烛图数据时使用。以 JSON 格式返回 OHLCV 蜡烛图。

参数

名称	类型	必填	描述
token	string	否	CoinGecko 代币 ID（例如 bitcoin、ethereum、solana）。与 contract+chain 二选一。
contract	string	否	链上合约地址（例如 0x...）。与 chain 参数配合使用，以通过 GeckoTerminal 查询。
chain	string	否	用于查询合约的区块链网络：base、ethereum、solana、arbitrum、polygon、optimism、bsc。
days	number	否	历史数据天数（默认 30，最多 365）。1h 时间间隔最多 2 天，4h 时间间隔最多 90 天。
interval	string	否	蜡烛图时间间隔：daily（默认）、4h（days <= 90 时）、1h（days <= 2 时）。

返回值

• candles——蜡烛图对象数组，包含 timestamp、open、high、low、close、volume
• token——使用的代币标识符
• interval——蜡烛图时间间隔（daily、4h、1h）
• days——返回的历史数据天数
• source——数据来源（CoinGecko 或 GeckoTerminal）

响应示例：

{"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"}

适用场景：技术分析、回测、趋势检测和图表绘制。通过 CoinGecko ID 或 GeckoTerminal 链上合约地址，支持 10,000 多种代币。

不适用于：兑换报价（使用 dex_get_swap_quote）、新闻（使用 crypto_get_latest_news）、资金费率（使用 perp_scan_funding_arbitrage）。

token_get_ohlcv_history

当你需要任何代币的历史价格 K 线数据时使用此工具。以 JSON 格式返回 OHLCV K 线。token_get_ohlcv_history 的 POST 变体——传入相同参数，但使用 JSON 请求体，而非查询字符串。

参数

名称	类型	必填	描述
token	string	否	CoinGecko 代币 ID（例如 bitcoin、ethereum、solana）。使用此参数，或使用 contract+chain。
contract	string	否	链上合约地址（例如 0x...）。与 chain 参数搭配使用，以查询 GeckoTerminal。
chain	string	否	用于查询合约的区块链网络：base、ethereum、solana、arbitrum、polygon、optimism、bsc。
days	number	否	历史数据的天数（默认 30，最多 365）。对于 1h 间隔，最多 2 天；对于 4h，最多 90 天。
interval	string	否	K 线间隔：daily（默认）、4h（days <= 90 时）或 1h（days <= 2 时）。

返回内容

• candles -- K 线对象数组，包含时间戳、开盘价、最高价、最低价、收盘价和交易量
• token -- 使用的代币标识符
• interval -- K 线间隔（daily、4h、1h）
• days -- 返回的历史数据天数
• source -- 数据来源（CoinGecko 或 GeckoTerminal）

响应示例：

{"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"}

适用场景：技术分析、回测、趋势检测和绘图。支持通过 CoinGecko ID 或 GeckoTerminal 链上合约地址查询 10,000 多种代币。

不适用于：兑换报价（使用 dex_get_swap_quote）、新闻（使用 crypto_get_latest_news）、资金费率（使用 perp_scan_funding_arbitrage）。

Agent 提示词示例

• “任何代币的历史价格 K 线数据”
• “任何代币的历史价格 K 线数据”

付款

• 协议：x402——原生 HTTP 按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• 支付协调方：Coinbase CDP（主要），PayAI（备用）
• 也可通过 ATXP 访问（采用 OAuth 封装的 x402，受 RFC 9728 保护资源元数据机制保护）

属于 klymax402

面向 AI Agent 的 100 个 x402 微支付 API——一个钱包、Base 上的 USDC、无需注册。

• 目录：https://klymax402.com/llms.txt
• 完整 API 参考：https://klymax402.com/llms-full.txt
• 实时统计：https://klymax402.com/stats

许可证

MIT