跳到主要内容

持仓管理 (Positions)

持仓代表用户在市场中的活期资产风险敞口。

1. 获取所有持仓​

获取当前账户下所有的活跃持仓。

端点: GET /api/v1/positions

返回示例:

{
  "positions": [
    {
      "position_id": "uuid-string",
      "symbol": "BTCUSDT",
      "side": "long",
      "size": "0.5",
      "entry_price": "97000.00",
      "mark_price": "97500.00",
      "liquidation_price": "87500.00",
      "collateral_amount": "5000.00",
      "leverage": 10,
      "unrealized_pnl": "250.00",
      "unrealized_pnl_percent": "5.00",
      "margin_ratio": "0.15",
      "status": "open"
    }
  ],
  "total_unrealized_pnl": "250.00",
  "total_collateral": "5000.00"
}

2. 平仓 (Close Position)​

通过发出相反方向的订单或使用专用平仓接口来关闭仓位。

端点: POST /api/v1/positions/:position_id/close

请求参数:

参数类型说明
amountstring平仓数量
pricestring指定平仓价（null 表示市价平仓）

3. 调整保证金 (Adjust Collateral)​

手动增加或减少仓位保证金，以调整持仓风险（强平价）。

增加保证金​

端点: POST /api/v1/positions/:position_id/collateral/add

减少保证金​

端点: POST /api/v1/positions/:position_id/collateral/remove

请求参数:

{
  "amount": "500.00"
}

4. 止盈止损 (TP/SL)​

设置触发价格，当市场价达到后自动平仓。

设置 TP/SL​

端点: POST /api/v1/positions/:position_id/tp-sl

获取 TP/SL​

端点: GET /api/v1/positions/:position_id/tp-sl