Get Order Fills

Get current order fill records for futures trading.

HTTP Request

GET /api/v1/future/order/fills

Request Parameters

Parameter	Type	Required	Description
limit	number	Yes	Number of records to return
symbol	string	No	Trading pair symbol (e.g., BTCUSDT)
orderId	string	No	Order ID to filter fills
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/fills?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 records 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": "0",
        "cTime": 1763459280000
      }
    ],
    "endId": "1234567889"
  }
}

Error Codes

Code	Message
40001	Order not found
40001	Partial position not found