Account Trade History

Type: USER-DATA

GET /fapi/v1/userTrades

Status: Not yet implemented (空缺).

Trade history is not available on the signed /fapi surface. The web-session surface exposes an interim endpoint, documented below.

Interim: `GET /v1/trades/me` (web session)

Auth: Authorization: Bearer <session token> (web session, not the X-MBX-APIKEY signature scheme). No user_id parameter — the user is taken from the session; 401 plain text (missing bearer token) otherwise.

Caller's trade history, newest first.

Request

GET /v1/trades/me?limit=100

Query params

Name	Type	Required	Default	Notes
`limit`	integer	no	`100`	Clamped to `500`. Applied after replaying the full history (up to 20 000 fills).

Response — 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 is the internal form (BTC-PERP). realized_pnl (string or null) is the gross-of-fees PnL reconstructed by average-cost replay for fills that reduced or flipped the position; null for position-increasing fills. Errors are plain text (401 no/invalid session, 500 database failure).

Standard extra fields commissionAsset, marginAsset, orderId, quoteQty, buyer, maker are not yet returned.

Interim: GET /v1/trades/me (web session)​

Interim: `GET /v1/trades/me` (web session)