Docs

userPortfolioMargin - Portfolio Margin Mode

Enable or configure portfolio margin mode on Hyperliquid for more capital-efficient trading across correlated positions.

Enable or configure portfolio margin mode for an account. Portfolio margin considers the risk of the entire portfolio rather than individual positions, allowing more capital-efficient trading.

Sample Data

JSON
{
  "signature": {
    "r": "0x7e5f71ded930d4524d19dc7d6f04b2cb268355ee3a71465365017d12fccac779",
    "s": "0x16414434babfd4079bdedffd4c78644f66d95bee4287e4a375208b5ffe8893ea",
    "v": 27
  },
  "action": {
    "type": "userPortfolioMargin",
    "signatureChainId": "0xa4b1",
    "hyperliquidChain": "Mainnet",
    "user": "0xb714f435b61a228aa82d28fd4d975b041a88f85d",
    "enabled": true,
    "nonce": 1768147316503
  },
  "nonce": 1768147316503
}

View this transaction on Hypurrscan

Field Reference

Action Fields

FieldTypeDescription
typestringAlways "userPortfolioMargin"
signatureChainIdstringChain ID for signing
hyperliquidChainstringTarget chain
userstringUser address to configure
enabledbooleantrue to enable, false to disable
noncenumberTransaction nonce

Use Cases

Portfolio Margin Adoption

Track portfolio margin usage:

Python
def process_userPortfolioMargin_action(action):
    user = action.get('user')
    enabled = action.get('enabled')
    status = 'enabled' if enabled else 'disabled'
    print(f"Portfolio margin {status} for {user[:10]}...")