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 永远不在结果里。

返回值

CryptoHistoricalResult
required
number
本次调用消耗的 credit(固定 1)。
number
账户剩余 credit。
200 OK · crypto_historical_klines

说明

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

直接调用

完整参数参考

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

相关接口

加密货币实时快照

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

美股历史日线

同样的 Recent / Range 双模式,作用在美股标的(日线)。