Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Subaccounts

Last updated: Jun 16, 2026

What is a subaccount?

A subaccount is a trading account linked to your wallet. It holds collateral balances, open positions, and order history. All trading activity happens within a subaccount.

You can create multiple subaccounts under a single wallet, useful for:

  • Separating trading strategies
  • Isolating risk between different books of positions
  • Running automated strategies independently of manual trading

Creating a subaccount

From the Account menu in the app, click New Subaccount. You will be prompted to sign a transaction to create the account on-chain.

Each subaccount has a unique ID. Subaccounts are stored on-chain and persist indefinitely.

Switching subaccounts

Use the subaccount selector in the top navigation to switch between accounts. Balances, positions, and history are all scoped to the active subaccount.

Collateral isolation

Each subaccount has its own collateral pool. Assets in one subaccount do not affect the margin, liquidation risk, USDT debt, or withdrawal limits of another.

You can deposit non-USDT collateral such as WETH directly into a subaccount without holding USDT there. That collateral can support USDT-settled perps positions inside the same subaccount.

Transfers between subaccounts

Moving collateral from one subaccount to another follows withdrawal-style checks. The source subaccount must keep enough collateral for:

  • Open position margin.
  • USDT debt and LTV limits.
  • The USDT cap for USDT transfers.
  • Any active account or asset limits shown in the app.

If a transfer would make the source subaccount unhealthy, the app will reduce the available amount or block the transfer.

API access

Subaccounts are identified by their on-chain ID when using the API. See Get Subaccount for how to query subaccount state programmatically.

See also