跳到主要内容

当前最优挂单

接口描述​

返回当前最优的挂单(最高买单，最低卖单)

方式​

ticker.book

注意： 响应消息不包含RPI订单，其不可见。

请求​

{
    "id": "9d32157c-a556-4d27-9866-66760a174b57",
    "method": "ticker.book",
    "params": {
        "symbol": "BTCUSDT"
    }
}

请求权重​

单交易对2，无交易对5

请求参数​

名称类型是否必需描述
symbolSTRINGNO交易对
  • 不发送交易对参数，则会返回所有交易对信息
  • 该接口返回头中的X-MBX-USED-WEIGHT-1M参数不准确，可以忽略

响应示例​

{
  "id": "9d32157c-a556-4d27-9866-66760a174b57",
  "status": 200,
  "result": {
    "lastUpdateId": 1027024,
    "symbol": "BTCUSDT", // 交易对
    "bidPrice": "4.00000000", //最优买单价
    "bidQty": "431.00000000", //挂单量
    "askPrice": "4.00000200", //最优卖单价
    "askQty": "9.00000000", //挂单量
    "time": 1589437530011   // 撮合引擎时间
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 2
    }
  ]
}

或(当不发送symbol)

{
  "id": "9d32157c-a556-4d27-9866-66760a174b57",
  "status": 200,
  "result": [
	{
      "lastUpdateId": 1027024,
      "symbol": "BTCUSDT", // 交易对
      "bidPrice": "4.00000000", //最优买单价
      "bidQty": "431.00000000", //挂单量
      "askPrice": "4.00000200", //最优卖单价
      "askQty": "9.00000000", //挂单量
      "time": 1589437530011   // 撮合引擎时间
    }
 ]
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "count": 2
    }
  ]
}