Hyperliquid

Hyperliquid L4 Data

Six-feed Hyperliquid stack. Direct from Tokyo. No blocks in the path.

In a hyper-fast decentralized market, an enormous amount of order book activity happens between block confirmations. Order placements, cancellations, amendments, liquidity pulls, and executions can occur long before a block is finalized.

CoinAPI does not stream by block. We deliver raw, unaggregated Hyperliquid L4 order and trade mutations in real time, and complement them with oracle, TWAP, and raw node event feeds over the same WS DS source.

6 Feed Families
No Delays
Direct from Tokyo
Raw L4 Data
Absolute Real-Time
WS DS + Flat Files
Hyperliquid L4

The Architectural Edge

Zero Block Interlacing

We don't throttle, sample, aggregate, or wait for blocks to bundle data.

Every single order placement, modification, cancellation, rejection, partial fill, and execution is streamed instantly as it occurs.

For latency-sensitive strategies, waiting for blocks means observing history. CoinAPI delivers the market as it evolves.

Sourced Directly in Tokyo

Hyperliquid's consensus engine lives in Tokyo, Japan.

CoinAPI captures the feed directly from the source and hot-routes L4 data to customers with minimal infrastructure hops.

The result is a cleaner latency profile, lower propagation delay, and faster visibility into order book changes across the network.

Dual Delivery: Real-Time WebSockets & S3 Flat Files

Consume low-latency live feeds through dedicated WebSocket DS infrastructure and access historical Hyperliquid L4 datasets through hourly refreshed CSV.gz flat files hosted on AWS S3.

Both delivery methods use aligned field naming conventions and symbol identifiers, while preserving format-specific message envelopes.

No data model conversions. No separate ingestion logic. No code rewrites when moving from backtesting to production.

Feed Architecture

Designed for Incremental Adoption

One Endpoint, Six Feed Families

Connect once to the dedicated Hyperliquid WS DS endpoint and subscribe to order book, trade, oracle, TWAP, misc, and system feeds in a single session.

This design reduces integration complexity and keeps all Hyperliquid real-time streams in one transport channel with aligned identifiers.

Teams can start from `book_l4` and `trade_l4`, then progressively enable enrichment and raw event feeds as analytics requirements grow.

Symbol vs Exchange Scope

Symbol-level streams (`book_l4`, `trade_l4`, `hl_oracle_prices`, `hl_twap_statuses`) map naturally to pair-level processing and strategy engines.

Exchange-level streams (`hl_misc_events`, `hl_system_events`) deliver block-linked raw envelopes designed for observability and audit workflows.

The split lets you optimize high-frequency symbol pipelines separately from lower-frequency exchange event consumers.

Backtest-to-Production Continuity

CoinAPI exposes both real-time WebSocket DS streams and historical flat files for Hyperliquid with aligned field naming conventions.

Research and production systems can share schema contracts and validation logic instead of maintaining separate data adapters.

This reduces model drift risk and speeds up deployment cycles for quant and execution teams.

Level 4 Data

What Is Level 4 (L4) Data?

Most cryptocurrency market data feeds aggregate liquidity into price levels, hiding the actual mechanics of the matching engine. Level 4 (L4) data is different.

L4 is an unaggregated, individual order stream where every resting order is treated as a unique entity. Instead of seeing total volume at a price level, you see the actual orders that create that liquidity.

Each order can be tracked throughout its complete lifecycle:

Placement
Modification
Partial execution
Cancellation
Full fill

DeFi Wallet Tracking

Every passive resting order and trade match includes the public Ethereum or Hyperliquid wallet address associated with the participant.

  • Whale tracking
  • Wallet behavior analysis
  • Liquidity provider monitoring
  • Institutional flow research
  • Market participant attribution

Persistent Order Identifiers

Unique exchange-assigned order IDs allow traders to follow specific orders throughout their lifecycle.

  • Track queue positions
  • Observe order persistence
  • Analyze cancellations
  • Map fills directly

Advanced State Parameters

