获取盘口深度
获取交易对完整的深度。
(鉴权类型: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
响应详情
字段 | 类型 | 描述 |
---|---|---|
buys | List | 买单深度列表 |
sells | List | 卖单深度列表 |
解释说明
- 最多返回 50 条数据。
深度详情描述:
字段 | 类型 | 描述 |
---|---|---|
amount | string | 当前价格深度的总量 |
total | string | 当前价格深度之上(包含当前)的总量累加 |
price | string | 当前深度的价格 |
count | string | 当前价格深度的总订单数 |
返回数据格式示例
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"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"
},
...
]
}
}