> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notional.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```json theme={null}
{ "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:

```json theme={null}
{
  "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](/api-reference/info-endpoints/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.