Exchange Wire Formats

Hyperliquid Futures wire format

This page shows how Hyperliquid perpetuals 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 perpetuals 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.

The collector covers all listed perpetual markets. This includes builder-deployed dexes. Their coins have a dex prefix, for example xyz:XYZ100. All examples use BTC.

  • 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 coin.

  • WebSocket trades

Trade

WebSocket message · tradesreceived 2026-10-05 19:16:37.523305 UTC
{
"channel": "trades",
"data": [
{
"coin": "BTC",
"side": "A",
"px": "85628.0",
"sz": "0.00046",
"time": 1791227797187,
"hash": "0x2e861874c0b73d972fff0445ea12f4020157005a5bba5c69d24ec3c77fbb1781",
"tid": 910713520736797,
"users": ["0x368a9c423d0ce3d9887950125b1db4bb306c1b7d", "0x2332a66e6bdf9606d2fd63eed619357536612d4d"]
}
]
}

Published row

received_time1791227797523305000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Hyperliquid does not send this value.
event_time1791227797187data[].timeCopied. Milliseconds. Hyperliquid sends one time for each trade, thus event_time is equal to trade_time.
symbolBTCdata[].coinCopied. We change main-dex coins to upper case (we publish kPEPE as KPEPE). Builder-dex coins, for example xyz:XYZ100, keep their case.
trade_id910713520736797data[].tidCopied. The Hyperliquid 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.
price85628.0data[].pxCopied as the exact decimal string that Hyperliquid sent.
quantity0.00046data[].szCopied as the exact decimal string. Base asset units.
trade_time1791227797187data[].timeCopied. Milliseconds.
is_buyer_makertruedata[].sideside is the aggressor side. A (ask, the seller was the aggressor) gives true. B (bid, the buyer was the aggressor) gives false.
order_typemarket—Always market. Hyperliquid does not send an order type. This constant identifies the row as a taker fill.

One taker order, several fills

If a taker order fills against several resting orders, it comes as one message with one element for each fill.

Shortened: The message contained 39 fills. This example shows the first three.

WebSocket message · tradesreceived 2026-10-05 19:16:39.732583 UTC
{
"channel": "trades",
"data": [
{
"coin": "BTC",
"side": "B",
"px": "85629.0",
"sz": "0.0009",
"time": 1791227799116,
"hash": "0x55b2f804bb3995b3572c0445ea130d02030200ea563cb485f97ba3577a3d6f9d",
"tid": 590087756771268,
"users": ["0xe60a6f40ad907263441fe89236bb67b1a47683dc", "0x4c6988b39fc0904628c2959e7606ef5f8518c152"]
},
{
"coin": "BTC",
"side": "B",
"px": "85629.0",
"sz": "0.00064",
"time": 1791227799116,
"hash": "0x55b2f804bb3995b3572c0445ea130d02030200ea563cb485f97ba3577a3d6f9d",
"tid": 775060480000248,
"users": ["0xe60a6f40ad907263441fe89236bb67b1a47683dc", "0x338e1b3dbdd72c6601a99e34f2ec6881b89d9c8d"]
},
{
"coin": "BTC",
"side": "B",
"px": "85629.0",
"sz": "0.00064",
"time": 1791227799116,
"hash": "0x55b2f804bb3995b3572c0445ea130d02030200ea563cb485f97ba3577a3d6f9d",
"tid": 146242069110799,
"users": ["0xe60a6f40ad907263441fe89236bb67b1a47683dc", "0xf86a91bda299b36c7d4fc8a7b57f5e32c34e748f"]
}
]
}

Published rows · 3

