Skip to main content

Events Dataset

Updated on
Oct 09, 2026

Overview​

The events stream contains HyperCore ledger and system events, including transfers, deposits, withdrawals, vault operations, and funding payments. It is useful for following account activity, but it does not capture every balance change.

Stream Type: EVENTS
API Availability: gRPC Streaming API + JSON-RPC/WebSocket APIs
Volume: High - Multiple event types captured per block

Data Structure​

Each block contains an array of events with different inner types representing various blockchain operations:

{
  "local_time": "2025-11-05T16:09:18.727320857",
  "block_time": "2025-11-05T16:09:18.466557521",
  "block_number": 786814394,
  "events": [
    {
      "time": "2025-11-05T16:09:18.466557521",
      "hash": "0x4a3367a1c546233d4bad042ee5d5ba020b2a00876049420fedfc12f48449fd27",
      "inner": {
        "LedgerUpdate": {
          "users": [
            "0x025a744111554e57c66ba2069a8081249fbe5e11",
            "0x1e37a337ed460039d1b15bd3bc489de789768d5e"
          ],
          "delta": {
            "type": "vaultWithdraw",
            "vault": "0x1e37a337ed460039d1b15bd3bc489de789768d5e",
            "user": "0x025a744111554e57c66ba2069a8081249fbe5e11",
            "requestedUsd": "7.203866",
            "commission": "0.0",
            "closingCost": "0.0",
            "basis": "7.22722",
            "netWithdrawnUsd": "7.203866"
          }
        }
      }
    }
  ]
}

Event Fields​

FieldTypeDescription
timestringEvent timestamp (ISO 8601)
hashstringTransaction hash (may be null hash for some events)
innerobjectInner event data - see Event Types below

Event Types​

The events stream captures seven distinct categories of blockchain operations, each serving different purposes:

Event TypeDescriptionKey Operations
LedgerUpdateBalance changes, transfers, and asset movements (most common event type)Deposits, withdrawals, trades, vault operations
CWithdrawalCross-chain withdrawal events from Hyperliquid to other chainsBridge withdrawals, finalization status
CDepositCross-chain deposit events from other chains to HyperliquidBridge deposits, incoming transfers
DelegationValidator delegation and undelegation operationsStake delegation, undelegation, validator changes
FundingFunding rate payments for perpetual positionsHourly funding payments, rate calculations
ValidatorRewardsValidator reward distributions and payoutsBlock rewards, commission distributions
GossipPriorityAuctionRestartFired at the start of each gossip priority gas auction slot; records the previous winner and ending gas amountSlot ID, previous winner IP, end gas

Event Type Distribution​


  • LedgerUpdate: ~85% of all events (contains 20 different operation subtypes)
  • Funding: ~10% of all events (regular hourly payments)
  • CWithdrawal/CDeposit: ~3% of all events (bridge operations)
  • Delegation/ValidatorRewards: ~2% of all events (staking operations)

LedgerUpdate Delta Types​

LedgerUpdate events represent the majority of blockchain activity and contain a delta field that specifies the exact type of balance or state change. These 20 delta types are organized into logical categories:

Transfer Operations​

These operations move funds or assets between different accounts, wallets, or account types within the Hyperliquid ecosystem.

Delta TypeDescriptionCommon Use Cases
sendDirect USDC or token transfer between wallets (fields: user, destination, token, amount, sourceDex, destinationDex, usdcValue, fee, nativeTokenFee, nonce, feeToken)P2P payments, gifts
spotTransferSpot token transfer between wallets (fields: token, amount, usdcValue, user, destination, fee, nativeTokenFee, nonce, feeToken)Token exchanges
accountClassTransferMoving funds between spot and perpetual accounts (fields: usdc, toPerp)Cross-margin moves
subAccountTransferTransfers between main and sub-accounts (fields: usdc, user, destination)Account organization
internalTransferSystem-initiated internal movements (fields: usdc, user, destination, fee)Automated rebalancing
spotGenesisInitial token allocation at spot token genesis (fields: token, amount)New token launches

Deposit/Withdrawal Operations​

These operations track funds entering and leaving the Hyperliquid platform from external sources.

Delta TypeDescriptionCommon Use Cases
withdrawUser-initiated withdrawals from Hyperliquid (fields: usdc, nonce, fee)Cashing out, moving to other platforms
depositUser deposits into Hyperliquid accounts (fields: usdc)Adding trading capital, onboarding

