Get Depth
Get full depth of trading pairs. (Authentication type:NONE, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/spot/v1/symbols/book
Request Limit
Request Parameter
| Field | Type | Required? | Description |
|---|---|---|---|
| symbol | String | Yes | Trading pair symbol |
| precision | String | No | Price precision, the range is defined in trading pair details |
| size | Int | No | Number of results per request. The value can be transmitted [1-200], there are altogether [2-400] buying and selling depths |
Instruction
precision is optional. If not passed, the default is to use
price_max_precisionreturned by symbols details.If the size is left blank, default 50 of data will be returned. If size is larger than '200', error code will be returned.
Request example
curl https://api-cloud.bitmart.com/spot/v1/symbols/book?symbol=BMX_ETH&precision=6
Response Data
| Field | Type | Description |
|---|---|---|
| buys | List | Bid order depth |
| sells | List | Ask order depth |
Instruction
- Return a maximum of 50 pieces of data.
Market depth details：
| Field | Type | Description |
|---|---|---|
| amount | string | Total amount of current price depth |
| total | string | Total accumulation above the current price depth (including current price) |
| price | string | The price at current depth |
| count | string | The number of orders at current depth |
Example of returned data format
{
"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"
},
...
]
}
}