Get Historical Trades

Get historical market trades for a trading pair with advanced filtering options.

HTTP Request

GET /api/v1/spot/market/fills-history

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
limit	string	No	Number of trades to return (default varies)
fromId	string	No	Trade ID to fetch from (for pagination)
startTime	string	No	Start time in milliseconds
endTime	string	No	End time in milliseconds

Request Example

Basic Request

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/fills-history?symbol=BTCUSDT&limit=100"

Request with Time Range

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/fills-history?symbol=BTCUSDT&startTime=1763400000000&endTime=1763459280833&limit=500"

Request with Pagination

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/fills-history?symbol=BTCUSDT&fromId=123456&limit=100"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	array	Array of trade data
> symbol	string	Trading pair symbol
> tradeId	string	Unique trade ID
> side	string	Trade side (BUY or SELL)
> price	string	Trade execution price
> size	string	Trade quantity
> ts	string	Trade timestamp in milliseconds

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "symbol": "BTCUSDT",
      "tradeId": "123456",
      "side": "BUY",
      "price": "91234.56",
      "size": "0.001",
      "ts": "1763459280833"
    },
    {
      "symbol": "BTCUSDT",
      "tradeId": "123457",
      "side": "SELL",
      "price": "91230.00",
      "size": "0.002",
      "ts": "1763459280500"
    },
    {
      "symbol": "BTCUSDT",
      "tradeId": "123458",
      "side": "BUY",
      "price": "91240.00",
      "size": "0.0015",
      "ts": "1763459280200"
    }
  ]
}

Error Codes

Code	Message
400172	Parameter verification failed
50010	Trade data not available