Get History Transactions

Get history transactions for a futures symbol with advanced filtering options.

HTTP Request

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

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
limit	number	No	Number of trades to return (default: 500, max: 1000)
idLessThan	number	No	Return trades with ID less than this value
startTime	number	No	Start time in milliseconds (Unix timestamp)
endTime	number	No	End time in milliseconds (Unix timestamp)

Request Example

Basic Request

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

Request with Time Range

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

Request with ID Filter

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/fills-history?symbol=BTCUSDT&idLessThan=123456789&limit=500"

Response Parameters

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

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "symbol": "BTCUSDT",
      "tradeId": "123456789",
      "price": "91210.20",
      "size": "0.001",
      "side": "BUY",
      "ts": 1763459280833
    }
  ]
}

Error Codes

Code	Message
40034	symbol does not exist
40034	idLessThan and startTime/endTime cannot be sent together
40034	startTime and endTime must be less than 1 hour
50010	Upstream response invalid