Ir al contenido principal

Hyperliquid Data Source – Streams

Actualizado el
20 de julio de 2026

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.

Bloque

El Bloque dataset is a composite dataset for Hypercore Mainnet that delivers all Hypercore activity types per block in a single payload. Each element in datos 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.


Not the same as the Hyperliquid gRPC blocks stream

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

Eventos

The data returned is an matriz of objects containing event data from Hypercore Mainnet. The Eventos 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"
}
]
}

Pedidos

The data returned is an matriz of objects containing order data from Hypercore Mainnet. The Pedidos 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 matriz of objects combining on-chain events and order data per block. The Events with Orders dataset is a composite of the Eventos y Pedidos 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"
}
]
}

Oficios

The data returned is an matriz of objects containing executed trade data (fills) from the Hyperliquid exchange. The Oficios 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"
}
]
}

Novedades sobre el libro

The data returned is an matriz of objects containing Level 2 order book updates (diferencias_entre_libros) from the Hyperliquid exchange. The Novedades sobre el libro 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 matriz 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"
}
]
}

Acciones del escritor

The data returned is an matriz of objects containing system operations for spot token transfers. The Acciones del escritor 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"
}
]
}