Skip to content

Query Order Book Depth

Endpoint: /v1/spot/depth

Request Method

GET

Example

Bash
curl -X GET "https://oapi.websea.com/v1/spot/depth?symbol=BTC-USDT&size=150"

Query Parameters

Parameter Required Type Example Description
symbol Yes string BTC-USDT Trading pair
size No int 150 Number of depth levels to retrieve. Range: [1, 1000]

Response Parameters

Parameter Required Type Example Description
errno Yes int 0 Status code
errmsg Yes string success Status message
result Yes object See example Result data

Result Fields

Parameter Required Type Example Description
ts Yes int 1499184000 Data timestamp
symbol Yes string BTC-USDT Trading pair
asks Yes array See example Ask orders, format: [price, amount], sorted by price in ascending order
bids Yes array See example Bid orders, format: [price, amount], sorted by price in descending order

Response Example

JSON
{
    "errno": 0,
    "errmsg": "success",
    "result": {
        "symbol": "EOS-USDT",
        "ts": 1499223904680,
        "bids": [
            [7964, 0.0678],
            [7963, 0.9162],
            [7961, 0.1]
        ],
        "asks": [
            [7979, 0.0736],
            [7980, 1.0292],
            [7981, 5.5652]
        ]
    }
}
JSON
{
    "errno": 10010,
    "errmsg": "failed"
}