Hyperliquid中 totalMarginUsed 这个字段的含义

让我详细解释 totalMarginUsed 的计算方法：

totalMarginUsed 的定义

totalMarginUsed = 维持所有当前持仓所需的保证金总额

您的数据:
totalMarginUsed: $3,085,682.44

计算公式

基本公式

totalMarginUsed = Σ(每个持仓的 marginUsed)

单个持仓的 marginUsed 计算

对于全仓模式 (Cross Margin)：

marginUsed = positionValue / leverage

# 或者更精确：
marginUsed = abs(entryPx × szi) / leverage

对于逐仓模式 (Isolated Margin)：

marginUsed = 初始保证金 ± 未实现盈亏 + 缓冲金额

从您的数据验证

让我抽取几个持仓详细计算：

示例 1: BTC (全仓20x)

持仓数据:
- szi: -13.10863
- entryPx: $110,212.0
- leverage: 20x (全仓)
- positionValue: $1,459,527.97
- marginUsed: $72,976.40

计算验证:
marginUsed = positionValue / leverage
          = $1,459,527.97 / 20
          = $72,976.40 ✓ 完全匹配！

示例 2: ETH (全仓20x)

持仓数据:
- szi: -362.4764
- entryPx: $3,891.63
- leverage: 20x
- positionValue: $1,436,203.99
- marginUsed: $71,810.20

计算验证:
marginUsed = $1,436,203.99 / 20
          = $71,810.20 ✓ 匹配！

示例 3: ATOM (全仓5x)

持仓数据:
- szi: 36,132.36
- entryPx: $3.6109
- leverage: 5x
- positionValue: $114,810.57
- marginUsed: $22,962.11

计算验证:
marginUsed = $114,810.57 / 5
          = $22,962.11 ✓ 匹配！

示例 4: CELO (逐仓3x) - 特殊情况

持仓数据:
- leverage: {'type': 'isolated', 'value': 3, 'rawUsd': '13.402335'}
- positionValue: $10.09
- marginUsed: $23.49

计算:
基础保证金 = $10.09 / 3 = $3.36
实际 marginUsed = $23.49

为什么差这么多？
逐仓模式的 marginUsed 包含:
1. 初始保证金: $13.40 (rawUsd)
2. 未实现盈亏: -$0.042
3. 维持保证金缓冲
4. 其他费用累积

完整计算 totalMarginUsed

# 从您的130+个持仓中累加
totalMarginUsed = (
    # 主要持仓
    72976.40      # BTC
    + 71810.20    # ETH  
    + 22962.11    # ATOM
    + 21810.95    # DYDX
    + 22731.04    # SOL
    + 30027.91    # AVAX
    + 21808.89    # BNB
    + 19818.58    # APE
    + ...         # 其余 120+ 个持仓
    + 23.49       # CELO (逐仓)
    + 390.96      # MON (逐仓)
    + 77729.09    # MET (逐仓)
)

= $3,085,682.44

不同杠杆倍数的影响

相同名义价值，不同杠杆的保证金需求:

持仓价值: $100,000

5x 杠杆:  marginUsed = $100,000 / 5  = $20,000
10x 杠杆: marginUsed = $100,000 / 10 = $10,000
20x 杠杆: marginUsed = $100,000 / 20 = $5,000
40x 杠杆: marginUsed = $100,000 / 40 = $2,500

高杠杆 → 低保证金占用 → 高风险！

marginUsed 的组成部分

1. 初始保证金 (Initial Margin)

初始保证金 = positionValue / leverage

例如 BTC:
= $1,459,527.97 / 20
= $72,976.40

2. 维持保证金 (Maintenance Margin)

维持保证金 < 初始保证金

# Hyperliquid 的维持保证金率通常是初始保证金的 50%
维持保证金 ≈ 初始保证金 × 0.5

BTC 维持保证金 ≈ $72,976.40 × 0.5 = $36,488.20

3. 全仓 vs 逐仓的区别

全仓模式：

# 所有全仓持仓共享账户资金
crossMarginSummary.totalMarginUsed: $3,007,538.90

特点:
- 爆仓风险共担
- 一个持仓爆仓可能影响所有持仓
- 资金使用效率高

逐仓模式：

# 每个逐仓持仓独立核算
CELO marginUsed: $23.49
MON marginUsed:  $390.96  
MET marginUsed:  $77,729.09

逐仓总计 ≈ $78,143.54

特点:
- 风险隔离
- 单个持仓爆仓不影响其他
- 资金使用效率较低

验证：

totalMarginUsed = 全仓保证金 + 逐仓保证金
$3,085,682.44 =? $3,007,538.90 + $78,143.54
$3,085,682.44 ≈ $3,085,682.44 ✓

动态变化示例

场景1: 价格波动不改变 marginUsed（全仓）

BTC 持仓 (全仓20x):
初始状态:
- positionValue: $1,459,527.97
- marginUsed: $72,976.40

BTC 价格下跌 5%:
- 新 positionValue: $1,386,551.57
- marginUsed: 仍然 $72,976.40 (不变！)

