Docs

vaultTransfer payload - Vault Transfers

Decode Hyperliquid `vaultTransfer` payloads for vault 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 vaultTransfer payload records a deposit to or withdrawal from a Hyperliquid vault.

Sample Data

JSON
{
  "signature": {
    "r": "0xb2eaf71a6dd711b38983c5ca9c813e6260cd11414d5b66bfc734ccf27671858c",
    "s": "0x77e7d3501bc1c6743787a1967dcdc0618f0f445df70bb98b99dccc66881d4b33",
    "v": 28
  },
  "action": {
    "type": "vaultTransfer",
    "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    "isDeposit": false,
    "usd": 500000000
  },
  "nonce": 1768147192344,
  "expiresAfter": 1768147206900
}

View this transaction on Hypurrscan

Field Reference

Action Fields

FieldTypeDescription
typestringAlways "vaultTransfer"
vaultAddressstringEthereum address of the vault
isDepositbooleantrue for deposit, false for withdrawal
usdnumberAmount in raw units (6 decimals, so 50000000 = 50 USD)

Optional Fields

FieldTypeDescription
expiresAfternumberTimestamp after which the transfer expires

Amount Conversion

The usd field uses 6 decimal places:

  • 50000000 = 50.00 USD
  • 1000000 = 1.00 USD
  • 1000000000 = 1,000.00 USD

Use Cases

Vault Flow Analysis

Track capital flows into and out of vaults:

Python
def process_vaultTransfer_action(action):
    vault = action.get('vaultAddress')
    amount = action.get('usd') / 1_000_000  # Convert to USD
    direction = 'deposit' if action.get('isDeposit') else 'withdrawal'

    print(f"Vault {direction}: ${amount:,.2f} to {vault[:10]}...")

Fund Manager Performance

Monitor vault deposit/withdrawal patterns to understand:

  • Vault popularity and AUM trends
  • Investor confidence in vault strategies
  • Capital rotation between vaults

Copy Trading Analysis

Track which vaults are attracting deposits to identify successful trading strategies.