Get Recent Trades
Get recent market trades for a trading pair.
HTTP Request
GET /api/v1/spot/market/fills
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) |
Request Example
curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/fills?symbol=BTCUSDT&limit=50"
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"
}
]
}
Error Codes
| Code | Message |
|---|---|
| 400172 | Parameter verification failed |
| 50010 | Trade data not available |