Skip to main content
POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (subAccounts2)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "subAccounts2",
  "user": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568"
}
'
[
  {}
]
This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.
The info endpoint with type: "subAccounts2" returns the sub-accounts owned by a user (the V2 response), including each sub-account’s per-DEX clearinghouse state and spot state. Use it to enumerate and inspect the sub-accounts under a master account.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "subAccounts2".
  • user (string, required) — Master account address in 42-character hexadecimal format.

​
Response

Returns an array of the user’s sub-accounts, or null if the user has none. Each sub-account contains:
  • name (string) — The sub-account name.
  • subAccountUser (string) — The sub-account address.
  • master (string) — The master account address.
  • dexToClearinghouseState (array) — [dex, state] tuples mapping each DEX (empty string for the main DEX) to its clearinghouse state.
  • spotState (object) — The sub-account’s spot clearinghouse state.

​
Example request

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "subAccounts2", "user": "0x1442ad477ded1b0028b57621aa7b6f7eadb8f568"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
Use your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.

​
Example response

null
The example returns null because the queried address has no sub-accounts. An account with sub-accounts returns an array of sub-account objects as described above.

​
Use cases

The info endpoint with type: "subAccounts2" is useful for:
  • Enumerating the sub-accounts under a master account
  • Building dashboards that aggregate positions across sub-accounts
  • Portfolio tooling that needs each sub-account’s clearinghouse and spot state

Body

application/json
​
type
enum<string>
default:subAccounts2
required

Request type

Available options:
subAccounts2
​
user
string
default:0x1442ad477ded1b0028b57621aa7b6f7eadb8f568
required

User address in 42-character hexadecimal format.

Response

200 - application/json
object[] | null

Array of the user's sub-accounts, or null if the user has none.

Last modified on June 24, 2026