Get History Orders

Get historical orders including filled and canceled orders with pagination support.

HTTP Request

GET /api/v1/spot/trade/history-orders

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Trading pair symbol (e.g., BTCUSDT)
startTime	string	No	Start time in milliseconds (Unix timestamp)
endTime	string	No	End time in milliseconds (Unix timestamp)
idLessThan	string	No	Get orders with ID less than this value
limit	string	No	Number of records to return (default: 100)
orderId	string	No	Specific order ID to query

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/trade/history-orders?symbol=BTCUSDT&limit=100" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	array	Array of historical orders
> symbol	string	Trading pair symbol
> orderId	string	Order ID
> price	string	Order price
> size	string	Order size
> orderType	string	Order type: "limit" or "market"
> side	string	Order side: "buy" or "sell"
> status	string	Order status: "filled", "canceled", "rejected"
> priceAvg	string	Average filled price
> baseVolume	string	Filled volume in base currency
> quoteVolume	string	Filled volume in quote currency
> cTime	string	Creation time in milliseconds
> uTime	string	Last update time in milliseconds

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "symbol": "BTCUSDT",
      "orderId": "123456789",
      "price": "91000.00",
      "size": "0.001",
      "orderType": "limit",
      "side": "buy",
      "status": "filled",
      "priceAvg": "91000.00",
      "baseVolume": "0.001",
      "quoteVolume": "91.00",
      "cTime": "1763459280833",
      "uTime": "1763459280900"
    },
    {
      "symbol": "ETHUSDT",
      "orderId": "123456788",
      "price": "3500.00",
      "size": "0.1",
      "orderType": "limit",
      "side": "sell",
      "status": "canceled",
      "priceAvg": "0",
      "baseVolume": "0",
      "quoteVolume": "0",
      "cTime": "1763459180833",
      "uTime": "1763459200000"
    }
  ]
}

Error Codes

Code	Message
40002	Unauthorized
40034	symbol does not exist
43000	Invalid symbol format: symbol
50000	System error