CoinAPI exposes detailed order metadata including:

  • Time-In-Force (tif)
  • Reduce-Only flags (reduce_only)
  • Trigger prices (trigger_px)
  • Trigger conditions
  • Take-profit and stop-loss metadata
  • Parent-child bracket order relationships (children_oids)
Market Data Levels

Hyperliquid Market Data Levels: L1 vs L2 vs L3 vs L4

Understanding the differences between market data tiers helps explain why professional trading firms increasingly rely on Level 4 feeds.

Data DepthStructural GranularityCore Metadata VisiblePrimary Technical Use CaseNetwork Profile
Level 1 (L1)Top of BookBest Bid/Ask (BBO)Portfolio valuation, chart rendering, retail tradingUltra-Low
Level 2 (L2)Aggregated DepthVolume grouped by price levelLiquidity mapping, execution routingLow to Medium
Level 3 (L3)Individual QueueSeparate orders without participant attributionQueue modeling, order arrival analysisHigh
Level 4 (L4)Full Flow & IdentityIndividual orders, wallet addresses, lifecycle updates, maker/taker attributionHFT, market making, whale tracking, order flow analysis, microstructure researchUltra-High

Level 4 provides the closest possible representation of the matching engine and exposes the information hidden by aggregated order book feeds.

Feed Topology

Hyperliquid WS DS Feed Scope and Semantics

Use one endpoint with multiple feed families and align downstream consumers by data scope and latency profile.

FeedScopeEmission UnitCore Data SurfaceTypical Consumer
book_l4symbol-scopedPer trading pairOrder-level resting liquidity, order lifecycle, bracket relationshipsMicrostructure, queue reconstruction, execution simulation
trade_l4symbol-scopedPer trading pairExecuted trades with taker/maker wallet attributionOrder flow analysis, participant behavior, toxic-flow detection
hl_oracle_pricessymbol/coin-scopedPer coin updateOracle/mark/external perp prices, daily refs, input components, update classRisk controls, divergence monitoring, funding and liquidation modeling
hl_twap_statusessymbol/coin-scopedPer TWAP idTWAP lifecycle and progress fields (status, executed size/notional, flags)Execution monitoring, quality benchmarking, TWAP analytics
hl_misc_eventsexchange-scopedPer exchange eventRaw event envelope with block number, event type, JSON payloadAudit pipelines, low-level event observability, custom parsers
hl_system_eventsexchange-scopedPer exchange eventRaw system action envelope with block number, action type, JSON payloadSystem-action tracking, controls and policy monitoring

Symbol-scoped feeds are optimized for strategy and execution pipelines. Exchange-scoped feeds are optimized for observability, audit, and custom event processing.

Microstructure

Exploiting Hyperliquid Microstructure Anomalies

Production data captured across the Hyperliquid ecosystem highlights why unaggregated L4 data is required to understand market behavior.

88%

The 88% Rejection Threshold

Approximately 88% of all submitted orders result in an immediate rejection event, often from aggressive Add Liquidity Only strategies.

98.9%

The Cancellation Churn

Of the orders that successfully reach the book, approximately 98.9% are eventually canceled.

1.1%

The 1.1% Reality

Only around 1.1% of submitted orders ultimately result in a completed fill.

Integration

Technical Integration Specifications

Real-Time WebSocket DS Stream — a dedicated low-latency endpoint:

wss://hyperliquidl4.ws-ds.md.coinapi.io/

Use symbol filters for symbol-scoped feeds (`book_l4`, `trade_l4`, `hl_oracle_prices`, `hl_twap_statuses`). Exchange-level feeds (`hl_misc_events`, `hl_system_events`) can also be consumed without symbol filters.

Example Subscription
{
  "type": "hello",
  "heartbeat": false,
  "subscribe_data_type": [
    "book_l4",
    "trade_l4",
    "hl_oracle_prices",
    "hl_twap_statuses",
    "hl_misc_events",
    "hl_system_events"
  ],
  "subscribe_filter_symbol_id": [
    "HYPERLIQUIDL4_PERP_BTC_USDC",
    "HYPERLIQUIDL4_PERP_ETH_USDC",
    "HYPERLIQUIDL4_SPOT_SOL_USDC"
  ],
  "subscribe_update_limit_ms_quote": 0
}
Data Types

