Skip to main content

createSubAccount

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

Sample Data#

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

View this transaction on Hypurrscan →

Field Reference#

Action Fields#

FieldTypeDescription
typestringAlways "createSubAccount"
namestringHuman-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:

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.