Vault Operations​

These operations involve Hyperliquid's vault system, where users can deposit funds to be managed by vault leaders.

Delta TypeDescriptionCommon Use Cases
vaultDepositUser deposits funds into managed vaults (fields: vault, usdc)Passive investment
vaultWithdrawUser withdraws funds from managed vaults (fields: vault, user, requestedUsd, commission, closingCost, basis, netWithdrawnUsd)Profit taking, exit
vaultCreateCreation of new investment vaults (fields: vault, usdc)New fund launches
vaultDistributionVault distributes profits or assets to depositors (fields: vault, usdc)Profit distributions, yield payouts
vaultLeaderCommissionCommission payment to the vault leader (fields: user, usdc)Performance fees

Cross-Chain Operations​

These operations facilitate interactions between Hyperliquid and other blockchain networks.

Delta TypeDescriptionCommon Use Cases
cStakingTransferCross-chain staking deposit or withdrawal (fields: token, amount, isDeposit)Staking HYPE via bridge

System Operations​

These operations represent various system-level activities including rewards, lending protocol interactions, account management, and protocol features.

Delta TypeDescriptionCommon Use Cases
borrowLendBorrow or repay from the on-chain lending protocol (fields: token, operation, amount, interestAmount)USDH/USDC borrowing, loan repayments
rewardsClaimUsers claiming accumulated rewards or incentives (fields: amount, token)Staking rewards, referrals
accountActivationGasGas fee charged in HYPE to activate a new account (fields: amount, token)Onboarding costs
activateDexAbstractionEnables DEX abstraction, seeding the DEX with initial funds (fields: dex, token, amount)Pro trading features
gossipPriorityGasAuctionGas auction for gossip priority; system fee for priority transaction ordering (fields: token, amount)Priority transaction ordering

Liquidation Operations​

These operations record forced account liquidations in the ledger.

Looking for liquidation fills?

Individual liquidation executions are delivered on the TRADES stream, nested inside fill objects as a liquidation field. Filter trades with {"liquidation": ["*"]} to capture them. The events stream only carries the account-level ledgerLiquidation ledger record below.

Delta TypeDescriptionCommon Use Cases
ledgerLiquidationForced liquidation of an under-margined account (fields: accountValue, leverageType, liquidatedPositions[{coin, szi}])Risk monitoring, liquidation tracking

Example Events​

