REST reference / Market data

Order book

GET/fapi/v1/depth

PublicWeight 5

Overview

Local order book snapshot

Parameters

symbolstringrequired

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

Constraints

type: "string"

limitintegeroptional

Only these discrete sizes are accepted.

Constraints

type: "integer"
enum: [5,10,20,50,100,500,1000]
default: 500

Responses

Success

Eintegerrequired

type: "integer"
format: "int64"

Tintegerrequired

type: "integer"
format: "int64"

asksstring[][]required

Array items string[]

Array items string

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: "array"
minItems: 2
maxItems: 2

type: "array"

bidsstring[][]required

Array items string[]

Array items string

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: "array"
minItems: 2
maxItems: 2

type: "array"

lastUpdateIdintegerrequired

type: "integer"
format: "int64"

type: "object"
additionalProperties: false

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

{
  "$ref": "#/components/schemas/Depth"
}

Errors, limits and retry behavior