原因: 全仓模式下，marginUsed 基于初始持仓价值和杠杆
除非调整杠杆或加减仓，否则不会改变

场景2: 逐仓模式下 marginUsed 会变化

MET 持仓 (逐仓3x):
初始状态:
- marginUsed: $77,729.09
- unrealizedPnl: +$3,235.41

价格下跌导致亏损:
- 新 unrealizedPnl: -$5,000
- 新 marginUsed: $77,729.09 + 损失增加

原因: 逐仓需要追加保证金维持持仓

marginUsed vs 其他保证金字段

对比理解:

totalMarginUsed: $3,085,682
├─ 初始保证金需求 (Initial Margin Required)
└─ 实际占用的账户资金

crossMaintenanceMarginUsed: $1,478,344
├─ 维持保证金需求 (Maintenance Margin)
└─ 低于此值会触发强平

关系:
crossMaintenanceMarginUsed < totalMarginUsed
$1,478,344 < $3,085,682 ✓

安全边际:
= totalMarginUsed - maintenanceMargin
= $3,085,682 - $1,478,344
= $1,607,338 (缓冲空间)

实际应用：计算可开仓空间

可用于新开仓的保证金:
= accountValue - totalMarginUsed
= withdrawable
= $3,804,648.64

如果想开 10x 杠杆的新仓:
最大可开仓位价值 = $3,804,648.64 × 10
                 = $38,046,486

如果想开 20x 杠杆:
最大可开仓位价值 = $3,804,648.64 × 20
                 = $76,092,973

Python 计算示例

def calculate_margin_used(position):
    """
    计算单个持仓的 marginUsed
    """
    if position['leverage']['type'] == 'cross':
        # 全仓模式
        margin_used = position['positionValue'] / position['leverage']['value']
    else:
        # 逐仓模式（直接从数据读取，计算复杂）
        margin_used = position['marginUsed']
    
    return margin_used

def calculate_total_margin_used(positions):
    """
    计算所有持仓的总保证金
    """
    total = sum(calculate_margin_used(pos) for pos in positions)
    return total

# 验证
your_positions = [...] # 130+ 个持仓
calculated_total = calculate_total_margin_used(your_positions)
print(f"计算的 totalMarginUsed: ${calculated_total:,.2f}")
print(f"API 返回的 totalMarginUsed: $3,085,682.44")

总结

totalMarginUsed = $3,085,682.44 表示：

定义: 维持所有当前持仓所需的保证金总和

计算方式:

= Σ(每个持仓的 positionValue / leverage)
= $72,976 (BTC) + $71,810 (ETH) + ... (共130+个持仓)

组成:
- 全仓保证金: $3,007,538.90 (98.7%)
- 逐仓保证金: $78,143.54 (1.3%)
关键特征:
- 杠杆越高，marginUsed 越低
- 全仓模式下价格波动不改变 marginUsed
- 代表您实际锁定无法提现的资金

风险指标:

使用率 = totalMarginUsed / accountValue
       = $3,085,682 / $7,117,223
       = 43.4% ← 您的风险使用率

这是管理风险和计算可用保证金的核心指标！

持仓数据: - szi: -13.10863 - entryPx: $110,212.0 - leverage: 20x (全仓) - positionValue: $1,459,527.97 - marginUsed: $72,976.40 计算验证: marginUsed = positionValue / leverage = $1,459,527.97 / 20 = $72,976.40 ✓ 完全匹配！

持仓数据: - szi: -362.4764 - entryPx: $3,891.63 - leverage: 20x - positionValue: $1,436,203.99 - marginUsed: $71,810.20 计算验证: marginUsed = $1,436,203.99 / 20 = $71,810.20 ✓ 匹配！

持仓数据: - szi: 36,132.36 - entryPx: $3.6109 - leverage: 5x - positionValue: $114,810.57 - marginUsed: $22,962.11 计算验证: marginUsed = $114,810.57 / 5 = $22,962.11 ✓ 匹配！

持仓数据: - leverage: {'type': 'isolated', 'value': 3, 'rawUsd': '13.402335'} - positionValue: $10.09 - marginUsed: $23.49 计算: 基础保证金 = $10.09 / 3 = $3.36 实际 marginUsed = $23.49 为什么差这么多？逐仓模式的 marginUsed 包含: 1. 初始保证金: $13.40 (rawUsd) 2. 未实现盈亏: -$0.042 3. 维持保证金缓冲 4. 其他费用累积

# 从您的130+个持仓中累加 totalMarginUsed = ( # 主要持仓 72976.40 # BTC + 71810.20 # ETH + 22962.11 # ATOM + 21810.95 # DYDX + 22731.04 # SOL + 30027.91 # AVAX + 21808.89 # BNB + 19818.58 # APE + ... # 其余 120+ 个持仓 + 23.49 # CELO (逐仓) + 390.96 # MON (逐仓) + 77729.09 # MET (逐仓) ) = $3,085,682.44

