获取用户当前状态（clearinghouseState）响应体字段解析

顶层字段

marginSummary (全账户汇总)

crossMarginSummary (全仓模式汇总)

与 marginSummary 类似,但仅统计全仓模式的持仓

其他顶层字段

  • crossMaintenanceMarginUsed: 全仓维持保证金 ($1,478,344.33)

  • withdrawable: 可提现金额 ($3,804,648.64)

  • time: 时间戳 (毫秒)

assetPositions (持仓详情)

每个持仓包含以下字段:

基本信息

  • coin: 交易对代币名称 (如 'BTC', 'ETH')

  • szi: 持仓数量(正数=多头,负数=空头)

    • 例如: BTC 的 -13.10863 表示做空 13.10863 个 BTC

杠杆信息 (leverage)

  • type: 杠杆类型

    • cross: 全仓模式(使用全账户资金)

    • isolated: 逐仓模式(仅使用该持仓的保证金)

  • value: 杠杆倍数 (如 20x, 10x, 5x)

  • rawUsd: (仅逐仓模式)该持仓实际占用的USD

持仓数据

  • entryPx: 开仓均价

  • positionValue: 持仓名义价值 (= |szi| × 当前价格)

  • unrealizedPnl: 未实现盈亏

  • returnOnEquity: 权益回报率 (= unrealizedPnl / marginUsed)

风险管理

  • liquidationPx: 强平价格

    • None 表示当前杠杆下不会被强平

    • 数值表示触及该价格时会被强平

  • marginUsed: 该持仓已使用的保证金

  • maxLeverage: 该交易对最大杠杆倍数

资金费率 (cumFunding)

  • allTime: 历史累计资金费用

  • sinceOpen: 自开仓以来的资金费用

  • sinceChange: 自上次仓位变更以来的资金费用

实例解读

以 BTC 持仓为例:

{
  'coin': 'BTC',
  'szi': '-13.10863',           // 做空 13.10863 个 BTC
  'leverage': {'type': 'cross', 'value': 20},  // 全仓 20x
  'entryPx': '110212.0',        // 开仓价 $110,212
  'positionValue': '1459527.97', // 名义价值约 $145 万
  'unrealizedPnl': '-14798.63',  // 浮亏 $14,798
  'returnOnEquity': '-0.2048',   // 亏损 20.48%
  'liquidationPx': '530308.11',  // BTC 涨到 $530,308 会被强平
  'marginUsed': '72976.40',      // 占用保证金 $72,976
  'maxLeverage': 40              // BTC 最高支持 40x 杠杆
}

关键要点

  1. 正负号含义: szi 为正=多头,为负=空头

  2. 全仓 vs 逐仓: 全仓共享账户资金,逐仓独立保证金

  3. 强平风险: 价格朝不利方向移动到 liquidationPx 时会被强制平仓

  4. 资金费率: 永续合约特有,多空双方定期互相支付的费用