received_time1791227799732583000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Hyperliquid does not send this value.
event_time1791227799116data[].timeCopied. Milliseconds. Hyperliquid sends one time for each trade, thus event_time is equal to trade_time.
symbolBTCdata[].coinCopied. We change main-dex coins to upper case (we publish kPEPE as KPEPE). Builder-dex coins, for example xyz:XYZ100, keep their case.
trade_id590087756771268data[].tidCopied. The Hyperliquid 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.
price85629.0data[].pxCopied as the exact decimal string that Hyperliquid sent.
quantity0.0009data[].szCopied as the exact decimal string. Base asset units.
trade_time1791227799116data[].timeCopied. Milliseconds.
is_buyer_makerfalsedata[].sideside is the aggressor side. A (ask, the seller was the aggressor) gives true. B (bid, the buyer was the aggressor) gives false.
order_typemarket—Always market. Hyperliquid does not send an order type. This constant identifies the row as a taker fill.

Notes

  • We do not publish hash and users (the addresses of the buyer and the seller). Some fills have a hash that is all zeros.
  • One message can contain several fills of one taker order (with the same time, side and hash). Each fill is a separate row with its own tid.
  • 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 that tid is 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.

WebSocket message · l2Bookreceived 2026-10-05 19:16:37.268427 UTC
{
"channel": "l2Book",
"data": {
"coin": "BTC",
"time": 1791227796735,
"levels": [
[
{
"px": "85628.0",
"sz": "5.71229",
"n": 19
},
{
"px": "85627.0",
"sz": "0.005",
"n": 1
},
{
"px": "85626.0",
"sz": "0.75919",
"n": 1
}
],
[
{
"px": "85629.0",
"sz": "4.37963",
"n": 39
},
{
"px": "85630.0",
"sz": "0.58198",
"n": 23
},
{
"px": "85631.0",
"sz": "3.85701",
"n": 9
}
]
]
}
}

Published rows · 6

received_time1791227797268427000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Hyperliquid does not send this value.
event_time1791227796735data.timeCopied. Milliseconds.
transaction_time1791227796735data.timeCopied from the same time. Milliseconds.
symbolBTCdata.coinCopied. We change main-dex coins to upper case (we publish kPEPE as KPEPE). Builder-dex coins, for example xyz:XYZ100, keep their case.
event_typesnapshot—snapshot for every l2Book message.
first_update_idnull—Null. Hyperliquid order books have no update IDs.
final_update_id1791227796735data.timeThe time of the snapshot. Hyperliquid has no update ID, thus the time identifies the snapshot.
prev_final_update_idnull—Null. Snapshots do not chain.
last_update_id1791227796735data.timeThe time of the snapshot, as in final_update_id.
sidebiddata.levels[0]data.levels[1]bid for levels in levels[0], ask for levels in levels[1]. One row per level.
price85628.0data.levels[0][].pxdata.levels[1][].pxCopied as the exact decimal string.
quantity5.71229data.levels[0][].szdata.levels[1][].szCopied as the exact decimal string. It is the total resting size at that price. Base asset units.
order_count19data.levels[0][].ndata.levels[1][].nCopied. Number of resting orders at that price.

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 side noop and with price and quantity 0. 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_time is the start of the hour and transaction_time is null. event_time, final_update_id and last_update_id are the time of 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 market per allDexsAssetCtxs message.

  • WebSocket allDexsAssetCtxs

One allDexsAssetCtxs subscription covers all perpetual markets on all dexes. The message has no market names. The array of each dex is in the order of the allPerpMetas universe. The collector reads this universe at startup and at each symbol refresh, and uses it to name each entry. The collector ignores delisted markets.

Shortened: The frame contained 534 markets on 11 perp dexes. This example shows only BTC, the first market of the main dex "". The collector divides each frame into one record for each market.

WebSocket message · allDexsAssetCtxsreceived 2026-10-05 19:16:37.959116 UTC
{
"channel": "allDexsAssetCtxs",
"data": {
"ctxs": [
[
"",
[
{
"funding": "0.0000125",
"openInterest": "38976.50654",
"prevDayPx": "85366.0",
"dayNtlVlm": "2807065618.8274302483",
"premium": "-0.0001214394",
"oraclePx": "85639.4",
"markPx": "85623.0",
"midPx": "85628.5",
"impactPxs": ["85628.0", "85629.0"],
"dayBaseVlm": "32630.96689"
}
]
]
]
}
}

Published row

