curl --request POST \
--url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
--header 'Content-Type: application/json' \
--data '{
"type": "spotClearinghouseState",
"user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}'
{
"balances": [
{
"coin": "<string>",
"token": 123,
"hold": "<string>",
"total": "<string>",
"entryNtl": "<string>"
}
]
}
curl --request POST \
--url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
--header 'Content-Type: application/json' \
--data '{
"type": "spotClearinghouseState",
"user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}'
{
"balances": [
{
"coin": "<string>",
"token": 123,
"hold": "<string>",
"total": "<string>",
"entryNtl": "<string>"
}
]
}
info
endpoint with type: "spotClearinghouseState"
retrieves a user’s token balances for spot trading on the Hyperliquid exchange. This endpoint provides detailed information about available balances, held amounts in open orders, and entry notional values for all spot tokens in the user’s account.
type
(string, required) — The request type. Must be "spotClearinghouseState"
to retrieve user’s spot token balances.user
(string, required) — Onchain address in 42-character hexadecimal format (e.g., 0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036
).coin
(string) — Token symbol (e.g., “USDC”, “PURR”).token
(integer) — Token index identifier used internally by the exchange.hold
(string) — Amount currently on hold (locked in open orders or pending transactions).total
(string) — Total balance including both available and held amounts.entryNtl
(string) — Entry notional value, used for PnL calculations and tracking cost basis.Available Balance = Total - Hold
total
is “14.625485” and hold
is “0.0”, then the available balance is “14.625485”.
curl -X POST \
-H "Content-Type: application/json" \
-d '{"type": "spotClearinghouseState", "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"}' \
https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
info
endpoint with type: "spotClearinghouseState"
is essential for spot trading applications that need to:
User's spot token balances
The response is of type object
.