Skip to main content

​
Account Types

Hyperliquid supports multiple account types that determine how margin and balances are managed:
Account TypeDescription
standardIsolated quote assets per provider operator. Each HIP-3 provider maintains a separate balance.
dexAbstractionLike-for-like quote assets are unified across HIP-3 providers. For example, the default provider ('') and a HIP-3 provider ('xyz') both use USDC, so a single USDC perps balance covers both.
unifiedAccountSpot and perps balances are further unified per quote asset across like-asset HIP-3 providers. Spot USDC can be used for perps on both '' and 'xyz'. Same applies to other quote assets like USDH or USDN.
portfolioMarginPortfolio margin with cross-asset margining.

​
Backend Behavior

The LI.FI Perps API automatically upgrades accounts from standard or dexAbstraction to unifiedAccount during the prerequisites flow. portfolioMargin accounts are left as-is.
This ensures all SDK users get the latest Hyperliquid account features (unified USDC balance). The upgrade is a one-way operation — it cannot be reverted.

​
Account Configuration

The config object returned by getAccount() contains Hyperliquid-specific account state: 
const account = await getAccount(client, {
  provider: 'hyperliquid',
  address: userAddress,
});

console.log(account.config);
// {
//   abstractionStatus: "unifiedAccount",
//   agents: [...],
//   builderFeeApproval: {
//     builderAddress: "0x...",
//     maxFeeRate: "0.001",
//     approved: true,
//   },
// }
Config KeyFieldsDescription
abstractionStatusstringCurrent abstraction mode (unifiedAccount, portfolioMargin, dexAbstraction, or null)
agentsarrayApproved extra agents for this account
builderFeeApprovalbuilderAddress, maxFeeRate, approvedBuilder fee approval status (required for placing orders via LI.FI)
The SDK validates all config requirements automatically. These fields are useful for displaying account status in your UI.