Hyperliquid

Account Portfolio

Returns a wallet's full portfolio across perps, spot, vaults, and staking in one call, with a perp+vault equity roll-up (total_value_usd is the total-equity figure a dashboard header should show, vs the perp-only equity on /performance and /positions). This is the source for spot balances.

This is a point-in-time snapshot, not a time series; its perp block duplicates the margin summary from /hyperliquid/positions (this endpoint adds spot/vault/staking so it stands alone as a full-portfolio call). Sections are fetched independently: if one fails, that section is omitted (not null) and the failure is named in errors[]. The call returns 200 when at least one section succeeds, and 502 only if all four fail. Spot balances are token-denominated and staking is in HYPE.

get/gateway/v1/hyperliquid/account

Query parameters

addressstring required

Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported.

Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseHyperliquidAccount.json"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.