/info API surfaces raw building blocks; you write the parser. Liquidations are buried inside fills as a thin stub, and vault, staking, and delegation activity arrives as untyped ledger updates you have to classify yourself.
GoldRush ships every one of these pre-decoded and typed.
What’s pre-decoded
Liquidations
Inline with the fill that triggered them, with full context:20+ ledger event subtypes
See
HypercoreLedgerEvent for the full type with all fields.
Funding, deposits, withdrawals, delegations
Each gets its own typed event:HypercoreFundingEvent- funding rate payment with coin, rate, and amount.HypercoreDepositEvent- cross-chain deposit into HyperCore.HypercoreWithdrawalEvent- finalized cross-chain withdrawal.HypercoreDelegationEvent- staking delegation or undelegation with validator address.
Subscribe
Pull liquidations, fills, and ledger events for a wallet (or many) in one stream:Patterns
Live liquidation tape
Filter the stream onHypercoreFillTransaction where liquidation is non-null. Display each liquidation in a chronological feed with the user, mark price, method, and total position value.
”X just got liquidated for $Y” notifications
Push every non-nullliquidation to a notification channel. Use account_value to compute the dollar size and liquidated_positions[] to list the markets.
Position-risk warnings
CombineclearinghouseState (read liquidationPx, marginUsed, accountValue) with live LedgerLiquidation events for similar wallets to flag at-risk positions before they liquidate.
Vault leaderboards
AggregateLedgerVaultLeaderCommission and LedgerVaultDistribution events per vault address. Surface top-performing vaults by commission earned or distribution payout.
Staking and rewards tabs
Subscribe toLedgerCStakingTransfer, HypercoreDelegationEvent, and LedgerRewardsClaim for a user. Display delegation history, current stake, and rewards earned.
Borrow/lend position trackers
Filter onLedgerBorrowLend for operation: "borrow" | "repay" | "open" | "close". Display per-token borrow positions with cumulative interest.
Historical depth
Every fill, funding payment, and ledger event is retained back to HyperCore block ().Pair address format
Hyperliquid markets use a deployer-prefix naming scheme. The exact string differs by surface, so pass the value each API expects - matching is case- and format-sensitive.deployer- wallet address of the HIP-3 builder that deployed the market. Omitted for canonical Hyperliquid markets.symbol- market ticker (e.g.GOLD,OIL).quote- the margin / quote currency, usuallyUSDC(some HIP-3 markets useUSDH).
HIP-4 outcome markets use a separate
#<encoding> scheme (e.g. #1230), not the deployer-prefix - see HIP-4 Markets.perpDexs Info API type) is on the roadmap. Until it ships, call metaAndAssetCtxs - the name field on each universe entry is the canonical pair address.
Reference
HypercoreFillTransactionHypercoreLedgerEventHypercoreFundingEventHypercoreDepositEventHypercoreWithdrawalEventHypercoreDelegationEvent- Decoded Events Guide - every type, every subtype.