24hr 价格变动情况

类型：NONE

权重：5

GET /fapi/v1/ticker/24hr

24 小时滚动窗口的行情统计 — 一次 SQL 从 ledger.trades 聚合得出。

请求

GET /fapi/v1/ticker/24hr?symbol=BTCUSDT

Query 参数

字段	类型	必填	说明
`symbol`	string	否	标准 pair（如 `BTCUSDT`）。省略则返回所有 symbol 的数组。

响应 — 200（单 symbol 形态，完整标准字段）

{
  "symbol": "BTCUSDT",
  "priceChange": "-876.620000000000000000",
  "priceChangePercent": "-1.134",
  "weightedAvgPrice": "77160.502399075278138997",
  "lastPrice": "76406.000000000000000000",
  "lastQty": "0.000500000000000000",
  "openPrice": "77282.620000000000000000",
  "highPrice": "78238.300000000000000000",
  "lowPrice": "76061.930000000000000000",
  "volume": "6.921000000000000000",
  "quoteVolume": "534027.837104000000000000",
  "openTime": 1779715560680,
  "closeTime": 1779801931721,
  "firstId": 0,
  "lastId": 0,
  "count": 20422
}

省略 symbol 时返回相同结构的数组，每个有成交的 symbol 一行。

字段	说明
`priceChangePercent`	保留 3 位小数；`openPrice` 为零（无成交）时返回 `"0"`。
`weightedAvgPrice`	`SUM(price * qty) / SUM(qty)` 取 18 位小数。
`firstId` / `lastId`	固定 `0` — Rocky 未在该接口暴露单调递增的成交 id。
`openTime` / `closeTime`	24h 窗口内的首笔 / 末笔成交时间。

边界情况： symbol 存在但近 24h 无成交时，单 symbol 形态返回全零对象（数值字段全为 "0"，时间为 now），SDK 无需额外处理空响应。

错误

HTTP	code	msg
`400`	`-1100`	未知 `symbol`。
`500`	`-1000`	数据库错误。

Rocky 也在 Web v1 原生 surface 提供：GET /v1/markets/{symbol}/ticker — 返回 Rocky 形态 {symbol, last_price, mark_price, high_24h, low_24h, open_24h, price_change_pct_24h, volume_24h, open_interest, ts_ms}（含 oracle mark_price，这是标准 /fapi/v1/ticker/24hr 没有的）。