Get Trade Fills

Get your trade execution history (fills) with optional filters for symbol, order, and time range.

HTTP Request

GET /api/v1/spot/trade/fills

Request Parameters

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

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/trade/fills?symbol=BTCUSDT&limit=50" \
  -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 trade fills
> symbol	string	Trading pair symbol
> tradeId	string	Trade ID
> orderId	string	Order ID
> orderType	string	Order type: "limit" or "market"
> side	string	Order side: "buy" or "sell"
> priceAvg	string	Average execution price
> size	string	Executed size in base currency
> amount	string	Executed amount in quote currency
> tradeScope	string	Trade role: "taker" or "maker"
> 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",
      "tradeId": "987654321",
      "orderId": "123456789",
      "orderType": "limit",
      "side": "buy",
      "priceAvg": "91000.00",
      "size": "0.001",
      "amount": "91.00",
      "tradeScope": "taker",
      "cTime": "1763459280833",
      "uTime": "1763459280900"
    }
  ]
}

Error Codes

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