历史仓位

使用游标分页获取用户已平仓的历史记录，支持按交易对、仓位方向、保证金模式、平仓类型、时间范围过滤。

接口信息

• 方法: GET
• 路径: /fapi/v1/position/history
• 鉴权: 需要签名认证（详见 公共模块 · 签名说明）

请求参数

参数	位置	类型	必填	说明
symbol	query	string	否	交易对
positionSide	query	integer	否	仓位方向：1=做多，2=做空
marginMode	query	integer	否	保证金模式：1=逐仓，2=全仓
closeType	query	integer	否	平仓类型：1=用户平仓，2=止盈，3=止损，4=强平，5=ADL，6=穿仓
startTime	query	integer	否	平仓开始时间（毫秒时间戳）
endTime	query	integer	否	平仓结束时间（毫秒时间戳）
cursor	query	string	否	游标
limit	query	integer	否	每页数量，默认 10，最大 100

请求示例

GET /fapi/v1/position/history?symbol=BTC_USDT&limit=50

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data.limit	integer	每页数量
data.next_cursor	string	下一页游标
data.list	array	历史仓位列表（字段见"仓位详情"）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "limit": 10,
    "next_cursor": "1711929600000",
    "list": [
      {
        "id": 1,
        "position_id": 123,
        "user_id": 100001,
        "symbol": "BTC_USDT",
        "position_side": 1,
        "margin_mode": 1,
        "leverage": 10,
        "open_quantity": 0.1,
        "close_quantity": 0.1,
        "entry_price": 68500,
        "exit_price": 68700,
        "open_amount": 6850,
        "close_amount": 6870,
        "open_fee": 3.425,
        "close_fee": 3.435,
        "total_funding_fee": -0.5,
        "realized_pnl": 20,
        "close_type": 1,
        "opened_at": 1711929600000,
        "closed_at": 1711929700000,
        "created_at": 1711929700000
      }
    ]
  }
}