Send Transfer
{
  "time": "2025-11-05T10:00:11.608307855",
  "hash": "0xc65653c0e96471afc7d0042ee18ed40201ba00a6846790816a1eff13a8684b9a",
  "inner": {
    "LedgerUpdate": {
      "users": ["0x2e763fb97107d75687fe24ed785a2367df023bfd"],
      "delta": {
        "type": "send",
        "user": "0x2e763fb97107d75687fe24ed785a2367df023bfd",
        "destination": "0x2e763fb97107d75687fe24ed785a2367df023bfd",
        "sourceDex": "spot",
        "destinationDex": "",
        "token": "USDC",
        "amount": "1454.29",
        "usdcValue": "1454.29",
        "fee": "0.0",
        "nativeTokenFee": "0.0",
        "nonce": 1762336800859,
        "feeToken": ""
      }
    }
  }
}
Spot Transfer
{
  "time": "2025-11-05T10:00:12.061687082",
  "hash": "0xcfa4de23c8340733d11e042ee18eda020291000963372605736d89768737e11e",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x2222222222222222222222222222222222222222",
        "0xbe6ef6c481d807221ecdb430c7d7b95f71644f16"
      ],
      "delta": {
        "type": "spotTransfer",
        "token": "HYPE",
        "amount": "5.0",
        "usdcValue": "202.27",
        "user": "0x2222222222222222222222222222222222222222",
        "destination": "0xbe6ef6c481d807221ecdb430c7d7b95f71644f16",
        "fee": "0.0",
        "nativeTokenFee": "0.0",
        "nonce": null,
        "feeToken": ""
      }
    }
  }
}
Account Class Transfer
{
  "time": "2025-11-05T10:00:00.064607181",
  "hash": "0x402db380b853070941a7042ee18e5502023c0066535625dbe3f65ed37756e0f3",
  "inner": {
    "LedgerUpdate": {
      "users": ["0x95b05afa7d7fbfae2ef100c9f1dab4ba72836535"],
      "delta": {
        "type": "accountClassTransfer",
        "usdc": "1.57",
        "toPerp": true
      }
    }
  }
}
Withdrawal
{
  "time": "2025-11-05T10:01:39.693886853",
  "hash": "0x815c520448e379fcb09a694d08dc82c3988b8fd50e50dba633b823ee44886fff",
  "inner": {
    "LedgerUpdate": {
      "users": ["0xc66c8d71922825d97ed19e50287952d6b2d31879"],
      "delta": {
        "type": "withdraw",
        "usdc": "18.0",
        "nonce": 1762336653439000,
        "fee": "1.0"
      }
    }
  }
}
Deposit
{
  "time": "2025-11-05T10:00:04.076937921",
  "hash": "0xdf9b536831f9b2732004130d0b2d12bfdf177a913a335157fb02096d4ec02867",
  "inner": {
    "LedgerUpdate": {
      "users": ["0x42be63db85e660e1cede260b10a66baae89bc3c8"],
      "delta": {
        "type": "deposit",
        "usdc": "100.0"
      }
    }
  }
}
Vault Deposit
{
  "time": "2025-11-05T10:02:31.473428017",
  "hash": "0x020bb6aec6dced660385042ee195a10201e8009461d00c38a5d4620185d0c750",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x945276fb8750c8ee5b86df4804903ce66b25eb59",
        "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
      ],
      "delta": {
        "type": "vaultDeposit",
        "vault": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
        "usdc": "10862.38"
      }
    }
  }
}
Vault Withdrawal
{
  "time": "2025-11-05T10:00:38.123241873",
  "hash": "0xba9bcc1734fd7ac2bc15042ee1903102104a00fccff099945e647769f3f154ad",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0xbbb9b4f5b99283da5538214e0b9ebe4ffd0a6895",
        "0x1e37a337ed460039d1b15bd3bc489de789768d5e"
      ],
      "delta": {
        "type": "vaultWithdraw",
        "vault": "0x1e37a337ed460039d1b15bd3bc489de789768d5e",
        "user": "0xbbb9b4f5b99283da5538214e0b9ebe4ffd0a6895",
        "requestedUsd": "2005.55655",
        "commission": "40.555655",
        "closingCost": "0.0",
        "basis": "1599.999999",
        "netWithdrawnUsd": "1965.000895"
      }
    }
  }
}
Sub-Account Transfer
{
  "time": "2025-11-05T10:00:28.697668509",
  "hash": "0x608e9b5851f0b0e96208042ee18fb3020190003decf3cfbb045746ab10f48ad4",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x407c578cc7c27d8df36633cd0a2531c14aa1ccd5",
        "0x56edf34cbfc2f46580654ca81ce6fdf8f06aed38"
      ],
      "delta": {
        "type": "subAccountTransfer",
        "usdc": "272.0",
        "user": "0x56edf34cbfc2f46580654ca81ce6fdf8f06aed38",
        "destination": "0x407c578cc7c27d8df36633cd0a2531c14aa1ccd5"
      }
    }
  }
}
Cross-Chain Withdrawal
{
  "time": "2025-11-05T10:00:09.060620743",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "inner": {
    "CWithdrawal": {
      "user": "0x12c4b5b36c7a2ba402cdc674b7a5b4328cb01fd3",
      "amount": "0.30258917",
      "is_finalized": true
    }
  }
}
Cross-Chain Deposit
{
  "time": "2025-11-05T10:15:42.264672394",
  "hash": "0xf240f9dd9eab7c85f3ba042ee1bc6702070f00c339ae9b589609a5305daf5670",
  "inner": {
    "CDeposit": {
      "user": "0xd93afcb4a933394963ab2a44c83de29073ae226a",
      "amount": "11.12345049"
    }
  }
}
Delegation
{
  "time": "2025-11-05T10:09:17.981652963",
  "hash": "0x2f96561601812a3a3110042ee1a9a402027c00fb9c84490cd35f0168c0850424",
  "inner": {
    "Delegation": {
      "user": "0x06c25dadfd91e721be33130135286db335571037",
      "validator": "0xb8f45222a3246a2b0104696a1df26842007c5bc5",
      "amount": "1.0",
      "is_undelegate": true
    }
  }
}
Rewards Claim
{
  "time": "2025-11-05T10:01:12.722447184",
  "hash": "0x546aff0681417b4155e4042ee191e702094900ec1c449a13f833aa594045552b",
  "inner": {
    "LedgerUpdate": {
      "users": ["0x364fc7e594e98f123829403889a6a2212583f58a"],
      "delta": {
        "type": "rewardsClaim",
        "amount": "18.40514403",
        "token": "USDC"
      }
    }
  }
}
Borrow/Lend
{
  "time": "2026-04-30T19:00:31.697926532",
  "hash": "0x7e02a2e402b113607f7c043a58dc4202037100c99db4323221cb4e36c1b4ed4b",
  "inner": {
    "LedgerUpdate": {
      "users": ["0x369b2a549f4a13e55a8b5cf44dd40ab5d3a23407"],
      "delta": {
        "type": "borrowLend",
        "token": "USDH",
        "operation": "withdraw",
        "amount": "30.01638115",
        "interestAmount": "0.0304756"
      }
    }
  }
}
Funding Rate Payment

