我的成交
获取用户的合约成交记录(游标分页)。
接口信息
- 方法:
GET - 路径:
/fapi/v1/myTrades - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| symbol | query | string | 否 | 交易对筛选 |
| side | query | integer | 否 | 方向:1=买,2=卖 |
| start_time | query | integer | 否 | 开始时间(毫秒时间戳) |
| end_time | query | integer | 否 | 结束时间(毫秒时间戳) |
| cursor | query | string | 否 | 分页游标 |
| limit | query | integer | 否 | 每页数量,默认 100 |
请求示例
GET /fapi/v1/myTrades?symbol=BTC_USDT&limit=50
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.has_more | boolean | 是否有更多 |
| data.next_cursor | string | 下一页游标 |
| data.items | array | 成交列表(字段同订单成交) |
响应示例
{
"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
}
]
}
}