REST API

价格与成交量

从 K 线到逐笔：市场实际成交的情况，未经任何解读。OHLCV K 线来自单一价格基准；其余数据均在所有交易所间聚合。

#OHLCV K 线

GET/v1/raw/klinesdata_type · raw_klines

GET/v1/raw/klines/{interval}data_type · raw_klines_<interval>

第一个接口提供分钟 K 线，第二个提供多周期 K 线：1m、5m、15m、30m、1h、4h、1d、1w。不在列表中的周期返回 422。

参数	类型	默认值	说明
`symbol`	string	必填	资产。
`limit`	integer	60 · 100	K 线数量，1 到 1000。分钟接口默认 60，多周期接口默认 100。

curl

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

字段	类型	说明
`timestamp`	string	K 线起始时间，ISO 8601。
`open, high, low, close`	float	四个价格。
`volume`	float	总成交量，以基础资产为单位。
`taker_buy`	float	市价买入成交量。
`taker_sell`	float	市价卖出成交量。

#涨跌幅

GET/v1/price-changedata_type · price_change

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

响应

{
  "status": "ok",
  "data_type": "price_change",
  "data": {
    "symbol": "BTCUSDT",
    "price": 71420.83,
    "timestamp": "2026-08-29T11:38:00+00:00",
    "changes": {
      "1m": 0.02, "5m": -0.11, "15m": -0.31, "30m": -0.44,
      "1h": 0.15, "4h": 1.02, "1d": -2.31, "1w": 5.60
    }
  }
}

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

#聚合成交

GET/v1/raw/tradesdata_type · raw_trades

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

字段	类型	说明
`timestamp`	string	对应的秒。
`total_volume`	float	总成交量，各交易所合计。
`trade_count`	integer	成交笔数，各交易所合计。
`taker_buy_vol`	float	市价买入量。
`taker_sell_vol`	float	市价卖出量。

GET/v1/raw/taker-combineddata_type · raw_taker_combined

同样的买卖拆分，但按分钟统计：这是宏观尺度上的方向性压力指标。limit 计的是分钟数，1 到 1000。

#逐笔与大额订单

GET/v1/raw/spot-ticksdata_type · raw_spot_ticks

GET/v1/raw/futures-ticksdata_type · raw_futures_ticks

逐笔成交，每行一笔，所有交易所合并，且不标注来源。limit 取值 1 到 10000。

字段	类型	说明
`timestamp`	string	成交时间戳。
`side`	string	buy 或 sell：流动性吃单方的方向。
`price`	float	成交价。
`quantity`	float	数量，以基础资产为单位。
`usd_value`	float	美元价值。

GET/v1/raw/trades/largedata_type · raw_trades_large

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

参数	类型	默认值	说明
`symbol`	string	必填	资产。
`min_usd`	float	100000	最低金额（美元）。下限为 1000。
`limit`	integer	50	事件数量，1 到 1000。

curl

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

#成交 K 线

GET/v1/tradesdata_type · trades_candle_<tf>

GET/v1/trades/spotdata_type · trades_candle_spot_<tf>

GET/v1/trades/futuredata_type · trades_candle_future_<tf>

基于成交而非价格构建的 K 线：说明有多少订单成交、方向如何、金额多少。始终在所有交易所间聚合，因此 exchange 字段始终为 combined。

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

参数	类型	默认值	说明
`symbol`	string	必填	资产。
`timeframe`	string	必填	1m、5m、15m、30m、1h、4h、1d。缺失或无效：422。
`live`	boolean	false	仅用于最新值接口：返回正在形成的 K 线。
`limit`	integer	100	用于 /history 接口，1 到 1000。这些历史接口不接受带日期的窗口。

curl

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

字段	类型	说明
`bucket`	string	K 线起始时间，ISO 8601。
`exchange`	string	始终为 combined。
`trades_count`	integer	窗口内的成交笔数。
`trades_count_buy / trades_count_sell`	integer	成交笔数的方向拆分。
`trade_count_dom`	integer	买入减卖出，以成交笔数计。
`trades_avg`	float \| null	每笔成交的平均金额（美元）。
`trade_avg_buy / trade_avg_sell`	float \| null	买方与卖方的平均金额。
`trade_volume`	float	总成交额（美元）。
`trade_volume_buy / trade_volume_sell`	float	买入与卖出成交额（美元）。
`volume_delta`	float	买入额减卖出额（美元）。
`trade_rate`	float	每秒成交笔数：笔数除以周期时长，正在形成的 K 线也如此计算，以保持定义一致。
`is_closed`	boolean	仅在正在形成的 K 线上为假。

关于稳定币

/v1/trades 和 /v1/trades/spot 仍有数据，因为稳定币有现货市场。/v1/trades/future 返回空列表。