Market Data

Endpoint

Download schema

Order Book

Get current order book. Note that this request returns limited market depth.

If you need to continuously monitor order book updates, please consider using Websocket Market Streams:

<symbol>@depth<levels>
<symbol>@depth

You can use depth request together with <symbol>@depth streams to maintain a local order book.

Note:

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

WSS

depth

wss://ws-fapi.binance.com/ws-fapi/v1

Order Book › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Adjusted based on the limit:

Limit	Weight
5, 10, 20, 50	2
100	5
500	10
1000	20

Order Book › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

depth

Example: depth

object · required

symbol

string · required

Symbol.

Example: BTCUSDT

limit

integer · int64 · max: 1000

Valid limits:[5, 10, 20, 50, 100, 500, 1000]

Example: 10

Default: 500

Order Book › Responses

Successful Response

Order Book

id

string

Example: 51e2affb-0aba-4821-ba75-f2625006eb43

status

integer · int64

Example: 200

object

lastUpdateId

integer · int64

Example: 1027024

E

integer · int64

Message output time

Example: 1589436922972

T

integer · int64

Transaction time

Example: 1589436922959

array[]

Bid orders. Each entry is [price, quantity].

Example: [["4.00000000","431.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000000

[1]

string · required

Quantity

Example: 431.00000000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["4.00000200","12.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000200

[1]

string · required

Quantity

Example: 12.00000000

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 5

WSSdepth

wscat -c wss://ws-fapi.binance.com/ws-fapi/v1 -x '{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "depth",
  "params": {
    "symbol": "BTCUSDT"
  }
}'

Example Request

{
  "id": "e9d6b4349871b40611412680b3445fac",
  "method": "depth",
  "params": {
    "symbol": "BTCUSDT"
  }
}

json

application/json

Example Responses

{
  "id": "51e2affb-0aba-4821-ba75-f2625006eb43",
  "status": 200,
  "result": {
    "lastUpdateId": 1027024,
    "E": 1589436922972,
    "T": 1589436922959
  },
  "bids": [
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",
      "12.00000000"
    ]
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 5
    }
  ]
}

json

application/json

Symbol Order Book Ticker

Best price/qty on the order book for a symbol or symbols.

Note:

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

WSS

ticker.book

wss://ws-fapi.binance.com/ws-fapi/v1

Symbol Order Book Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

2 for a single symbol; 5 when the symbol parameter is omitted

Symbol Order Book Ticker › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

ticker.book

Example: ticker.book

object

symbol

string

Symbol.

Example: BTCUSDT

Symbol Order Book Ticker › Responses

Successful Response

Symbol Order Book Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9d32157c-a556-4d27-9866-66760a174b57

status

integer · int64

Example: 200

object

object[]

Symbol Price Ticker

Latest price for a symbol or symbols.

WSS

ticker.price

wss://ws-fapi.binance.com/ws-fapi/v1

Symbol Price Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 2 when the symbol parameter is omitted

Symbol Price Ticker › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

ticker.price

Example: ticker.price

object

symbol

string

Symbol.

Example: BTCUSDT

Symbol Price Ticker › Responses

Successful Response

Symbol Price Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9d32157c-a556-4d27-9866-66760a174b57

status

integer · int64

Example: 200

object

object[]

Order Book

Get current order book. Note that this request returns limited market depth.

If you need to continuously monitor order book updates, please consider using Websocket Market Streams:

<symbol>@depth<levels>
<symbol>@depth

You can use depth request together with <symbol>@depth streams to maintain a local order book.

Note:

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

WSS

depth

wss://ws-fapi.binance.com/ws-fapi/v1

Order Book › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Adjusted based on the limit:

Limit	Weight
5, 10, 20, 50	2
100	5
500	10
1000	20

Order Book › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

depth

Example: depth

object · required

symbol

string · required

Symbol.

Example: BTCUSDT

limit

integer · int64 · max: 1000

Valid limits:[5, 10, 20, 50, 100, 500, 1000]

Example: 10

Default: 500

Order Book › Responses

Successful Response

Order Book

id

string

Example: 51e2affb-0aba-4821-ba75-f2625006eb43

status

integer · int64

Example: 200

object

lastUpdateId

integer · int64

Example: 1027024

E

integer · int64

Message output time

Example: 1589436922972

T

integer · int64

Transaction time

Example: 1589436922959

array[]

Bid orders. Each entry is [price, quantity].

Example: [["4.00000000","431.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000000

[1]

string · required

Quantity

Example: 431.00000000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["4.00000200","12.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000200

[1]

string · required

Quantity

Example: 12.00000000

object[]

rateLimitType

string

Example: REQUEST_WEIGHT

interval

string

Example: MINUTE

intervalNum

integer · int64

Example: 1

limit

integer · int64

Example: 2400

count

integer · int64

Example: 5

Symbol Order Book Ticker

Best price/qty on the order book for a symbol or symbols.

Note:

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

WSS

ticker.book

wss://ws-fapi.binance.com/ws-fapi/v1

Symbol Order Book Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

2 for a single symbol; 5 when the symbol parameter is omitted

Symbol Order Book Ticker › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

ticker.book

Example: ticker.book

object

symbol

string

Symbol.

Example: BTCUSDT

Symbol Order Book Ticker › Responses

Successful Response

Symbol Order Book Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9d32157c-a556-4d27-9866-66760a174b57

status

integer · int64

Example: 200

object

object[]

Symbol Price Ticker

Latest price for a symbol or symbols.

WSS

ticker.price

wss://ws-fapi.binance.com/ws-fapi/v1

Symbol Price Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 2 when the symbol parameter is omitted

Symbol Price Ticker › Request Parameters

id

string · required

Id.

Example: e9d6b4349871b40611412680b3445fac

method

string · enum · required

WebSocket API method name.

Enum values:

ticker.price

Example: ticker.price

object

symbol

string

Symbol.

Example: BTCUSDT

Symbol Price Ticker › Responses

Successful Response

Symbol Price Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

id

string

Example: 9d32157c-a556-4d27-9866-66760a174b57

status

integer · int64

Example: 200

object

object[]