加密市场数据 API

#面向 AI 智能体与 LLM 的加密市场数据

向接入 BytNode 的 AI 智能体提问：“BTC 过去 24 小时走势如何？”“今天上午 ETH 有大额成交吗？”“给我看 SOL 本周的小时 K 线”：它通过 MCP 工具 get_pair_data 用本数据族作答，无需构造 URL。

{
  "name": "get_pair_data",
  "arguments": {
    "symbol": "BTCUSDT",
    "fields": ["klines", "price_change"],
    "timeframe": "1h",
    "limit": 24
  }
}

• 给 LLM 的提示：K 线以其窗口的起始时间（time，UTC）标注——14:00 的小时 K 线覆盖 14:00 至 15:00——且各行从新到旧排列。
• 给开发者：在构建自己的 AI 智能体？把 /v1/klines/history 暴露为工具（tool calling），模型即可自行获取 K 线；或直接加载 MCP 工具，省去封装。
• 适用环境：Claude、ChatGPT、Cursor 及任何 MCP 客户端，包括支持 MCP 的 AI 智能体框架，如 LangChain 或 n8n。

通过 MCP 服务器指南接入你的 AI 智能体，或用开源的 Agent Skills 教它使用 BytNode。

#OHLCV K 线

两条路由：/v1/klines 返回最近一根已收盘的 K 线（一个对象；加 ?live=1 返回进行中的 K 线，is_closed: false），/v1/klines/history 返回 K 线列表，从新到旧（参数见下）。K 线周期放在 timeframe 中，必填：1m、5m、15m、30m、1h、4h、1d、1w。缺失或不在列表中：422。

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/klines/history?symbol=BTCUSDT&timeframe=1h&limit=100"

#涨跌幅

八个周期的百分比变化，按需计算，分别相对一分钟、五分钟、一小时、一周前的价格。缺少历史的周期为 null，绝不会报错。

{
  "status": "ok",
  "server_time": "2026-10-10T08:51:08.454Z",
  "data_type": "price_change",
  "symbol": "BTCUSDT",
  "data": {
    "time": "2026-10-10T08:50:00.000Z",
    "price": 82818.72,
    "changes_pct": {
      "1m": 0.0201927489674, "5m": 0.0452759586592, "15m": -0.0102140384352,
      "30m": -0.0437873393277, "1h": 0.0500741326695, "4h": 0.18183489701,
      "1d": 0.240522875817, "1w": -2.15235074281
    }
  }
}

这是少数为稳定币提供数据的接口之一：此时会回退使用现货逐笔数据。

#按秒聚合的成交

每秒一行，所有交易所合计。因此 limit 参数计的是秒数，而不是成交笔数。

永续合约按分钟或按 bucket 的同一买卖拆分，即 /v1/cvd/futures/history 的 buy_volume / sell_volume。

#逐笔成交与大额订单

逐笔成交（每笔执行），每行一笔，所有交易所合并，且不标注来源——与 WebSocket 频道 trades.spot 和 trades.futures 中的成交相同，id 也相同。limit 取值 1 到 10000。不带其他参数时返回最新的成交。如需读取某个时间区间，请加上 since_ms、until_ms 和/或 order（asc 或 desc）：每页最多覆盖 15 分钟，响应中带有 next，即下一页的 URL，可直接调用（区间读完时为 null）。按 next 逐页读取，每笔成交恰好返回一次且按顺序。/v1/trades/large 同样适用，/v1/trades-kline/futures/seconds 则按 limit 秒分页。

同一期货数据流，按规模筛选：读盘，找出真正重要的订单。

# The last fifty orders above $250,000
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/trades/large?symbol=BTCUSDT&min_usd=250000&limit=50"

#成交 K 线（trades kline）

基于成交而非价格构建的 K 线（“trades kline”）：有多少订单成交、方向如何、金额多少，始终在所有交易所间聚合。逐笔成交本身见 /v1/trades/spot 和 /v1/trades/futures。

每个接口都有对应的历史：/v1/trades-kline/history、/v1/trades-kline/spot/history、/v1/trades-kline/futures/history。

# The 5-minute trade candle in progress
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=5m&live=1"