Docs

subAccountModify payload - Sub-Account Settings

Decode Hyperliquid `subAccountModify` payloads for sub-account settings, 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 subAccountModify payload records a settings or permissions change for a Hyperliquid sub-account.

Sample Data

JSON
{
  "signature": {
    "r": "0xa1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
    "s": "0x6543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba987",
    "v": 27
  },
  "action": {
    "type": "subAccountModify",
    "subAccountUser": "0x1234567890abcdef1234567890abcdef12345678",
    "name": "Trading Bot 1"
  },
  "nonce": 1767949700000
}

Field Reference

Action Fields

FieldTypeDescription
typestringAlways "subAccountModify"
subAccountUserstringSub-account address to modify
namestringNew name for the sub-account

Use Cases

Sub-Account Management

Track sub-account modifications:

Python
def process_subAccountModify_action(action):
    sub_account = action.get('subAccountUser')
    name = action.get('name')
    print(f"Sub-account modified: {sub_account[:10]}... -> {name}")