跳到主要内容

账户成交历史(USER-DATA)

类型：USER-DATA

GET /fapi/v1/userTrades

状态：空缺（暂未实现）。

签名 /fapi 接口上没有成交历史。Web 会话接口提供了一个过渡端点，见下文。

过渡方案：GET /v1/trades/me（Web 会话）​

鉴权： Authorization: Bearer <session token>（Web 会话，而非 X-MBX-APIKEY 签名方案）。没有 user_id 参数——用户来自会话；否则返回 401 纯文本（missing bearer token）。

调用者成交历史，按时间倒序。

请求

GET /v1/trades/me?limit=100

Query 参数

字段类型必填默认值说明
limitinteger否100上限 500。在回放完整历史（最多 20 000 笔成交）后再截取。

响应 — 200

[
  {
    "trade_id": "f1e2d3c4-b5a6-7890-1234-567890abcdef",
    "user_id": "5cfb031b-5936-4467-9533-cd2df576dbb8",
    "symbol": "BTC-PERP",
    "side": "BUY",
    "price": "76521.34",
    "qty": "0.0005",
    "fee": "0.0019",
    "ts": "2026-05-26T08:00:15Z",
    "realized_pnl": null
  }
]

symbol 为内部形式（BTC-PERP）。realized_pnl（字符串或 null）是按平均成本回放重建的、未扣手续费的已实现盈亏，仅对减仓或翻转仓位的成交有值；加仓成交为 null。错误为纯文本（401 无 / 无效会话，500 数据库故障）。

标准的 commissionAsset、marginAsset、orderId、quoteQty、buyer、maker 暂未返回。