Get Fill History

Get historical order fill records for futures trading.

HTTP Request

GET /api/v1/future/order/fill-history

Request Parameters

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

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/order/fill-history?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	object	Fill history data
> fillList	array	Array of fill records
>> symbol	string	Trading pair symbol
>> tradeId	string	Trade ID
>> orderId	string	Order ID
>> tradeType	string	Trade type: "TAKER" or "MAKER"
>> side	string	Order side: "BUY" or "SELL"
>> fee	string	Trading fee
>> price	string	Fill price
>> amount	string	Fill amount
>> profit	string	Realized profit/loss
>> cTime	number	Creation time in milliseconds
> endId	string	Last record ID for pagination

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "fillList": [
      {
        "symbol": "BTCUSDT",
        "tradeId": "1234567890",
        "orderId": "fu-123456789",
        "tradeType": "TAKER",
        "side": "BUY",
        "fee": "2.00",
        "price": "40000.00",
        "amount": "0.5",
        "profit": "250.00",
        "cTime": 1763459280000
      }
    ],
    "endId": "1234567889"
  }
}

Error Codes

No specific errors - returns empty list if no history