Hyperliquid operates two distinct networks under the same ecosystem:
-
Hyperliquid EVM — A fully EVM-compatible chain that supports the standard suite of EVM datasets including Block, Transactions, Logs, Receipts, and Traces. See the Ethereum & EVM Data Sources page for the full schema reference.
-
Hyperliquid Hypercore — Hyperliquid's native L1, purpose-built for high-performance trading. It uses a specialized data model with its own datasets tailored to order flow, market activity, and protocol events. The available datasets are documented below.
Block
The Block dataset is a composite dataset for Hypercore Mainnet that delivers all Hypercore activity types per block in a single payload. Each element in data corresponds to one block and includes every supported data type: events, orders, trades, book updates, TWAP events, and writer actions. Arrays are empty when no activity of that type occurred in the block.
The Streams block dataset is not the equivalent of the Hyperliquid gRPC blocks stream or replica_cmds. It is a convenience dataset that aggregates all Hypercore Streams datasets into a single per-block delivery, not a low-level replication feed.
JSON Spec
{
"data": [
{
"local_time": "2026-05-08T16:57:35.818386641",
"block_time": "2026-05-08T16:57:35.663766253",
"block_number": 988879584,
"events": [],
"orders": [],
"trades": [],
"book_updates": [],
"twap_events": [],
"writer_actions": []
}
],
"metadata": {
"batch_end_range": 988879584,
"batch_start_range": 988879584,
"blocks_reorged": null,
"data_size_bytes": 1005193,
"dataset": "block",
"end_range": 988879584,
"keep_distance_from_tip": 0,
"network": "hypercore-mainnet",
"reorgs": null,
"start_range": 988879584,
"stream_id": "067dff07-ca14-48d8-a7cc-a786a8945cbe",
"stream_name": "test-stream",
"stream_region": "usa_east"
}
}
Events
The data returned is an array of objects containing event data from Hypercore Mainnet. The Events dataset captures detailed event information including ledger updates, user activities, and other on-chain events. Each event includes metadata such as block number, block time, event hash, and inner event data.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
{
"time": "2025-11-05T16:09:18.466557521",
"hash": "0x4a3367a1c546233d4bad042ee5d5ba020b2a00876049420fedfc12f48449fd27",
"inner": {
"LedgerUpdate": {
"users": ["0x025a744111554e57c66ba2069a8081249fbe5e11"],
"delta": {
"type": "vaultWithdraw",
"vault": "0x1e37a337ed460039d1b15bd3bc489de789768d5e",
"requestedUsd": "7.203866",
"netWithdrawnUsd": "7.203866"
}
}
}
}
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
Orders
The data returned is an array of objects containing order data from Hypercore Mainnet. The Orders dataset captures detailed order information including order status, order details, user information, and transaction metadata. Useful for tracking trading activity, order placements, and order state changes.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
{
"time": "2025-12-04T17:00:00.268701903",
"user": "0xeb6eda4756f831824cd28e568ef8adcff35016e3",
"hash": "0x81598918a9303dff82d30430bf015102068e00fe44335cd12522346b683417ea",
"status": "open",
"order": {
"coin": "ZEC",
"side": "B",
"limitPx": "356.42",
"sz": "1.1",
"oid": 258166303284,
"orderType": "Limit",
"tif": "Gtc"
}
}
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
Events with Orders
The data returned is an array of objects combining on-chain events and order data per block. The Events with Orders dataset is a composite of the Events and Orders datasets, delivering both in a single payload — useful when you need to correlate protocol events with the order activity that triggered them.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
{
"time": "2025-11-05T16:09:18.466557521",
"hash": "0x4a3367a1c546233d4bad042ee5d5ba020b2a00876049420fedfc12f48449fd27",
"inner": {
"LedgerUpdate": {
"users": ["0x025a744111554e57c66ba2069a8081249fbe5e11"],
"delta": {
"type": "vaultWithdraw",
"vault": "0x1e37a337ed460039d1b15bd3bc489de789768d5e",
"requestedUsd": "7.203866",
"netWithdrawnUsd": "7.203866"
}
}
}
}
],
"orders": [
{
"time": "2025-12-04T17:00:00.268701903",
"user": "0xeb6eda4756f831824cd28e568ef8adcff35016e3",
"hash": "0x81598918a9303dff82d30430bf015102068e00fe44335cd12522346b683417ea",
"status": "open",
"order": {
"coin": "ZEC",
"side": "B",
"limitPx": "356.42",
"sz": "1.1",
"oid": 258166303284,
"orderType": "Limit",
"tif": "Gtc"
}
}
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
Trades
The data returned is an array of objects containing executed trade data (fills) from the Hyperliquid exchange. The Trades dataset captures detailed information about completed trades including price, size, side, fees, and position changes. Essential for tracking trading activity, analyzing market movements, and monitoring executed orders.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
[
"0x<user_address>",
{
"coin": "BTC",
"px": "92385.0",
"sz": "0.00361",
"side": "B",
"dir": "Open Long",
"closedPnl": "0.0",
"fee": "0.190767",
"feeToken": "USDC",
"tid": 1081368440085115
}
]
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
Book Updates
The data returned is an array of objects containing Level 2 order book updates (book_diffs) from the Hyperliquid exchange. The Book Updates dataset tracks every order placement, modification, and cancellation, showing incremental changes to the order book. Useful for building real-time order book visualizations, analyzing market depth, and monitoring liquidity changes.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
{
"user": "0x1c1c270b573d55b68b3d14722b5d5d401511bed0",
"oid": 258166296856,
"coin": "ETH",
"side": "B",
"px": "3167.4",
"raw_book_diff": {
"new": {
"sz": "1.5785"
}
}
}
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
TWAP
The data returned is an array of objects containing Time-Weighted Average Price (TWAP) order status updates from the Hyperliquid exchange. The TWAP dataset tracks algorithmic orders that execute gradually over a specified time period to minimize market impact. Useful for monitoring algorithmic trading strategies and order execution analytics.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
{
"time": "2025-12-04T17:00:22.417074898",
"twap_id": 1430699,
"state": {
"coin": "HYPE",
"user": "0x9d6a5ab97a8eed617bde9968d9ab6fcf72fde1b8",
"side": "A",
"sz": "108.36",
"executedSz": "0.0",
"minutes": 10,
"reduceOnly": false
},
"status": "activated"
}
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}
Writer Actions
The data returned is an array of objects containing system operations for spot token transfers. The Writer Actions dataset tracks automated asset movements and system-level transfers within Hyperliquid's ecosystem, including spot token transfers and system operations.
JSON Spec
{
"data": [
{
"block_number": 863437379,
"block_time": "2026-01-16T16:16:11.494479201",
"events": [
[
"0x200000000000000000000000000000000000012b",
{
"user": "0x200000000000000000000000000000000000012b",
"nonce": 33554479,
"action": {
"type": "SystemSpotSendAction",
"destination": "0x200000000000000000000000000000000000012b",
"token": 299,
"wei": "200000000000"
}
}
]
],
"local_time": "2026-01-16T16:16:11.774409420"
}
]
}