Account Summary

Hyperliquid

Streams cross-account balances and margin totals alongside cross and isolated perpetual positions. The initial account snapshot has the same shape as subsequent updates and has no isSnapshot flag.

{
  "method": "subscribe",
  "subscription": {
    "type": "accountSummary",
    "user": "0x1111111111111111111111111111111111111111"
  }
}

Response

{
  "channel": "accountSummary",
  "data": {
    "user": "0x1111111111111111111111111111111111111111",
    "summary": {
      "crossMaintenanceMargin": "500.00",
      "accountBalance": "10000.00",
      "availableMargin": "9050.00",
      "withdrawable": "9000.00",
      "crossMarginSummary": {
        "totalUnrealizedPnL": "50.00",
        "accountValue": "10050.00",
        "totalMargin": "10050.00",
        "crossMarginRatio": "0.0498",
        "portfolioMarginRatio": "0.2500",
        "totalMarginUsed": "1000.00",
        "crossAccountLeverage": "0.50"
      },
      "balances": [
        {
          "asset": "00012710",
          "coin": "USDC",
          "hold": "0",
          "available": "10000.00",
          "segregated": "0",
          "total": "10000.00",
          "liability": {
            "persistedDebt": "0",
            "totalDebt": "0"
          }
        }
      ],
      "assetPositions": [
        {
          "type": "oneWay",
          "position": {
            "coin": "BTC",
            "cumFunding": {
              "allTime": "0",
              "sinceChange": "0",
              "sinceOpen": "0"
            },
            "entryPx": "50000.00",
            "leverage": {
              "type": "cross",
              "value": 5
            },
            "liquidationPx": null,
            "marginUsed": "1000.00",
            "maxLeverage": 10,
            "positionValue": "5000.00",
            "returnOnEquity": "5.00",
            "szi": "0.1",
            "unrealizedPnl": "50.00",
            "hasTpsl": false
          }
        }
      ],

      "borrowApr": "0.0523",
      "pendingWithdrawalsCount": 0,
      "activeHealthMetric": "cross_margin_ratio",
      "time": 1701234567890
    }
  }
}

Isolated Positions

summary.assetPositions also includes nonzero assigned HIP-3 positions with position.leverage.type: "isolated" and a position.isolated object. These positions are separate from the cross-margin totals. There is no top-level isolated-equity aggregate.

Field	Meaning
`isolated.supportUsd`	Stored scope cash minus scope shortfall, in USD
`isolated.equityUsd`	Optional scope equity at the current mark
`isolated.markPx`	Optional mark used for this row’s derived values
`isolated.bankruptcyPx`	Optional positive zero-equity price
`isolated.health`	`active`, `liquidating`, `adl_pending`, or `market_halted`
`isolated.permissions`	Action permissions, using the same shape as `activeAssetData.isolated.permissions`
`isolated.pendingRelease`	Optional `{ amount, status: "pending" }` for support returning to cross collateral

Isolated rows omit marginUsed; use isolated.supportUsd for posted support. Without a usable mark, they also omit positionValue, unrealizedPnl, returnOnEquity, isolated.markPx, isolated.equityUsd, and isolated.bankruptcyPx, and return liquidationPx: null. returnOnEquity is also omitted when support is not positive. Treat missing derived fields as unavailable, rather than zero. The current isolated projector returns zero placeholders for cumFunding and hasTpsl: false; these do not establish actual cumulative funding or attached protection. Use Market Trading State for scope state and permissions, and Open Orders for working TP/SL orders.

Numeric Fields and Withdrawal Updates

leverage.value and maxLeverage are numbers in both REST and WebSocket positions. borrowApr is a decimal rate ("0.0523" means 5.23%). portfolioMarginRatio is optional; when present, it and crossMarginRatio are decimal ratios. activeHealthMetric selects cross_margin_ratio or portfolio_margin_ratio for account health. Per-balance liability.totalDebt includes margin financing and cash debt; liability.persistedDebt is stored cash debt. Do not combine isolated support with the cross balance or subtract it a second time. Updates may include lastWithdrawalResult with status (completed or failed), transactionId, amount, coin, timestamp, and an optional reason. The initial subscription currently uses pendingWithdrawalsCount: 0; query Pending Withdrawals to establish the initial queue state.

pUSD trading capacity

balances includes a projected pUSD row for eligible Notional collateral accounts even when owned pUSD and debt are both zero. The row’s optional tradingCapacity has the same status, amount, policy, and expiry fields as Asset Balances. available continues to mean free cash, while tradingCapacity.availableToTrade includes credit. Each row’s liability.totalDebt includes projected interest. There is no asset-specific financing object on the summary. Debt and buying power are separate; expire old capacity and recover via HTTP if the stream stalls.

Start Here

Info

Analytics

Exchange

WebSocket

Response

Isolated Positions

Numeric Fields and Withdrawal Updates

pUSD trading capacity

​Subscribe

​Response

​Isolated Positions

​Numeric Fields and Withdrawal Updates

​pUSD trading capacity

Subscribe

Response

Isolated Positions

Numeric Fields and Withdrawal Updates

pUSD trading capacity