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

​
它为 Agent 做什么

crypto_snapshot 返回单个加密货币交易对的当前现货价格 + 24 小时涨跌与成交量。它是 agent 的 价格 checkpoint——任务过程中要验证当前价位、比较资产、或给市场打一个 regime tag 时，不需要拉完整 K 线，调它一次就够。 crypto_snapshot({ ticker }) → price、dayChange、dayChangePercent、volume24h、time。仅此而已。

​
返回值

​
data
CryptoSnapshot
required
​
meta.creditsUsed
number
本次调用消耗的 credit（固定 1）。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · crypto_snapshot
{
  "data": {
    "ticker": "BTC-USD",
    "price": 87200.00,
    "dayChange": 1200.50,
    "dayChangePercent": 1.26,
    "volume24h": 12345678,
    "time": "2026-04-29T12:30:00Z"
  },
  "meta": { "creditsUsed": 1, "remainingCredits": 99 }
}

​
说明

需要历史 K 线用 crypto_historical_klines —— 返回 1h、4h、1d 或 1w 周期的 OHLCV 蜡烛。crypto_snapshot 只关心”现在”。
仅现货市场。合约、永续、资金费率、持仓量都不通过这个工具暴露。
非交易级实时。可能比最新市场成交滞后最多 30 秒，不要拿来交易。

​
直接调用

{
  "method": "tools/call",
  "params": {
    "name": "crypto_snapshot",
    "arguments": { "ticker": "BTC-USD" }
  }
}

​
完整参数参考

​
ticker
string
required
交易对，BASE-QUOTE 格式。例：BTC-USD、ETH-USD、SOL-USD。

​
相关接口

加密货币历史 K 线

1h、4h、1d 或 1w 周期的 OHLCV 蜡烛。

美股价格快照

同样的形态用在美股标的（不同 endpoint）。