24 小时价格变动统计

类型：NONE · 权重：5（带不带 symbol 都一样）

状态：已实现。

GET /api/v3/ticker/24hr

由成交聚合的滚动 24 小时统计。传入 symbol 时返回单个对象；省略时返回窗口内所有有成交的交易对组成的数组。

请求

GET /api/v3/ticker/24hr?symbol=CBTC-USDCB
GET /api/v3/ticker/24hr

Query 参数

字段	类型	必填	说明
symbol	string	否	省略则返回所有交易对。

响应 — 200（单交易对；值仅为示意）

{
  "symbol": "CBTC-USDCB",
  "iconUrl": "/v1/token-icons/CBTC",
  "priceChange": "150.50",
  "priceChangePercent": "0.251",
  "weightedAvgPrice": "59995.123456789012345678",
  "prevClosePrice": "59850.00",
  "lastPrice": "60000.50",
  "lastQty": "0.0100",
  "bidPrice": "0",
  "bidQty": "0",
  "askPrice": "0",
  "askQty": "0",
  "openPrice": "59850.00",
  "highPrice": "60120.00",
  "lowPrice": "59700.00",
  "volume": "12.3456",
  "quoteVolume": "740610.123456",
  "openTime": 1756513600000,
  "closeTime": 1756599998000,
  "firstId": 0,
  "lastId": 0,
  "count": 421
}

字段	类型	说明
iconUrl	string	Rocky 扩展：基础资产图标的路径。
priceChange、priceChangePercent	string	lastPrice − openPrice；百分比保留 3 位小数，openPrice 为 0 时为 "0"。
weightedAvgPrice	string	窗口内 VWAP，18 位小数。
prevClosePrice	string	等于 openPrice（窗口内第一笔成交）。
bidPrice、bidQty、askPrice、askQty	string	恒为 "0"——ticker 由成交构建，不来自订单簿。请使用 depth 或 @depth5。
openTime、closeTime	number	窗口内第一笔与最后一笔成交的时间戳，Unix 毫秒。
firstId、lastId	number	恒为 0（成交 id 为 UUID）。
count	number	窗口内成交笔数。

最近 24 小时无成交（单交易对形式）：所有统计值均为 "0"、count 为 0，唯 lastPrice 保留最近一笔历史成交价，使不活跃市场仍能显示价格。openTime 与 closeTime 为当前服务器时间。在全交易对形式中，此类市场直接不出现在数组里。

错误

HTTP	code	触发场景
429	-1003	按 IP 的公开权重耗尽。

与 Binance 的差异

• 没有 symbols（复数）参数，也没有 type=MINI。
• 买卖盘字段与 firstId/lastId 为占位值（"0" / 0）。
• iconUrl 为额外字段。
• 两种形式的权重均固定为 5（Binance 对全交易对形式收取 80）。