Skip to main content

subAccountTransfer

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#

{
  "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#

FieldTypeDescription
typestringAlways "subAccountTransfer"
subAccountUserstringAddress of the sub-account
isDepositbooleantrue to transfer to sub-account, false to withdraw from sub-account
usdnumberAmount 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:

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.