Emitted once per hour. Each deltas entry is one user's funding payment or receipt for one coin.

{
  "time": "2026-04-30T19:00:00.030459967",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "inner": {
    "Funding": {
      "deltas": [
        {
          "user": "0x0000000000005e5ea32f577000677c0963279be4",
          "coin": "UNI",
          "funding_amount": "0.080012",
          "szi": "-2000.0",
          "funding_rate": "0.0000125"
        },
        {
          "user": "0x000000000005dfe874f01071d0e05f99178a5cfc",
          "coin": "HYPE",
          "funding_amount": "0.092948",
          "szi": "-190.0",
          "funding_rate": "0.0000125"
        }
      ]
    }
  }
}
Gossip Priority Gas Auction Fee

Deducted from the winning user's HYPE balance each time their node wins priority ordering in the gossip auction.

{
  "time": "2026-04-30T19:02:47.045403103",
  "hash": "0x298562a202dad0762aff043a58e40702012a00879dddef48cd4e0df4c1deaa60",
  "inner": {
    "LedgerUpdate": {
      "users": ["0xed047f2f15f2b29adece2c1da06ab7a872294f2c"],
      "delta": {
        "type": "gossipPriorityGasAuction",
        "token": "HYPE",
        "amount": "0.30773712"
      }
    }
  }
}
Gossip Priority Auction Restart

Fired at the start of each 60-second gossip priority auction slot. previous_winner and end_gas are null when the previous slot had no winner.

{
  "time": "2026-04-30T19:00:00.030459967",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "inner": {
    "GossipPriorityAuctionRestart": {
      "slot_id": 0,
      "previous_winner": {
        "Ip": "54.64.2.87"
      },
      "end_gas": "0.29863514"
    }
  }
}
Validator Rewards

Emitted periodically. Each entry in validator_to_reward is a [validator_address, reward_amount] pair denominated in HYPE.

{
  "time": "2026-05-14T17:11:00.068281708",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "inner": {
    "ValidatorRewards": {
      "validator_to_reward": [
        ["0x000000000056f99d36b6f2e0c51fd41496bbacb8", "0.22195639"],
        ["0x15458aed3c7a49b215fbfa863c6ff550c31e1a31", "0.21276594"],
        ["0x420a4ed7b6bb361da586868adec2f2bb9ab75e66", "1.02439927"]
      ]
    }
  }
}
Internal Transfer

System-initiated movement of USDC between two addresses. fee is the transfer fee charged (often "0.0").

{
  "time": "2026-04-20T13:49:17.688853211",
  "hash": "0xefca3a634935855af14304399487f4020a1f0048e438a42d9392e5b608395f45",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x88097bc9fa077e0ffd376b7d15b4edba4230ed9d",
        "0x9c40418597ea7c094e63881e54d0064af623434b"
      ],
      "delta": {
        "type": "internalTransfer",
        "usdc": "0.050143",
        "user": "0x88097bc9fa077e0ffd376b7d15b4edba4230ed9d",
        "destination": "0x9c40418597ea7c094e63881e54d0064af623434b",
        "fee": "0.0"
      }
    }
  }
}
Vault Leader Commission

