createSubAccount (gRPC) | Hyperliquid API Docs

Create a new sub-account on Hyperliquid for isolated trading strategies and risk management.

Create a new sub-account under the master account. Sub-accounts allow traders to isolate capital and risk for different trading strategies.

Sample Data

JSON

{
  "signature": {
    "r": "0xb1e85a19894f08da2be6a3fc59c165daf03aeb90619211ea6eb94c38de6f4189",
    "s": "0x5d698bf033beb7efb63c29fb95cfbd9c1e7226841f365efe415ee35f60c028f",
    "v": 28
  },
  "action": {
    "type": "createSubAccount",
    "name": "test"
  },
  "nonce": 1768146918353
}

View this transaction on Hypurrscan

Field Reference

Action Fields

Field	Type	Description
`type`	string	Always `"createSubAccount"`
`name`	string	Human-readable name for the sub-account

Sub-Account Benefits

Risk Isolation: Each sub-account has separate margin and positions
Strategy Separation: Run different strategies without interference
API Wallet Support: Agent wallets can trade on sub-accounts
Clean Accounting: Easier PnL tracking per strategy

Use Cases

Account Structure Analysis

Track sub-account creation patterns:

Python

def process_createSubAccount_action(action):
    name = action.get('name')
    print(f"New sub-account created: {name}")

User Sophistication Metrics

Sub-account creation indicates more sophisticated traders who segment their capital.

Platform Growth Tracking

Monitor sub-account creation as a metric of platform engagement.

subAccountTransfer - Fund sub-accounts
subAccountModify - Modify sub-account settings
subAccountSpotTransfer - Transfer spot assets

createSubAccount - Create Sub-Account