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

By [石小龙](https://paragraph.com/@0x994cd38723375a0eb0d55fcbc1e2a862fd49d007) · 2025-10-24

---

顶层字段
----

### marginSummary (全账户汇总)

*   [**accountValue**: 账户总价值](https://mirror.xyz/0x994CD38723375A0eb0D55fcBc1E2A862Fd49D007/U6mldBvBAleZcsrzwqfYeB0-BQh0BZWmsFOz3yFH8xg)
    
*   [**totalNtlPos**: 所有持仓的名义总价值](https://mirror.xyz/0x994CD38723375A0eb0D55fcBc1E2A862Fd49D007/eq1jeMjJze-8zPBhHgX8SHIIZbCjCAARVbCNt3KcMLw)
    
*   [**totalRawUsd**: 原始USD总值](https://mirror.xyz/0x994CD38723375A0eb0D55fcBc1E2A862Fd49D007/TBsqeaBtp1T7N-CXMC1rpyZs-TiDnHONM948WgABBc8)
    
*   [**totalMarginUsed**: 已使用的保证金总额](https://mirror.xyz/0x994CD38723375A0eb0D55fcBc1E2A862Fd49D007/ilyEAMi83biULZZJ-chMJJaH3uZlVMc1cw6Xfi6Xdgg)
    

### 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.  **资金费率**: 永续合约特有,多空双方定期互相支付的费用

---

*Originally published on [石小龙](https://paragraph.com/@0x994cd38723375a0eb0d55fcbc1e2a862fd49d007/clearinghousestate)*