Available Hyperliquid Data Types

book_l4

Full Level 4 order book snapshots and incremental updates. An initial snapshot is delivered upon subscription, followed by continuous incremental updates.

  • Order ID
  • Price
  • Size
  • User wallet address
  • Update type
  • Time-In-Force
  • Reduce-Only flag
  • Trigger metadata
  • Parent-child order relationships

trade_l4

Executed Hyperliquid transactions with participant attribution for sophisticated order flow analysis and counterparty research.

  • Execution price
  • Executed size
  • Taker side
  • Maker wallet address
  • Taker wallet address
  • Order identifiers
  • Exchange transaction identifiers

hl_oracle_prices

Per-coin oracle and mark price enrichment stream with daily references and source input components.

  • coin_id
  • update_class
  • mark/oracle prices
  • daily reference values
  • external perp values
  • input price components

hl_twap_statuses

TWAP lifecycle stream with execution progress, completion states, and execution attributes.

  • twap_id
  • coin
  • side and status
  • executed size and notional
  • reduce_only and randomize flags
  • order_timestamp_ms

hl_misc_events

Exchange-level raw misc event stream normalized into envelope fields for low-level observability.

  • exchange_id
  • block_number
  • event_type
  • json_payload
  • raw exchange context

hl_system_events

Exchange-level raw system event stream with block-linked metadata and original payloads.

  • exchange_id
  • block_number
  • event_type
  • json_payload
  • system action visibility
Use Cases

What Can You Do With Hyperliquid L4 Data?

Level 4 data enables analysis that is impossible with traditional Level 1 and Level 2 feeds — a direct view into how liquidity actually behaves rather than how it appears after aggregation.

  • Reconstruct the complete order book
  • Track individual order lifecycles
  • Analyze cancellation behavior
  • Measure order arrival rates
  • Monitor liquidity creation and withdrawal
  • Detect large participant activity
  • Calculate queue position dynamics
  • Study stop-loss and take-profit activity
  • Analyze execution quality
  • Build market microstructure models
Quant Research

Built for Quantitative Trading, Market Making, and Research

Because CoinAPI provides both real-time and historical datasets, teams can build, test, and deploy strategies using a single data source throughout the entire development lifecycle.

  • Order flow analysis
  • Market microstructure research
  • Queue position modeling
  • Market making strategy development
  • Whale wallet tracking
  • Liquidity forecasting
  • Execution quality analysis
  • Toxic flow detection
  • Historical backtesting
  • Machine learning model training
Advanced Workflows

Where the New Hyperliquid Feeds Add Alpha

Beyond classic L4 reconstruction, oracle, TWAP, and raw event streams unlock richer execution intelligence and cross-signal diagnostics.

  • Build liquidation-risk monitors from mark-oracle spread dynamics
  • Track TWAP completion quality and slippage progression per wallet
  • Correlate raw system actions with order-book and trade state transitions
  • Detect regime shifts from oracle update-class and input-source behavior
  • Enrich surveillance models with block-number-linked raw payload evidence
  • Generate deterministic replay streams for execution simulation environments
Documentation

Implementation References

Use the WebSocket DS Hyperliquid documentation for message contracts, enums, and integration examples across all six feed families.

WS DS GeneralWS DS HyperliquidWS DS MessagesEndpoint Matrix
Why CoinAPI for Hyperliquid L4 Data?

Capture the Complete Order Lifecycle as It Happens

Instead of reconstructing market activity after the fact, CoinAPI exposes every order placement, modification, cancellation, partial fill, and execution with the highest level of transparency available on Hyperliquid.

  • Six real-time Hyperliquid feed families in one WS DS source
  • Historical Hyperliquid L4 archives
  • Unified schema for live streams and historical files
  • Direct sourcing from Hyperliquid's Tokyo consensus region

The result is a single platform for capturing, storing, researching, and deploying strategies based on the most granular Hyperliquid market data available.