Skip to main content
POST
clearinghouseState | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "clearinghouseState" is used to fetch a single user’s perpetuals account state by wallet address.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "clearinghouseState", "user": "..."}.
  • The optional dex field returns state on a HIP-3 deployer’s perp DEX. Pass "*" or "ALL_DEXES" to return state across the native dex and every HIP-3 dex in one call.
  • Wildcard ("*" / "ALL_DEXES") requests are billed at a flat 10 credits vs. 1 credit for a single-dex call.
  • The perpDexs list used for wildcard fan-out is cached ~2 minutes, so a newly-deployed dex may take up to that long to appear in wildcard results.
Note: Wildcard ("*" / "ALL_DEXES") requests are billed at a flat 10 credits per call.

Endpoint

Request

string
default:"clearinghouseState"
required
Always "clearinghouseState".
string
required
The wallet address (lowercase 0x-prefixed hex).
string
HIP-3 builder DEX identifier. Empty string (default) returns canonical Hyperliquid perp state. Pass a builder code to query a HIP-3 deployer’s perp DEX.

Example

Response

Field descriptions

All numeric fields below (account value, position size, prices, funding amounts, etc.) are returned as decimal strings, preserving upstream precision. Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.
object
Top-level account margin and value summary.
object
Cross-margin subset of the margin summary. Same fields.
string
Maintenance margin currently used for cross positions.
string
Amount currently withdrawable, in USD.
array<object>
Open positions, one entry per coin.
int
Snapshot timestamp in milliseconds since Unix epoch.

batchClearinghouseState

fetch perpetuals account state for up to 50 wallets in a single request.

batchSpotClearinghouseState

fetch spot account balances for up to 50 wallets in a single request.

spotClearinghouseState

fetch a single user’s spot account balances by wallet address.
Last reviewed: 2026-07-07