Events Dataset

Overview

The events stream contains comprehensive blockchain events from the Hyperliquid exchange, including balance changes, transfers, deposits, withdrawals, vault operations, cross-chain activities, and system operations.

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

Field	Type	Description
time	string	Event timestamp (ISO 8601)
hash	string	Transaction hash (may be null hash for some events)
inner	object	Inner event data - see Event Types below

Event Types

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

Event Type	Description	Key Operations
LedgerUpdate	Balance changes, transfers, and asset movements (most common event type)	Deposits, withdrawals, trades, vault operations
CWithdrawal	Cross-chain withdrawal events from Hyperliquid to other chains	Bridge withdrawals, finalization status
CDeposit	Cross-chain deposit events from other chains to Hyperliquid	Bridge deposits, incoming transfers
Delegation	Validator delegation and undelegation operations	Stake delegation, undelegation, validator changes
Funding	Funding rate payments for perpetual positions	Hourly funding payments, rate calculations
ValidatorRewards	Validator reward distributions and payouts	Block rewards, commission distributions
GossipPriorityAuctionRestart	Fired at the start of each gossip priority gas auction slot; records the previous winner and ending gas amount	Slot 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 Type	Description	Common Use Cases
send	Direct USDC or token transfer between wallets (fields: user, destination, token, amount, sourceDex, destinationDex, usdcValue, fee, nativeTokenFee, nonce, feeToken)	P2P payments, gifts
spotTransfer	Spot token transfer between wallets (fields: token, amount, usdcValue, user, destination, fee, nativeTokenFee, nonce, feeToken)	Token exchanges
accountClassTransfer	Moving funds between spot and perpetual accounts (fields: usdc, toPerp)	Cross-margin moves
subAccountTransfer	Transfers between main and sub-accounts (fields: usdc, user, destination)	Account organization
internalTransfer	System-initiated internal movements (fields: usdc, user, destination, fee)	Automated rebalancing
spotGenesis	Initial 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 Type	Description	Common Use Cases
withdraw	User-initiated withdrawals from Hyperliquid (fields: usdc, nonce, fee)	Cashing out, moving to other platforms
deposit	User 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 Type	Description	Common Use Cases
vaultDeposit	User deposits funds into managed vaults (fields: vault, usdc)	Passive investment
vaultWithdraw	User withdraws funds from managed vaults (fields: vault, user, requestedUsd, commission, closingCost, basis, netWithdrawnUsd)	Profit taking, exit
vaultCreate	Creation of new investment vaults (fields: vault, usdc)	New fund launches
vaultDistribution	Vault distributes profits or assets to depositors (fields: vault, usdc)	Profit distributions, yield payouts
vaultLeaderCommission	Commission payment to the vault leader (fields: user, usdc)	Performance fees

Cross-Chain Operations

These operations facilitate interactions between Hyperliquid and other blockchain networks.

Delta Type	Description	Common Use Cases
cStakingTransfer	Cross-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 Type	Description	Common Use Cases
borrowLend	Borrow or repay from the on-chain lending protocol (fields: token, operation, amount, interestAmount)	USDH/USDC borrowing, loan repayments
rewardsClaim	Users claiming accumulated rewards or incentives (fields: amount, token)	Staking rewards, referrals
accountActivationGas	Gas fee charged in HYPE to activate a new account (fields: amount, token)	Onboarding costs
activateDexAbstraction	Enables DEX abstraction, seeding the DEX with initial funds (fields: dex, token, amount)	Pro trading features
gossipPriorityGasAuction	Gas 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.

Delta Type	Description	Common Use Cases
ledgerLiquidation	Forced 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({
  "method": "hl_subscribe",
  "params": {
    "streamType": "events"
  }
}));

Important Notes

Comprehensive Coverage: This stream captures all balance-affecting operations on the platform
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, reward claims, gossip priority gas auction fees, and lending protocol activity
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

Overview​

Data Structure​

Event Fields​

Event Types​

Event Type Distribution​

LedgerUpdate Delta Types​

Transfer Operations​

Deposit/Withdrawal Operations​

Vault Operations​

Cross-Chain Operations​

System Operations​

Liquidation Operations​

Example Events​

API Usage​

Important Notes​

Related Streams​