Best Book Ticker

Description

Returns the current best order (highest bid, lowest ask).

Method

ticker.book

Request

{
    "id": "51e2affb-0aba-4821-ba75-f2625006eb43",
    "method": "ticker.book",
    "params": {
      "symbol": "BTCUSDT"
    }
}

Weight

2 for a single trading pair, 5 without a trading pair

Request Parameters

Name	Type	Required	Description
symbol	STRING	NO	Trading pair

If no trading pair parameter is sent, information for all trading pairs will be returned. The X-MBX-USED-WEIGHT-1M parameter in the response header is inaccurate and can be ignored.

Response Example

{
  "id": "9d32157c-a556-4d27-9866-66760a174b57",
  "status": 200,
  "result": {
    "lastUpdateId": 1027024,
    "symbol": "BTCUSDT", // Trading pair
    "bidPrice": "4.00000000", // Best bid price
    "bidQty": "431.00000000", // Order quantity
    "askPrice": "4.00000200", // Best ask price
    "askQty": "9.00000000", // Order quantity
    "time": 1589437530011   // Matching engine time
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 2
    }
  ]
}

Or (when symbol is not sent)

{
  "id": "9d32157c-a556-4d27-9866-66760a174b57",
  "status": 200,
  "result": [
	{
      "lastUpdateId": 1027024,
      "symbol": "BTCUSDT", // Trading pair
      "bidPrice": "4.00000000", // Best bid price
      "bidQty": "431.00000000", // Order quantity
      "askPrice": "4.00000200", // Best ask price
      "askQty": "9.00000000", // Order quantity
      "time": 1589437530011   // Matching engine time
    }
 ]
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 2
    }
  ]
}