subAccountTransfer (gRPC) | Hyperliquid API Docs

Transfer funds between main and sub-accounts on Hyperliquid. Enables isolated trading strategies and risk management.

Transfer USD between a main account and its sub-accounts. Sub-accounts enable traders to isolate capital for different strategies while maintaining a single master account.

Sample Data

JSON

{
  "signature": {
    "r": "0xda5441ff957c27e824e3540bcfb3e0bb7ccf5fba10712084981e14b6822e5d2b",
    "s": "0x36985abcf5691e89d37afd7f9da70453bc7abdd4f0b29c1ddd9326022c94a43c",
    "v": 28
  },
  "action": {
    "type": "subAccountTransfer",
    "subAccountUser": "0xde22d34aa3b215d225e209c906e19511465738b1",
    "isDeposit": true,
    "usd": 18000000
  },
  "nonce": 1768146973096
}

View this transaction on Hypurrscan

Field Reference

Action Fields

Field	Type	Description
`type`	string	Always `"subAccountTransfer"`
`subAccountUser`	string	Address of the sub-account
`isDeposit`	boolean	`true` to transfer to sub-account, `false` to withdraw from sub-account
`usd`	number	Amount in raw units (6 decimals, so 153000000 = 153 USD)

Amount Conversion

The usd field uses 6 decimal places:

153000000 = 153.00 USD
1000000000 = 1,000.00 USD

Use Cases

Capital Allocation Tracking

Monitor how traders allocate capital across sub-accounts:

Python

def process_subAccountTransfer_action(action):
    sub_account = action.get('subAccountUser')
    amount = action.get('usd') / 1_000_000
    direction = 'to' if action.get('isDeposit') else 'from'

    print(f"Transfer ${amount:,.2f} {direction} sub-account {sub_account[:10]}...")

Strategy Isolation Analysis

Track how traders segment capital for different trading strategies.

Risk Management Patterns

Monitor sub-account funding to understand risk management approaches.

createSubAccount - Create new sub-accounts
subAccountModify - Modify sub-account settings
subAccountSpotTransfer - Transfer spot assets to sub-accounts

subAccountTransfer - Sub-Account Transfers