received_time1791227797959116000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Hyperliquid does not send this value.
event_time1791227797959—Our receive clock in milliseconds (received_time / 1,000,000). Asset contexts have no exchange timestamp.
symbolBTCdata.ctxs[0][0]The market at this position of the dex array in the Hyperliquid allPerpMetas metadata. BTC is the first market of the main dex "". We change main-dex coins to upper case. Builder-dex coins, for example xyz:XYZ100, keep their case.
mark_price85623.0data.ctxs[0][1][0].markPxCopied.
index_price85639.4data.ctxs[0][1][0].oraclePxCopied from oraclePx, the oracle price. For main-dex markets, Hyperliquid calculates it as a weighted median of prices on centralized exchanges.
estimated_settle_pricenull—Null. Hyperliquid perpetuals do not settle.
funding_rate0.0000125data.ctxs[0][1][0].fundingCopied. A fraction per hour. Hyperliquid pays funding every hour, and 0.0000125 is 0.00125 % per hour.
next_funding_timenull—Null. Hyperliquid does not send it. Hyperliquid pays funding every hour.

Notes

  • Hyperliquid does not document the frequency of allDexsAssetCtxs pushes. In October 2026, a push comes about every 15 seconds, thus a market has about 240 rows per hour. Each push becomes a row, also if no value changed.
  • We do not publish the 24h fields (prevDayPx, dayNtlVlm, dayBaseVlm), midPx, premium and impactPxs.
  • In files that we wrote before the October 2026 pipeline update, event_time is in nanoseconds (the receive clock, equal to received_time). Divide those values by 1,000,000.

For the column types and descriptions, refer to the Mark Price schema.

Open Interest

One row per market per allDexsAssetCtxs message, from the same entries as mark price.

  • WebSocket allDexsAssetCtxs

One allDexsAssetCtxs subscription covers all perpetual markets on all dexes. The message has no market names. The array of each dex is in the order of the allPerpMetas universe. The collector reads this universe at startup and at each symbol refresh, and uses it to name each entry. The collector ignores delisted markets.

Shortened: The frame contained 534 markets on 11 perp dexes. This example shows only BTC, the first market of the main dex "". The collector divides each frame into one record for each market.

WebSocket message · allDexsAssetCtxsreceived 2026-10-05 19:16:37.959116 UTC
{
"channel": "allDexsAssetCtxs",
"data": {
"ctxs": [
[
"",
[
{
"funding": "0.0000125",
"openInterest": "38976.50654",
"prevDayPx": "85366.0",
"dayNtlVlm": "2807065618.8274302483",
"premium": "-0.0001214394",
"oraclePx": "85639.4",
"markPx": "85623.0",
"midPx": "85628.5",
"impactPxs": ["85628.0", "85629.0"],
"dayBaseVlm": "32630.96689"
}
]
]
]
}
}

Published row

received_time1791227797959116000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Hyperliquid does not send this value.
symbolBTCdata.ctxs[0][0]The market at this position of the dex array in the Hyperliquid allPerpMetas metadata. BTC is the first market of the main dex "". We change main-dex coins to upper case. Builder-dex coins, for example xyz:XYZ100, keep their case.
sum_open_interest38976.50654data.ctxs[0][1][0].openInterestCopied. Base asset units (BTC for BTC).
sum_open_interest_valuenull—Null. Hyperliquid does not send an open interest value. To find a notional value, multiply by mark_price.
timestamp1791227797959—Our receive clock in milliseconds (received_time / 1,000,000). Asset contexts have no exchange timestamp.

Notes

  • We do not publish negative or unparsable open interest values. We still publish the mark price row of the same entry.
  • In files that we wrote before the October 2026 pipeline update, timestamp is in nanoseconds (the receive clock, equal to received_time). Divide those values by 1,000,000.

For the column types and descriptions, refer to the Open Interest schema.

Not published

  • Ticker: Hyperliquid has no 24h ticker channel. We do not publish the 24h fields of the asset contexts.
  • Liquidations: Hyperliquid has no public liquidation stream.

If you cannot find the information that you need, tell us. We also help with integrations.

Contact support