Hyperliquid Spot wire format
This page shows how Hyperliquid spot messages become rows in our Parquet files. For each data type below, you see a real message next to the rows that we publish for it. The page also gives the source and the rule for each column. Put the pointer on a line or a column to see how they connect.
Checked against our pipeline
We recorded these messages from Hyperliquid spot on 2026-10-05. Our test suite replays each message through the production collector parser and the postprocessor. The test fails if the published rows are different from the rows on this page. Files that we wrote before a change to the pipeline can be different. Refer to Known Gaps & Corrections.
Spot subscriptions have "spot": true. Hyperliquid identifies most spot markets as @<index> (HYPE/USDC is @107). We publish them with the pair name and _, for example HYPE_USDC. The examples use PURR/USDC. This is the only spot market that Hyperliquid names by its pair.
- Public WebSocket:
wss://api.hyperliquid.xyz/ws - Info REST (market metadata):
https://api.hyperliquid.xyz/info
Exchange API reference: hyperliquid.gitbook.io. For the conventions that apply to all exchanges, refer to the wire formats overview.
Trades
One row per fill from the trades subscription for each market.
- WebSocket trades
Trade
{"channel": "trades","data": [{"coin": "PURR/USDC",→ symbol"side": "A",→ is_buyer_maker"px": "0.15967",→ price"sz": "1055.0",→ quantity"time": 1791228472658,→ event_time · trade_time"hash": "0x10fa35a3dfc5ea3512730445ea37be0201fe00897ac90907b4c2e0f69ec9c41f","tid": 816377306689042,→ trade_id"users": ["0x9266865bb6afb4c4f618544dd3b8c970f17aa664", "0xc6df8428e2b9bade2485e9733da37f423b7238aa"]}]}
Published row
event_time is equal to trade_time._ in place of /. Hyperliquid names spot markets @<index> (HYPE/USDC is @107), except PURR/USDC. The collector uses spotMeta to find the base and quote token names for each index.tid is a hash of the order IDs of the buyer and the seller. It is not a sequence number. It does not increase, and you cannot use it to find gaps.side is the aggressor side. A (ask, the seller was the aggressor) gives true. B (bid, the buyer was the aggressor) gives false.market. Hyperliquid does not send an order type. This constant identifies the row as a taker fill.Recent trades sent after a subscription
The first trades message after a subscription repeats the latest 30 trades of the market. On quiet markets, these trades can be hours or months old. This message came 46 seconds after the start of the hour. We discard trades with a time more than 5 seconds before the start of the hour. We publish trades from the last 5 seconds of the previous hour in this hour, if that hour did not already publish them.
Shortened: The message contained 30 trades: 4 from more than 5 seconds before the hour, 4 from the last 5 seconds of the previous hour and 22 from this hour. This example shows two of each.
{"channel": "trades","data": [{"coin": "PURR/USDC",→ symbol"side": "B",→ is_buyer_maker"px": "0.15543",→ price"sz": "80.0",→ quantity"time": 1791230361434,→ event_time · trade_time"hash": "0xf08ba9f8823c8bb8f2050445eaa01e0201dd00de1d3faa8b9454554b413065a3","tid": 586859438661648,→ trade_id"users": ["0x19ae423cbb2b06701a64896d12bb318e26e3e64f", "0x2ad22b8c322e3322461aa339f60193576aa34698"]},{"coin": "PURR/USDC",→ symbol"side": "B",→ is_buyer_maker"px": "0.15536",→ price"sz": "321.0",→ quantity"time": 1791230362732,→ event_time · trade_time"hash": "0xffcb89c730ed035b01450445eaa03102036100accbe0222ea3943519efe0dd46","tid": 270882739007052,→ trade_id"users": ["0xa5954b9a62ecde4a077c8c12ab66c8093917fde0", "0x9266865bb6afb4c4f618544dd3b8c970f17aa664"]},{"coin": "PURR/USDC",→ symbol"side": "A",→ is_buyer_maker"px": "0.1549",→ price"sz": "644.0",→ quantity"time": 1791230397375,→ event_time · trade_time"hash": "0xf58f8171d9341951f7090445eaa22402042f00577437382499582cc49837f33c","tid": 344755378042620,→ trade_id"users": ["0x9266865bb6afb4c4f618544dd3b8c970f17aa664", "0xc5549b1aac5a98a9f4bebe37cc70cd48c064d514"]},{"coin": "PURR/USDC",→ symbol"side": "B",→ is_buyer_maker"px": "0.155",→ price"sz": "1124.0",→ quantity"time": 1791230397912,→ event_time · trade_time"hash": "0x132c735ed531f0db14a60445eaa22b02058c004470350fadb6f51eb19435cac5","tid": 1123349272790135,→ trade_id"users": ["0xc6df8428e2b9bade2485e9733da37f423b7238aa", "0x9266865bb6afb4c4f618544dd3b8c970f17aa664"]},{"coin": "PURR/USDC",→ symbol"side": "A",→ is_buyer_maker"px": "0.1549",→ price"sz": "35.0",→ quantity"time": 1791230400602,→ event_time · trade_time"hash": "0xeceeb6ef08083168ee680445eaa24e02125200d4a30b503a90b76241c70c0b53","tid": 359068625617933,→ trade_id"users": ["0x9266865bb6afb4c4f618544dd3b8c970f17aa664", "0xd440715f2ce6f7ed1924f282e0096c863e7049f7"]},{"coin": "PURR/USDC",→ symbol"side": "A",→ is_buyer_maker"px": "0.15489",→ price"sz": "199.0",→ quantity"time": 1791230400602,→ event_time · trade_time"hash": "0xeceeb6ef08083168ee680445eaa24e02125200d4a30b503a90b76241c70c0b53","tid": 252307041241746,→ trade_id"users": ["0x50fef8d71afce6404d0cbb2a8bb0df65f87b1685", "0xd440715f2ce6f7ed1924f282e0096c863e7049f7"]}]}
Published rows · 4
event_time is equal to trade_time._ in place of /. Hyperliquid names spot markets @<index> (HYPE/USDC is @107), except PURR/USDC. The collector uses spotMeta to find the base and quote token names for each index.tid is a hash of the order IDs of the buyer and the seller. It is not a sequence number. It does not increase, and you cannot use it to find gaps.side is the aggressor side. A (ask, the seller was the aggressor) gives true. B (bid, the buyer was the aggressor) gives false.market. Hyperliquid does not send an order type. This constant identifies the row as a taker fill.Notes
- We do not publish
hashandusers(the addresses of the buyer and the seller). Some fills have ahashthat is all zeros. - One message can contain several fills of one taker order (with the same
time,sideandhash). Each fill is a separate row with its owntid. - After each subscription, Hyperliquid first sends the most recent trades of the market (about 30), also if they are old. It does not identify them as a replay. After a reconnect, the collector discards the replayed trades that it already wrote. The postprocessor discards trades with a time more than 5 seconds before the start of the hour of the file. It also discards exact duplicates and trades that we already published in an earlier hour.
- Before the 2026-09 data-integrity release, we could publish a replayed trade again in the file of a later hour. To remove duplicates from older history, use (
symbol,trade_id,trade_time) as the key. Hyperliquid documentation states thattidis unique only together with the coin and the time.
For the column types and descriptions, refer to the Trades schema.
Order Book
One row per price level of each l2Book snapshot.
- WebSocket l2Book
Each l2Book message is a full snapshot of the top of the order book, not a delta. Each message becomes one snapshot row for each level.
Shortened: Hyperliquid sent 20 bid levels and 20 ask levels. This example shows the best 3 of each.
{"channel": "l2Book","data": {"coin": "PURR/USDC",→ symbol"time": 1791227881323,→ event_time · transaction_time · final_update_id · last_update_id"levels": [[→ side{→ side"px": "0.15963",→ side · price"sz": "1000.0",→ side · quantity"n": 1→ side · order_count},{→ side"px": "0.15962",→ side · price"sz": "2165.0",→ side · quantity"n": 3→ side · order_count},{→ side"px": "0.15952",→ side · price"sz": "1263.0",→ side · quantity"n": 1→ side · order_count}],[→ side{→ side"px": "0.15983",→ side · price"sz": "2879.0",→ side · quantity"n": 2→ side · order_count},{→ side"px": "0.15985",→ side · price"sz": "103.0",→ side · quantity"n": 1→ side · order_count},{→ side"px": "0.15998",→ side · price"sz": "610.0",→ side · quantity"n": 1→ side · order_count}]]}}
Published rows · 6
time. Milliseconds._ in place of /. Hyperliquid names spot markets @<index> (HYPE/USDC is @107), except PURR/USDC. The collector uses spotMeta to find the base and quote token names for each index.snapshot for every l2Book message.time of the snapshot. Hyperliquid has no update ID, thus the time identifies the snapshot.time of the snapshot, as in final_update_id.bid for levels in levels[0], ask for levels in levels[1]. One row per level.Notes
- Each snapshot replaces the full order book. Rebuild your order book from the rows of each
final_update_id. A snapshot contains a maximum of 20 levels for each side, at full price precision. Hyperliquid documentation gives a maximum of one push each 0.5 seconds. In October 2026, the snapshots of a market come about every 5.4 seconds (about 670 per hour). - For a snapshot with no bid levels and no ask levels, we publish one row with
sidenoopand withpriceandquantity0. This row clears the order book. Files that we wrote before the October 2026 pipeline update have no row for an empty snapshot. - If a snapshot has a level with a zero, negative or unparsable price or size, we do not publish any part of the snapshot. We do not publish it as a partial order book. Before the October 2026 pipeline update, we could publish such a snapshot as a partial or empty order book.
- A file can start with a checkpoint snapshot of the order book that continues from the previous hour. In this snapshot,
received_timeis the start of the hour andtransaction_timeis null.event_time,final_update_idandlast_update_idare thetimeof the snapshot that the order book came from.
For the column types and descriptions, refer to the Order Book schema.
Mark Price
One row per activeSpotAssetCtx message for each market.
- WebSocket activeSpotAssetCtx
The collector subscribes to activeAssetCtx for each spot market. Hyperliquid sends the response on the activeSpotAssetCtx channel.
{"channel": "activeSpotAssetCtx","data": {"coin": "PURR/USDC",→ symbol"ctx": {"prevDayPx": "0.17128","dayNtlVlm": "2160182.4432799988","markPx": "0.15971",→ mark_price"midPx": "0.159735","circulatingSupply": "594788239.0212099552","coin": "PURR/USDC","totalSupply": "594788250.3277299404","dayBaseVlm": "12955450.0"}}}
Published row
received_time / 1,000,000). Asset contexts have no exchange timestamp._ in place of /. Hyperliquid names spot markets @<index> (HYPE/USDC is @107), except PURR/USDC. The collector uses spotMeta to find the base and quote token names for each index.markPx is missing, we use midPx.oraclePx).Notes
- Hyperliquid does not document the frequency of spot asset context pushes. In October 2026, a push comes about one time each second, thus a market has about 3,500 rows per hour. Each push becomes a row, also if no value changed.
- We do not publish the 24h fields (
prevDayPx,dayNtlVlm,dayBaseVlm),midPx(we use it only ifmarkPxis missing),circulatingSupplyandtotalSupply. - If a context has no
markPxand nomidPx, we do not publish it. - In files that we wrote before the October 2026 pipeline update,
event_timeis in nanoseconds (the receive clock, equal toreceived_time). Divide those values by 1,000,000.
For the column types and descriptions, refer to the Mark Price schema.
Not published
- Ticker: Hyperliquid has no 24h ticker channel. We do not publish the 24h fields of the asset contexts.
- Open Interest: Spot markets have no open interest.
- Liquidations: Spot markets have no liquidations.