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 17 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 17 delta types are organized into five 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 transfers between user wallets	P2P payments, gifts
spotTransfer	Transfers involving spot market tokens	Token exchanges
accountClassTransfer	Moving funds between spot and perpetual accounts	Cross-margin moves
subAccountTransfer	Transfers between main and sub-accounts	Account organization
internalTransfer	System-initiated internal movements	Automated rebalancing

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	Cashing out, moving to other platforms
deposit	User deposits into Hyperliquid accounts	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	Passive investment
vaultWithdraw	User withdraws funds from managed vaults	Profit taking, exit
vaultCreate	Creation of new investment vaults	New fund launches
vaultLeaderCommission	Commission payments to vault managers	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
borrowLend	Borrow or repay from the lending protocol (fields: token, operation, amount, interestAmount)	USDH borrowing, lending repayments

System Operations

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

Delta Type	Description	Common Use Cases
rewardsClaim	Users claiming accumulated rewards or incentives	Staking rewards, referrals
accountActivationGas	Gas fees for activating new accounts	Onboarding costs
activateDexAbstraction	Enabling advanced DEX abstraction features	Pro trading features
gossipPriorityGasAuction	Gas auction for gossip priority — system fee for priority transaction ordering	Priority transaction ordering

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"
    }
  }
}

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, and gossip priority gas auction fees
• 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 USDH lending protocol activity (borrows and repayments with interest)

Related Streams

• 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