subAccountTransfer payload - Sub-Account Transfers
Decode Hyperliquid `subAccountTransfer` payloads for sub-account transfers, returned through Dwellir's read-only L1 gRPC API.
Read-only action reference
Dwellir's Hyperliquid gRPC API returns this decoded action payload through
StreamBlocks and
GetBlock. It does not submit or execute this action.
Submit supported user write actions through Hyperliquid's native
POST /exchange
endpoint.
The decoded subAccountTransfer payload records a USD transfer between a master account and one of its sub-accounts.
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
| 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 USD1000000000= 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.
Related Action Payloads
- createSubAccount - Sub-account creation
- subAccountModify - Sub-account setting changes
- subAccountSpotTransfer - Sub-account spot transfers