Skip to content

Query Merged Order Book Depth

Endpoint: /v1/spot/depth_merged

Request Method

GET

Description

Retrieve merged order book depth for a spot trading pair at a specified price aggregation level.

Example

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

Query Parameters

Retrieve merged order book depth for a spot trading pair at a specified price aggregation level.

Query Parameters

Parameter Required Type Example Description
symbol Yes string BTC-USDT Trading pair
depth Yes float 0.0001 Price aggregation level. Supported values: 0.0001, 0.00001, 0.000001

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, sorted by price in ascending order
bids Yes array See example Bid orders, sorted by price in descending order

Ask / Bid Object Fields

Parameter Required Type Example Description
gear Yes string 1 Depth level
price Yes number 6322.22 Price
number Yes number 0.0041 Quantity

Response Example

JSON
{
    "errno": 0,
    "errmsg": "success",
    "result": {
        "symbol": "EOS-USDT",
        "ts": 1499223904680,
        "asks": [
            {
                "gear": "1",
                "price": 6322.22,
                "number": 0.0041
            }
        ],
        "bids": [
            {
                "gear": "1",
                "price": 6322.22,
                "number": 0.0041
            }
        ]
    }
}
JSON
{
    "errno": 10010,
    "errmsg": "failed"
}