Skip to main content

24hr Ticker Price Change Statistics

Type: NONE · Weight: 5 (with or without symbol)

Status: Implemented.

GET /api/v3/ticker/24hr

Rolling 24-hour statistics aggregated from fills. One object when symbol is given, an array of every symbol that traded in the window when it is omitted.

Request

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

Query params

NameTypeRequiredNotes
symbolstringnoOmit for all symbols.

Response — 200 (single symbol; values illustrative)

{
"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
}
FieldTypeNotes
iconUrlstringRocky extension: path of the base asset's icon.
priceChange, priceChangePercentstringlastPrice − openPrice; percent to 3 decimals, "0" when openPrice is 0.
weightedAvgPricestringVWAP over the window, 18 dp.
prevClosePricestringEqual to openPrice (first trade of the window).
bidPrice, bidQty, askPrice, askQtystringAlways "0" — the ticker is built from fills, not the book. Use depth or @depth5.
openTime, closeTimenumberTimestamps of the first and last trade in the window, Unix ms.
firstId, lastIdnumberAlways 0 (trade ids are UUIDs).
countnumberTrades in the window.

No trades in the last 24 h (single-symbol form): every statistic is "0" and count is 0, except lastPrice, which carries the most recent historical trade price so an inactive market still shows a price. openTime and closeTime are the current server time. In the all-symbols form, such markets are simply absent from the array.

Errors

HTTPcodeWhen
429-1003Per-IP public weight exhausted.

Differences from Binance

  • No symbols (plural) parameter and no type=MINI.
  • Bid/ask fields and firstId/lastId are placeholders ("0" / 0).
  • iconUrl is an extra field.
  • Weight is a flat 5 in both forms (Binance charges 80 for the all-symbols form).