Periodic commission payment credited to the vault leader's account.

{
  "time": "2026-05-07T22:05:36.611009382",
  "hash": "0x767d7d0c6c754ba177f7043ae201ff0208fc00f207786a731a46285f2b79258c",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x2b804617c6f63c040377e95bb276811747006f4b"
      ],
      "delta": {
        "type": "vaultLeaderCommission",
        "user": "0x2b804617c6f63c040377e95bb276811747006f4b",
        "usdc": "0.469963"
      }
    }
  }
}
Cross-Chain Staking Transfer

Records a HYPE bridge deposit (isDeposit: true) or withdrawal (isDeposit: false) for staking.

{
  "time": "2026-04-20T05:48:25.036652302",
  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0xc0858ba856626f207b50e98ff11406dbecdead05"
      ],
      "delta": {
        "type": "cStakingTransfer",
        "token": "HYPE",
        "amount": "10.00059776",
        "isDeposit": false
      }
    }
  }
}
Account Activation Gas

HYPE fee deducted when a new account is activated on-chain.

{
  "time": "2026-05-15T14:57:54.057017613",
  "hash": "0x358fca921369ed063709043b7612810204390077ae6d0bd8d95875e4d26dc6f0",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x96cc51652916dbf3bccff11cfe5b997dec908b5e"
      ],
      "delta": {
        "type": "accountActivationGas",
        "amount": "0.02283782",
        "token": "HYPE"
      }
    }
  }
}
Activate DEX Abstraction

Charged when a user activates DEX abstraction for a specific DEX. Seeds the user's DEX sub-account with the initial token amount.

{
  "time": "2026-05-15T14:33:18.925417570",
  "hash": "0x787e72403f0fbdc579f8043b75bf2c02026c0025da02dc971c471d92fe0397b0",
  "inner": {
    "LedgerUpdate": {
      "users": [
        "0x7ae8872b809eccf472ef1ca406462d5749a9ce03"
      ],
      "delta": {
        "type": "activateDexAbstraction",
        "dex": "xyz",
        "token": "USDC",
        "amount": "3.87"
      }
    }
  }
}

API Usage​

gRPC Streaming
// Subscribe to events
const request = {
  subscribe: {
    stream_type: 'EVENTS',
    filters: {
      user: { values: ['0x123...'] },
      type: { values: ['vaultWithdraw', 'deposit', 'withdraw'] }
    }
  }
};
JSON-RPC
# Get latest event blocks
curl -X POST https://your-endpoint.hype-mainnet.quiknode.pro/your-token/hypercore \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "hl_getLatestBlocks",
    "params": {
      "stream": "events",
      "count": 10
    },
    "id": 1
  }'
WebSocket
// Subscribe to events
ws.send(JSON.stringify({
  "jsonrpc": "2.0",
  "method": "hl_subscribe",
  "params": {
    "streamType": "events"
  },
  "id": 1
}));

Important Notes​


  • Balance reconciliation: Do not use EVENTS alone as a complete record of account balances. For example, protocol-level dexAbstraction collateral moves can change spot and per-DEX balances without a corresponding event or signed exchange action. Query clearinghouseState and spotClearinghouseState for current per-user state, or hl_batchPortfolioStates for multiple users. If you derive balances from activity, start from a state snapshot and reconcile against current state.
  • Multiple Users: Events can affect multiple users (shown in users array)
  • Hash Field: May be null hash (0x000...) for system events like funding payments and auction restarts
  • Cross-Chain Events: CDeposit and CWithdrawal events track bridge operations
  • Vault Operations: Include deposits, withdrawals, creation, and commission payments
  • System Events: Include account activation, DEX abstraction activation, reward claims, gossip priority gas auction fees, and lending protocol activity; not every automatic collateral move emits an event
  • Funding Events: Emitted once per hour; each deltas entry is one user's funding payment or receipt for one coin
  • Borrow/Lend: The borrowLend delta tracks on-chain lending protocol activity (borrowing or repaying USDC/USDH with interest); confirmed operation values include "withdraw" (taking borrowed funds)

  • Trades - See trading activity that may trigger balance changes
  • Orders - View order activity that may result in fee payments
  • Blocks - See the raw HyperCore transactions that generate these events
Last updated on