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）。 用 start_time 和/或 end_time 先过滤候选窗口，再用 limit 和 take_from 决定保留哪一端。返回顺序始终是旧到新。只返回已收盘的 candle，当前未收盘的 bar 永远不在结果里。

​
返回值

​
CryptoHistoricalResult
required
​
number
本次调用消耗的 credit（固定 1）。
​
number
账户剩余 credit。
​
string
仅在候选窗口内的数据多于实际返回条数时出现 —— 也就是结果被 limit 截断了。这句话提示 agent 缩小窗口或把查询拆成多次：More data exists in the requested window than the items returned; narrow the window or split the query to see more.
200 OK · crypto_historical_klines

​
说明

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

​
直接调用

​
完整参数参考

​
string
required
交易对，BASE-QUOTE 格式。例：BTC-USD、ETH-USD、SOL-USD。
​
string
required
K 线周期。可选值：1h、4h、1d、1w。不支持分钟级。
​
string
可选 inclusive 下边界，ISO 8601 UTC（如 2026-03-01T00:00:00Z）。
​
string
可选 inclusive 上边界，ISO 8601 UTC。
​
integer
边界过滤后最多返回多少根 candle。按 interval 自适应默认：1h = 24，4h = 42，1d = 30，1w = 12。最大 200。
​
string
default:"latest"
当过滤后候选超过 limit 时保留哪一端：latest 或 earliest。输出仍按时间正序。
take_from=earliest 需要 start_time。如果同时传两个时间边界，start_time 不能晚于 end_time。

​
相关接口

加密货币实时快照

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

美股历史日线

同样的有界 historical-series 形状，作用在美股标的（日线）。