Spot Clearinghouse State

Returns Notional account balances using Hyperliquid’s signed balance/hold convention. This endpoint reads the Notional account; external Hyperliquid wallet balances remain separate.

{ "type": "spotClearinghouseState", "user": "0x1111111111111111111111111111111111111111" }

Send the request to POST /info. A collateral-backed account with 80 pUSD buying power and no owned pUSD or debt includes:

{
  "user": "0x1111111111111111111111111111111111111111",
  "balances": [
    {
      "coin": "pUSD",
      "asset": "800101c011a7e12a19f7b1f670d46f03b03f3342e82dfb",
      "total": "0",
      "hold": "-80",
      "borrowed": "0",
      "spotHold": "0",
      "supplied": "0",
      "tradingCapacity": {
        "status": "available",
        "availableToTrade": "80.000000",
        "additionalBorrow": "80.00000000",
        "borrowing": "enabled",
        "currentAprBps": 400,
        "asOf": 1800000000000,
        "validUntil": 1800000010000
      }
    }
  ],
  "asOf": 1800000000000
}

For pUSD, let C be accepted cash plus funded claims, H actual reservations, D total debt including projected interest, and B the admissible additional reservation budget:

Field	Meaning
`total`	`C - D`: signed net balance
`hold`	`total - B`: may be negative, so `total - hold` equals buying power
`borrowed`	Actual total liability, including projected interest
`spotHold`	`H - D`: signed reservation/cash-debt component
`supplied`	`C - H`: unreserved supplier value, excluding unused borrowing capacity

These are response projections; negative holds are never persisted as accounting reservations. The existing assets endpoint retains gross cash and actual holds. Buying power does not increase equity or authorize a withdrawal. Native Hyperliquid assets use their genuine numeric token mapping. pUSD has no Hyperliquid token index, so it omits token and uses the canonical Notional asset extension. USDC uses portfolio available margin for total - hold; other collateral rows expose their own balances and holds. Notional does not publish tokenToAvailableAfterMaintenance from an initial trading budget. Unavailable pricing or pUSD capacity returns HTTP 503, rather than a fabricated numeric hold. For a partial balance view with explicit capacity status, use assets. Pool policy and release qualification gates still govern whether borrowing is available.

Start Here

Info

Analytics

Exchange

WebSocket