REST reference / Market data

24-hour statistics

GET/fapi/v1/ticker/24hr
PublicWeight 1

Overview

Local rolling 24-hour statistics, object with symbol or array without

Behavior and request rules

weightedAvgPrice, firstId and lastId are stubbed. Empty local history returns zeros.

Parameters

symbolstringoptional

Listed symbol, for example BTCUSDT. Unlisted symbols return -1121.

Constraints
type
"string"

Responses

Success

One of these shapes

Variant 1 Ticker24
closeTimeintegerrequired
type
"integer"
format
"int64"
countintegerrequired
type
"integer"
format
"int64"
firstIdintegerrequired
type
"integer"
format
"int64"
highPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lastIdintegerrequired
type
"integer"
format
"int64"
lastPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lastQtystringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lowPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
openPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
openTimeintegerrequired
type
"integer"
format
"int64"
priceChangestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
priceChangePercentstringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
quoteVolumestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
symbolstringrequired
type
"string"
volumestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
weightedAvgPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
type
"object"
additionalProperties
false
Variant 2 Ticker24[]
Array items Ticker24
closeTimeintegerrequired
type
"integer"
format
"int64"
countintegerrequired
type
"integer"
format
"int64"
firstIdintegerrequired
type
"integer"
format
"int64"
highPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lastIdintegerrequired
type
"integer"
format
"int64"
lastPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lastQtystringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
lowPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
openPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
openTimeintegerrequired
type
"integer"
format
"int64"
priceChangestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
priceChangePercentstringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
quoteVolumestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
symbolstringrequired
type
"string"
volumestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
weightedAvgPricestringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
type
"object"
additionalProperties
false
type
"array"
Response headers
X-MBX-USED-WEIGHT-1M

Per-IP admitted request weight in the current minute. Requests admitted by the limiter count even if authentication or validation later fails.

Raw response schema
Response schema
{
  "$ref": "#/components/schemas/Ticker24Result"
}
Errors, limits and retry behavior