Skip to main content
已暴露为 MCP 工具：crypto_historical_klines —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   每次 1 credit

​
它为 Agent 做什么

crypto_historical_klines 返回单个加密货币交易对的 OHLCV K 线。它是 agent 拿历史价格做收益率、回撤、技术指标、回测的 历史价格 primitive —— 不是用来取最新报价的工具（取最新价用 crypto_snapshot）。 同一个接口支持两种查询模式：传 limit 取最近 N 根已收盘 candle，或者传 start_time + end_time 取一个明确时间窗口。只返回已收盘的 candle，当前未收盘的 bar 永远不在结果里。

​
返回值

​
data
CryptoHistoricalResult
required
​
meta.count
number
本次返回的 bar 数。
​
meta.creditsUsed
number
本次调用消耗的 credit（固定 1）。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · crypto_historical_klines
{
  "data": {
    "ticker": "BTC-USD",
    "interval": "1d",
    "prices": [
      {
        "open": 87000.50,
        "high": 87500.00,
        "low": 86800.00,
        "close": 87200.00,
        "volume": 1234.56,
        "time": "2026-03-01T00:00:00Z"
      },
      {
        "open": 87200.00,
        "high": 88100.00,
        "low": 87000.00,
        "close": 87950.00,
        "volume": 1456.78,
        "time": "2026-03-02T00:00:00Z"
      }
    ]
  },
  "meta": { "count": 2, "creditsUsed": 1, "remainingCredits": 99 }
}

​
说明

要 最新行情（价格 + 24h 涨跌）用 crypto_snapshot，那是另一个 primitive，不需要拉一串 K 线。crypto_historical_klines 只在你需要一系列 bar 时才用。
首次查询某个 ticker + interval + range 可能较慢。同一窗口的后续查询通常更快。
仅现货市场。合约、永续、资金费率、持仓量都不暴露。
不支持分钟级。1m、5m、15m 都不行 —— 只能用 1h、4h、1d、1w。
仅返回已收盘 candle。当前未收盘的 bar 永远不在结果里。

​
直接调用

// Recent 模式 —— 最近 30 根日线
{
  "method": "tools/call",
  "params": {
    "name": "crypto_historical_klines",
    "arguments": { "ticker": "BTC-USD", "interval": "1d", "limit": 30 }
  }
}

// Range 模式 —— 明确时间窗口
{
  "method": "tools/call",
  "params": {
    "name": "crypto_historical_klines",
    "arguments": {
      "ticker": "ETH-USD",
      "interval": "1h",
      "start_time": "2026-03-01T00:00:00Z",
      "end_time": "2026-03-02T00:00:00Z"
    }
  }
}

​
完整参数参考

​
ticker
string
required
交易对，BASE-QUOTE 格式。例：BTC-USD、ETH-USD、SOL-USD。
​
interval
string
required
K 线周期。可选值：1h、4h、1d、1w。不支持分钟级。
只传 limit（或省略走 interval 默认值）。返回最近 N 根已收盘 candle。
​
limit
integer
最近多少根 candle。按 interval 自适应默认：1h = 24，4h = 42，1d = 30，1w = 12。最大 200。

​
相关接口

加密货币实时快照

交易对的当前价格 + 24h 涨跌 —— 只关心”现在”时用这个。

美股历史日线

同样的 Recent / Range 双模式，作用在美股标的（日线）。