获取盘口深度
获取交易对完整的深度。 (鉴权类型:NONE, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/spot/v1/symbols/book
请求限制
参见 速率限制详细
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | String | 必填 | 交易对 symbol |
| precision | String | 可选 | 价格精度， 精度范围在交易对详情里定义 |
| size | Int | 可选 | 返回深度数量，值可传[1-200]，即买卖深度共[2-400]条 |
解释说明
precision 是可选的。 如果未传， 默认使用 symbols details 返回的
price_max_precision。当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 | 卖单深度列表 |
解释说明
- 最多返回 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"
},
...
]
}
}