获取盘口深度

获取交易对完整的深度。 (鉴权类型:NONE, 参见接口权限)

请求格式

GET https://api-cloud.bitmart.com/spot/v1/symbols/book

请求限制

参见 速率限制详细

请求参数

参数 类型 是否必填 描述
symbol String 必填 交易对 symbol
precision String 可选 价格精度, 精度范围在交易对详情里定义
size Int 可选 返回深度数量,值可传[1-200],即买卖深度共[2-400]条

解释说明

  1. precision 是可选的。 如果未传, 默认使用 symbols details 返回的price_max_precision

  2. 当size不传时,返回50条;size传大于200的数时,返回错误提示。

请求示例

curl https://api-cloud.bitmart.com/spot/v1/symbols/book?symbol=BMX_ETH&precision=6

响应详情

字段 类型 描述
timestamp long 当前系统时间(时间戳,精确到毫秒)
buys List 买单深度列表
sells List 卖单深度列表

解释说明

  1. 最多返回 50 条数据。

深度详情描述:

字段 类型 描述
amount string 当前价格深度的总量
total string 当前价格深度之上(包含当前)的总量累加
price string 当前深度的价格
count string 当前价格深度的总订单数

返回数据格式示例

{
  "code": 1000,
  "trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
  "message": "OK",
  "data": {
       "timestamp": 1527777538000,
       "buys":[
          {
             "amount":"4800.00",
             "total":"4800.00",
             "price":"0.000767",
             "count":"1"
          },
          {
             "amount":"99996475.79",
             "total":"100001275.79",
             "price":"0.000201",
             "count":"1"
          },
          ...
       ],
       "sells":[
          {
             "amount":"100.00",
             "total":"100.00",
             "price":"0.007000",
             "count":"1"
          },
          {
             "amount":"6997.00",
             "total":"7097.00",
             "price":"1.000000",
             "count":"1"
          },
          ...
       ]
  }
}

results matching ""

    No results matching ""