相同名义价值，不同杠杆的保证金需求: 持仓价值: $100,000 5x 杠杆: marginUsed = $100,000 / 5 = $20,000 10x 杠杆: marginUsed = $100,000 / 10 = $10,000 20x 杠杆: marginUsed = $100,000 / 20 = $5,000 40x 杠杆: marginUsed = $100,000 / 40 = $2,500 高杠杆 → 低保证金占用 → 高风险！

维持保证金 < 初始保证金 # Hyperliquid 的维持保证金率通常是初始保证金的 50% 维持保证金 ≈ 初始保证金 × 0.5 BTC 维持保证金 ≈ $72,976.40 × 0.5 = $36,488.20

# 每个逐仓持仓独立核算 CELO marginUsed: $23.49 MON marginUsed: $390.96 MET marginUsed: $77,729.09 逐仓总计 ≈ $78,143.54 特点: - 风险隔离 - 单个持仓爆仓不影响其他 - 资金使用效率较低

BTC 持仓 (全仓20x): 初始状态: - positionValue: $1,459,527.97 - marginUsed: $72,976.40 BTC 价格下跌 5%: - 新 positionValue: $1,386,551.57 - marginUsed: 仍然 $72,976.40 (不变！) 原因: 全仓模式下，marginUsed 基于初始持仓价值和杠杆除非调整杠杆或加减仓，否则不会改变

MET 持仓 (逐仓3x): 初始状态: - marginUsed: $77,729.09 - unrealizedPnl: +$3,235.41 价格下跌导致亏损: - 新 unrealizedPnl: -$5,000 - 新 marginUsed: $77,729.09 + 损失增加原因: 逐仓需要追加保证金维持持仓

对比理解: totalMarginUsed: $3,085,682 ├─ 初始保证金需求 (Initial Margin Required) └─ 实际占用的账户资金 crossMaintenanceMarginUsed: $1,478,344 ├─ 维持保证金需求 (Maintenance Margin) └─ 低于此值会触发强平关系: crossMaintenanceMarginUsed < totalMarginUsed $1,478,344 < $3,085,682 ✓ 安全边际: = totalMarginUsed - maintenanceMargin = $3,085,682 - $1,478,344 = $1,607,338 (缓冲空间)

可用于新开仓的保证金: = accountValue - totalMarginUsed = withdrawable = $3,804,648.64 如果想开 10x 杠杆的新仓: 最大可开仓位价值 = $3,804,648.64 × 10 = $38,046,486 如果想开 20x 杠杆: 最大可开仓位价值 = $3,804,648.64 × 20 = $76,092,973

def calculate_margin_used(position): """ 计算单个持仓的 marginUsed """ if position['leverage']['type'] == 'cross': # 全仓模式 margin_used = position['positionValue'] / position['leverage']['value'] else: # 逐仓模式（直接从数据读取，计算复杂） margin_used = position['marginUsed'] return margin_used def calculate_total_margin_used(positions): """ 计算所有持仓的总保证金 """ total = sum(calculate_margin_used(pos) for pos in positions) return total # 验证 your_positions = [...] # 130+ 个持仓 calculated_total = calculate_total_margin_used(your_positions) print(f"计算的 totalMarginUsed: ${calculated_total:,.2f}") print(f"API 返回的 totalMarginUsed: $3,085,682.44")

More from 石小龙

More from 石小龙

No activity yet

石小龙

More from 石小龙

No activity yet

More from 石小龙

Hyperliquid中 totalMarginUsed 这个字段的含义

Hyperliquid中 totalMarginUsed 这个字段的含义

totalMarginUsed 的定义

计算公式

基本公式

单个持仓的 marginUsed 计算

从您的数据验证

示例 1: BTC (全仓20x)

示例 2: ETH (全仓20x)

示例 3: ATOM (全仓5x)

示例 4: CELO (逐仓3x) - 特殊情况

完整计算 totalMarginUsed

不同杠杆倍数的影响

marginUsed 的组成部分

1. 初始保证金 (Initial Margin)

2. 维持保证金 (Maintenance Margin)

3. 全仓 vs 逐仓的区别

验证：

动态变化示例

场景1: 价格波动不改变 marginUsed（全仓）

场景2: 逐仓模式下 marginUsed 会变化

marginUsed vs 其他保证金字段

实际应用：计算可开仓空间

Python 计算示例

总结

totalMarginUsed 的定义

计算公式

基本公式

单个持仓的 marginUsed 计算

从您的数据验证

示例 1: BTC (全仓20x)

示例 2: ETH (全仓20x)

示例 3: ATOM (全仓5x)

示例 4: CELO (逐仓3x) - 特殊情况

完整计算 totalMarginUsed

不同杠杆倍数的影响

marginUsed 的组成部分

1. 初始保证金 (Initial Margin)

2. 维持保证金 (Maintenance Margin)

3. 全仓 vs 逐仓的区别

验证：

动态变化示例

场景1: 价格波动不改变 marginUsed（全仓）

场景2: 逐仓模式下 marginUsed 会变化

marginUsed vs 其他保证金字段

实际应用：计算可开仓空间

Python 计算示例

总结

No activity yet

No activity yet