Retrieve non-funding ledger updates for a specific user account, including deposits, withdrawals, transfers, liquidations, and other account activities excluding funding payments.
info
endpoint with type: "userNonFundingLedgerUpdates"
retrieves comprehensive ledger updates for a specific user account on the Hyperliquid exchange, excluding funding payments. This endpoint provides detailed information about all account activities including deposits, withdrawals, transfers, liquidations, spot trading, and other balance-affecting operations.
type
(string, required) — The request type. Must be "userNonFundingLedgerUpdates"
to retrieve user ledger updates.user
(string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.startTime
(integer, required) — Start time in milliseconds, inclusive.endTime
(integer, optional) — End time in milliseconds, inclusive. Defaults to current time.time
— Unix timestamp in milliseconds when the event occurredhash
— Transaction hash for blockchain transactionsdelta
object):
type
— Type of ledger update (see transaction types below)deposit
— USDC deposits into the account
usdc
— Amount deposited in USDCwithdraw
— USDC withdrawals from the account
usdc
— Amount withdrawn in USDCnonce
— Unique nonce for the withdrawalfee
— Withdrawal fee in USDCaccountClassTransfer
— Transfers between spot and perpetual accounts
usdc
— Amount transferred in USDCtoPerp
— Boolean indicating transfer direction (true = to perp, false = to spot)spotTransfer
— Spot token transfers between accounts
token
— Token symbol being transferredamount
— Token amount transferredusdcValue
— USD value of the transferuser
— Source user addressdestination
— Destination addressfee
— Transfer feenativeTokenFee
— Native token feenonce
— Transfer nonce (if applicable)spotGenesis
— Initial token allocations or airdrops
token
— Token symbolamount
— Token amount receivedsubAccountTransfer
— Transfers between main account and sub-accounts
usdc
— Amount transferreduser
— Source account addressdestination
— Destination account addressinternalTransfer
— Internal transfers within the exchange
usdc
— Amount transferreduser
— Source userdestination
— Destination userfee
— Transfer feeliquidation
— Forced position closures due to insufficient margin
liquidatedNtlPos
— Total notional value liquidatedaccountValue
— Account value at liquidationleverageType
— Leverage type (Cross/Isolated)liquidatedPositions
— Array of liquidated positions with coin and sizecStakingTransfer
— Consensus staking deposits and withdrawals
token
— Staked token symbolamount
— Amount staked/unstakedisDeposit
— Boolean indicating if it’s a deposit or withdrawalaccountClassTransfer
events move funds between spot and perpetual tradingspotTransfer
events involve token movements between different addressessubAccountTransfer
events manage funds across account hierarchiesliquidation
events indicate margin calls and forced position closuresinfo
endpoint with type: "userNonFundingLedgerUpdates"
is essential for applications that need to:
User non-funding ledger updates data
Array of ledger update events for the user