My Trades
Get the user's futures trade records using cursor pagination.
API Information
- Method:
GET - Path:
/fapi/v1/myTrades - Authentication: Requires signature authentication (see Common Module · Signature Specification)
Request Parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| symbol | query | string | No | Trading pair filter |
| side | query | integer | No | Side: 1=buy, 2=sell |
| start_time | query | integer | No | Start time (milliseconds timestamp) |
| end_time | query | integer | No | End time (milliseconds timestamp) |
| cursor | query | string | No | Pagination cursor |
| limit | query | integer | No | Page size, default 100 |
Request Example
GET /fapi/v1/myTrades?symbol=BTC_USDT&limit=50
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code |
| message | string | Response message |
| data.has_more | boolean | Whether more records exist |
| data.next_cursor | string | Next page cursor |
| data.items | array | Trade list (same fields as order trades) |
Response Example
{
"code": 0,
"message": "success",
"data": {
"has_more": false,
"next_cursor": "",
"items": [
{
"id": "123456",
"order_id": "789012",
"symbol": "BTC_USDT",
"side": 1,
"position_side": 1,
"price": "68500.00",
"qty": "0.1",
"quote_qty": "6850.00",
"fee": "3.425",
"fee_asset": "USDT",
"fee_rate": "0.0005",
"role": 2,
"is_close": false,
"realized_pnl": "0",
"created_at": 1711929600000
}
]
}
}