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

See Detailed Rate 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

  1. precision is optional. If not passed, the default is to use price_max_precision returned by symbols details.

  2. 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

  1. 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"
          },
          ...
       ]
  }
}

results matching ""

    No results matching ""