This API is in private preview. Target September 2026; timing is subject to change.
{"method":"subscribe","subscription":{"type":"allUserNonFundingLedgerUpdates","eventTypes":["deposit","transfer"]}}{"channel":"subscriptionResponse","data":{"subscriptionId":"sub_01","type":"allUserNonFundingLedgerUpdates"}}{"channel":"allUserNonFundingLedgerUpdates","subscriptionId":"sub_01","blockHeight":123456,"blockTime":1780000000000,"cursor":"<opaque cursor>","data":{"user":"0x1111111111111111111111111111111111111111","delta":{"type":"internalTransfer","usdc":"25.00"},"time":1780000000000}}| Field | Type | Description |
|---|---|---|
user | string | Address associated with the ledger update. |
delta | object | Ledger operation and its type-specific fields. |
time | integer | Event timestamp in milliseconds. |
Every ledger update carries a delta object whose type field identifies the operation.
There is no common delta shape: branch on type before reading value fields, because some deltas use USDC-denominated usdc while others use amount and token.
| Type | Source | Description | Fields |
|---|---|---|---|
internalTransfer | Foundation documented | Transfer between accounts. | user, destination, usdc, fee |
send | Additional HyperCore type | Transfer to another address. | user, destination, sourceDex, destinationDex, token, amount, usdcValue, fee, feeToken, nativeTokenFee, nonce |
subAccountTransfer | Foundation documented | Transfer involving a subaccount. | user, destination, usdc |
accountClassTransfer | Foundation documented | Transfer between account classes. | usdc, toPerp |
perpDexClassTransfer | Additional HyperCore type | Transfer between perpetual DEX account classes. | usdc, user, destination |
spotTransfer | Foundation documented | Spot-asset transfer between accounts. | user, destination, token, amount, usdcValue, fee, feeToken, nativeTokenFee, nonce |
gossipPriorityGasAuction | Additional HyperCore type | Ledger effect of a priority gas auction. | token, amount |
send includes sourceDex and destinationDex to route transfers across builder-deployed perpetual DEXes.
| Type | Source | Description | Fields |
|---|---|---|---|
deposit | Foundation documented | Bridge transfer from Arbitrum to Hyperliquid. | usdc |
withdraw | Foundation documented | Bridge transfer from Hyperliquid to Arbitrum. | usdc, fee, nonce |
| Type | Source | Description | Fields |
|---|---|---|---|
vaultCreate | Foundation documented | Managed vault creation. | vault, user |
vaultDeposit | Foundation documented | Deposit into a managed vault. | vault, usdc |
vaultWithdraw | Foundation documented | Withdrawal from a managed vault. | user, vault, requestedUsd, netWithdrawnUsd, basis, closingCost, commission |
vaultDistribution | Foundation documented | Distribution from a managed vault. | vault, user, amount |
vaultLeaderCommission | Foundation documented | Commission paid to a vault leader. | user, usdc |
| Type | Source | Description | Fields |
|---|---|---|---|
cStakingTransfer | Additional HyperCore type | Transfer related to core staking. | token, amount, isDeposit |
spotGenesis | Foundation documented | Spot-market genesis allocation. | token, amount, user |
| Type | Source | Description | Fields |
|---|---|---|---|
rewardsClaim | Foundation documented | Claim of account rewards. | token, amount |
borrowLend | Additional HyperCore type | Borrow or lend account operation. | token, amount, interestAmount, operation |
borrowLendBackstopLiquidation | Additional HyperCore type | Backstop liquidation in the borrow and lend system. | token, user, amount |
accountActivationGas | Additional HyperCore type | Account-activation gas charge. | token, amount |
activateDexAbstraction | Additional HyperCore type | DEX-abstraction activation. | user |
deployGasAuction | Additional HyperCore type | Gas-auction deployment operation. | user, amount |
| Type | Source | Description | Fields |
|---|---|---|---|
liquidation | Foundation documented | Liquidation of an account position. | user, liquidatedNtlPos |
Funding payments are delivered separately on the funding rates stream, not as a ledger delta.
{"method":"unsubscribe","subscription":{"type":"allUserNonFundingLedgerUpdates","eventTypes":["deposit","transfer"]}}To resume a stream, supply cursor in the subscription object. The cursor is opaque: clients store and return it unmodified, and its format may change.