当前仓位

获取用户所有活跃的持仓信息（从缓存读取，实时计算盈亏和风险指标）。

接口信息

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

请求参数

无

请求示例

GET /fapi/v1/position/list

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data	array	仓位列表
data[].id	string	仓位 ID
data[].user_id	integer	用户 ID
data[].symbol	string	交易对
data[].position_side	integer	仓位方向：1=做多，2=做空
data[].margin_mode	integer	保证金模式：1=逐仓，2=全仓
data[].leverage	integer	杠杆倍数
data[].quantity	number	持仓数量
data[].entry_price	number	开仓均价
data[].mark_price	number	标记价格（实时）
data[].liquidation_price	number	强平价格
data[].break_even_price	number	盈亏平衡价
data[].maintenance_margin_rate	number	档位维持保证金率
data[].margin	number	保证金（逐仓=该仓位实际保证金，全仓=初始保证金占用）
data[].margin_ratio	number	保证金率
data[].unrealized_pnl	number	未实现盈亏（实时）
data[].realized_pnl	number	累计已实现盈亏
data[].total_funding_fee	number	累计资金费（正=付出，负=收入）
data[].open_fee	number	累计开仓手续费
data[].close_fee	number	累计平仓手续费
data[].created_at	integer	创建时间（毫秒）
data[].updated_at	integer	更新时间（毫秒）

响应示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": "123",
      "user_id": 100001,
      "symbol": "BTC_USDT",
      "position_side": 1,
      "margin_mode": 1,
      "leverage": 10,
      "quantity": 0.1,
      "entry_price": 68500,
      "mark_price": 68700,
      "liquidation_price": 61650,
      "break_even_price": 68520,
      "maintenance_margin_rate": 0.004,
      "margin": 685,
      "margin_ratio": 0.5,
      "unrealized_pnl": 20,
      "realized_pnl": 50,
      "total_funding_fee": -0.5,
      "open_fee": 3.425,
      "close_fee": 0,
      "created_at": 1711929600000,
      "updated_at": 1711929900000
    }
  ]
}