Skip to main content
POST
subAccounts | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "subAccounts" is used to fetch a master wallet’s sub-accounts along with their full perp and spot state in a single call.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "subAccounts", "user": "..."}.
  • For per-sub-account real-time updates, subscribe to walletTxs on each subAccountUser returned here.
  • For multi-wallet polling without traversing master/sub-account hierarchy, see batchClearinghouseState and batchSpotClearinghouseState.
Returns the sub-accounts owned by a master wallet, with each sub-account’s perp clearinghouseState and spot spotClearinghouseState inlined per slot - so a single call returns the full balance picture across the master plus its sub-accounts. User-keyed. The result is null for wallets that aren’t master accounts.

Endpoint

Request

type
string
required
Always "subAccounts".
user
string
required
The master wallet address (lowercase 0x-prefixed hex).

Example

Response

An array of sub-account objects, or null if the queried wallet is not a master account.

Field descriptions

name
string
Optional human-readable label assigned to the sub-account.
subAccountUser
string
The sub-account’s wallet address (0x-prefixed hex).
master
string
The master wallet address that owns this sub-account.
clearinghouseState
object
Perp account state for this sub-account. Identical shape to the single-wallet clearinghouseState response - margin summaries, asset positions, withdrawable balance, snapshot timestamp.
spotState
object
Spot account state for this sub-account. Identical shape to the single-wallet spotClearinghouseState response - per-token balances and the optional tokenToAvailableAfterMaintenance array.
Last reviewed: 2026-06-13