Handicap History Orderbook

Query historical orderbook data for a symbol within a time range.

Request URL

GET /deepcoin/market/handicap-orderbook

Request Parameters

Parameter	Type	Required	Description	Example
symbol	String	Yes	Trading symbol	BTC-USDT-SWAP
stime	integer	Yes	Start timestamp (seconds)	1700000000
etime	integer	No	End timestamp (seconds)	1800000000
limit	integer	Yes	Result size, between 1 and 2000	60

Response Parameters

Parameter	Type	Description	Example
etime	integer	Response end timestamp	1700003600
data	Array<Object>	Orderbook snapshot list (unified from upstream dataV2)	...
errmsg	String	Error message (if any)

Response Example

{
  "code": "0",
  "msg": "",
  "data": {
    "etime": 1766758170,
    "data": [
      {
        "timestamp": 1766758170,  // Timestamp
        "buy_order_list": [       // Bid levels: [price, quantity]
          [104600, 43],
          [99999.9, 3],
          [98200.1, 10],
          [98000, 2],
          [96500, 8],
          [96000, 102],
          [95888, 55],
          [95800, 5],
          [95421.9, 3],
          [95000, 207],
          [94888, 165],
          [94800, 37],
          [94777, 21],
          [94700, 112],
          [94500, 1472],
          [94457, 2307],
          [94300, 803],
          [94299.7, 42],
          [94200, 300],
          [94000, 57],
          [93800, 112],
          [93600, 100],
          [93500, 32],
          [93462, 1],
          [93290, 10]
        ],
        "ask_order_list": [       // Ask levels: [price, quantity]
          [1, 1000],
          [8400, 30],
          [26555.9, 99],
          [61800, 56],
          [62000, 92],
          [63000, 1252],
          [63315, 12],
          [63888, 364],
          [64000, 90],
          [64300, 179],
          [64588, 1310],
          [66680.9, 36],
          [70005, 100],
          [71000, 958],
          [72000, 40],
          [72200, 815],
          [73200, 849],
          [73500, 50],
          [74200, 884],
          [74500, 64],
          [74531, 2],
          [74588, 1],
          [75000, 334],
          [75200, 683],
          [75446, 1]
        ]
      }
    ],
    "errmsg": ""
  }
}