当前仓位

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

接口信息

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

请求参数

无

请求示例

GET /fapi/v1/position/list

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data	array	仓位列表
data[].id	integer	仓位 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	强平价格（全仓=0）
data[].position_value	number	持仓价值 = 开仓均价 × 数量
data[].initial_margin	number	初始保证金 = 持仓价值 / 杠杆
data[].margin	number	保证金
data[].margin_ratio	number	保证金率（%）
data[].unrealized_pnl	number	未实现盈亏（实时）
data[].unrealized_pnl_pct	number	未实现盈亏率（%）
data[].roe	number	回报率 = 未实现盈亏 / 初始保证金 × 100
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,
      "position_value": 6850,
      "initial_margin": 685,
      "margin": 685,
      "margin_ratio": 0.5,
      "unrealized_pnl": 20,
      "unrealized_pnl_pct": 0.29,
      "roe": 2.92,
      "open_fee": 3.425,
      "close_fee": 0,
      "created_at": 1711929600000,
      "updated_at": 1711929900000
    }
  ]
}