Account Summary

Hyperliquid

Returns the cross-margin account summary and open perpetual positions. Spot-token and prediction-market balances use separate reads.

Endpoint

POST /info

Request Body

Parameter	Type	Description
`type`*	string	Must be `"account"`
`user`*	string	User’s wallet address (case-insensitive), e.g., `"0x1234567890abcdef..."`

Response

200: With Positions
200: No Positions
503: Unavailable

{
  "crossMaintenanceMarginUsed": "500.00",
  "crossMarginSummary": {
    "accountValue": "10000.00",
    "totalMargin": "10000.00",
    "totalMarginUsed": "1000.00",
    "totalNtlPos": "5000.00",
    "totalRawUsd": "10000.00"
  },
  "marginSummary": {
    "accountValue": "10000.00",
    "totalMargin": "10000.00",
    "totalMarginUsed": "1000.00",
    "totalNtlPos": "5000.00",
    "totalRawUsd": "10000.00"
  },
  "assetPositions": [
    {
      "type": "oneWay",
      "position": {
        "coin": "BTC",
        "cumFunding": {
          "allTime": "0",
          "sinceChange": "0",
          "sinceOpen": "0"
        },
        "entryPx": "50000.00",
        "leverage": {
          "type": "cross",
          "value": 5
        },
        "liquidationPx": "45000.00",
        "marginUsed": "1000.00",
        "maxLeverage": 10,
        "positionValue": "5000.00",
        "returnOnEquity": "5.00",
        "szi": "0.1",
        "unrealizedPnl": "50.00",
        "hasTpsl": false
      }
    }
  ],
  "time": 1701234567890,
  "withdrawable": "9000.00",
  "crossMarginRatio": "0.0500",
  "portfolioMarginRatio": "0.2500",
  "activeHealthMetric": "cross_margin_ratio"
}

{
  "crossMaintenanceMarginUsed": "0.00",
  "crossMarginSummary": {
    "accountValue": "0.00",
    "totalMargin": "0.00",
    "totalMarginUsed": "0.00",
    "totalNtlPos": "0.00",
    "totalRawUsd": "0.00"
  },
  "marginSummary": {
    "accountValue": "0.00",
    "totalMargin": "0.00",
    "totalMarginUsed": "0.00",
    "totalNtlPos": "0.00",
    "totalRawUsd": "0.00"
  },
  "assetPositions": [],
  "time": 1701234567890,
  "withdrawable": "0.00",
  "crossMarginRatio": "0.0000",
  "activeHealthMetric": "cross_margin_ratio"
}

{
  "error": "Account coordinator unavailable for account data",
  "code": "SERVICE_UNAVAILABLE",
  "retryAfter": 5,
  "timestamp": 1785254400000
}

Response Fields

Field	Type	Description
`crossMaintenanceMarginUsed`	string	Maintenance margin requirement, e.g., `"500.00"`
`crossMarginSummary`	object	Cross-margin account values
`marginSummary`	object	Currently contains the same values as `crossMarginSummary`
`assetPositions`	array	List of open positions; current rows use the cross shape
`time`	number	Unix-millisecond snapshot time, e.g., `1701234567890`
`withdrawable`	string	Available withdrawal amount, e.g., `"9000.00"`
`crossMarginRatio`	string	Maintenance margin divided by collateral, e.g., `"0.0500"`
`portfolioMarginRatio`	string	Optional portfolio-margin health ratio, e.g., `"0.2500"`
`activeHealthMetric`	string	Ratio used for account-health checks

This REST response serializes the cross-margin position set and does not publish isolated positions or an isolated-equity aggregate. Account Summary over WebSocket includes isolated position rows. Use Market Trading State for an HTTP snapshot of one assigned HIP-3 market’s scope balances, leverage, health, and permissions.

Cross-margin summary

Field	Type	Description
`accountValue`	string	Total account value in USDC, e.g., `"10000.00"`
`totalMargin`	string	Total margin backing the account, e.g., `"10000.00"`
`totalMarginUsed`	string	Margin allocated to positions, e.g., `"1000.00"`
`totalNtlPos`	string	Total notional position value, e.g., `"5000.00"`
`totalRawUsd`	string	USDC account balance, e.g., `"10000.00"`

Position

Field	Type	Description
`coin`	string	Asset symbol, e.g., `"BTC"`
`cumFunding`	object	Cumulative funding payments
`entryPx`	string	Average entry price, e.g., `"50000.00"`
`leverage`	object	Leverage configuration
`liquidationPx`	string \| null	Estimated liquidation price, e.g., `"45000.00"`
`marginUsed`	string	Margin allocated to this position, e.g., `"1000.00"`
`maxLeverage`	number	Maximum allowed leverage, e.g., `10`
`positionValue`	string	Notional value of position, e.g., `"5000.00"`
`returnOnEquity`	string	Percentage return on equity, e.g., `"5.00"` is 5%
`szi`	string	Signed size, e.g., `"0.1"` long or `"-0.1"` short
`unrealizedPnl`	string	Unrealized profit/loss, e.g., `"50.00"`
`hasTpsl`	boolean	Whether the position currently has TP/SL protection attached

Cumulative funding

Field	Type	Description
`allTime`	string	Cumulative funding for this user and market, retained across position closes
`sinceChange`	string	Funding since the latest size change, e.g., `"0"`
`sinceOpen`	string	Funding since the position opened, e.g., `"0"`

Funding amounts use Notional’s sign convention: positive means received, negative means paid.

Leverage

Field	Type	Description
`type`	`"cross"`	Margin mode; currently always `cross`
`value`	number	Current leverage, e.g., `5`

Trading capacity

For the complete cash-plus-credit order budget, use each balance row’s tradingCapacity in Asset Balances. Credit is never included in account equity or withdrawable cash. Debt is reported in each row’s liability.totalDebt, including projected interest. The account response has no asset-specific financing object.

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

Response

Response Fields

Cross-margin summary

Position

Cumulative funding

Leverage

Trading capacity

​Endpoint

​Request Body

​Response

​Response Fields

​Cross-margin summary

​Position

​Cumulative funding

​Leverage

​Trading capacity

Endpoint

Request Body

Response

Response Fields

Cross-margin summary

Position

Cumulative funding

Leverage

Trading capacity