BitMEX (historical) wire format
This page shows how BitMEX messages become rows in our Parquet files. For each data type below, you see a 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.
Historical dataset
We do not collect BitMEX (historical) now. Its exchange closed. Thus, we rebuilt the messages below from the published rows and from the message format in the exchange documentation. We checked these messages against the last version of our collector. Refer to Known Gaps & Corrections.
BitMEX settled its perpetual contracts on 2026-09-16 at 12:00 UTC, and our collection stopped on 2026-09-22. The WebSocket still accepts subscriptions, but all tables are empty. In the examples, trade objects are the BitMEX REST records of the same trades. All other values come from our published rows, and the examples do not show fields that are not in our published data. We found the action of each message from the rows: rows with the same receive time arrived in one message, and a row with the full instrument state came from a partial. The collector subscribed to orderBookL2:<symbol>, trade:<symbol>, instrument:<symbol> and liquidation:<symbol> on separate connections, and it stored each message when it arrived. BitMEX sends numbers as JSON numbers, and the pipeline read them as 64-bit floats and wrote them as decimal strings in the shortest form.
- Public WebSocket (one connection for each table: orderBookL2, trade, instrument, liquidation):
wss://ws.bitmex.com/realtime
Exchange API reference: www.bitmex.com. For the conventions that apply to all exchanges, refer to the wire formats overview.
Trades
One row for each trade from the trade table.
- WebSocket trade:<symbol>
Trade (XBTUSDT)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. The trade object is the BitMEX REST record of this trade (GET /api/v1/trade), byte for byte. BitMEX documents that WebSocket rows have the same structure as REST rows. The table/action wrapper uses the documented BitMEX WebSocket format.
{"table": "trade","action": "insert","data": [{"timestamp": "2026-09-02T12:06:40.251Z",→ event_time · trade_time"symbol": "XBTUSDT",→ symbol"side": "Sell",→ is_buyer_maker"size": 100000,→ quantity"price": 76674.4,→ price"tickDirection": "PlusTick","trdMatchID": "00000000-006d-1000-0000-00367d7e88f4",→ trade_id"grossValue": 7667440000,"homeNotional": 0.1,"foreignNotional": 7667.44,"trdType": "Regular","pool": "Secondary"}]}
Published row
timestamp. Milliseconds.trdMatchID UUID (Rust DefaultHasher, SipHash-1-3 with zero keys over the UUID bytes followed by 0xFF, with the top bit cleared). To match the BitMEX trade history, hash its trdMatchID with the same method.76270).size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).event_time. Milliseconds.true if side is Sell (the taker sold). false if it is Buy.Market. BitMEX does not send an order type for trades.Two trades in one message (XBTUSD, inverse)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. The trade objects are the BitMEX REST records of these trades. One insert frame contained both trades, because both rows have the same receive time.
{"table": "trade","action": "insert","data": [{"timestamp": "2026-09-02T12:56:49.947Z",→ event_time · trade_time"symbol": "XBTUSD",→ symbol"side": "Sell",→ is_buyer_maker"size": 3000,→ quantity"price": 76591.5,→ price"tickDirection": "MinusTick","trdMatchID": "00000000-006d-1000-0000-00367d8ab963",→ trade_id"grossValue": 3916890,"homeNotional": 0.0391689,"foreignNotional": 3000,"trdType": "Regular","pool": "Primary"},{"timestamp": "2026-09-02T12:56:49.947Z",→ event_time · trade_time"symbol": "XBTUSD",→ symbol"side": "Sell",→ is_buyer_maker"size": 800,→ quantity"price": 76584.8,→ price"tickDirection": "MinusTick","trdMatchID": "00000000-006d-1000-0000-00367d8ab964",→ trade_id"grossValue": 1044592,"homeNotional": 0.01044592,"foreignNotional": 800,"trdType": "Regular","pool": "Secondary"}]}
Published rows · 2
timestamp. Milliseconds.trdMatchID UUID (Rust DefaultHasher, SipHash-1-3 with zero keys over the UUID bytes followed by 0xFF, with the top bit cleared). To match the BitMEX trade history, hash its trdMatchID with the same method.76270).size. XBTUSD is an inverse contract. size is in USD contracts (1 contract = 1 USD), thus 3000 is 3,000 USD. The BTC amount is the BitMEX homeNotional, which we do not publish.event_time. Milliseconds.true if side is Sell (the taker sold). false if it is Buy.Market. BitMEX does not send an order type for trades.Trades repeated in the subscription partial
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. After each connection or reconnection, BitMEX answers the subscription with a partial that repeats recent trades, and the collector stored them as new trades. In this hour, the two rows below have the same receive time, thus they arrived in one frame. We published the 11:11:32 trade before, in the 11:00 file, and we publish it again here. The trade objects are the BitMEX REST records, and keys, types and filter are copies from a trade partial that BitMEX sent on 2026-10-05. We do not know the order of the two trades in the original frame.
{"table": "trade","action": "partial","keys": [],"types": {"timestamp": "timestamp","symbol": "symbol","side": "symbol","size": "long","price": "float","tickDirection": "symbol","trdMatchID": "guid","grossValue": "long","homeNotional": "float","foreignNotional": "float","trdType": "symbol","pool": "symbol"},"filter": {"pool": "Aggregated","symbol": "XBTUSDT"},"data": [{"timestamp": "2026-09-02T11:11:32.933Z",→ event_time · trade_time"symbol": "XBTUSDT",→ symbol"side": "Buy",→ is_buyer_maker"size": 10000,→ quantity"price": 76607.6,→ price"tickDirection": "PlusTick","trdMatchID": "00000000-006d-1000-0000-00367d690e16",→ trade_id"grossValue": 766076000,"homeNotional": 0.01,"foreignNotional": 766.076,"trdType": "Regular","pool": "Secondary"},{"timestamp": "2026-09-02T12:02:35.598Z",→ event_time · trade_time"symbol": "XBTUSDT",→ symbol"side": "Buy",→ is_buyer_maker"size": 20000,→ quantity"price": 76820.1,→ price"tickDirection": "PlusTick","trdMatchID": "00000000-006d-1000-0000-00367d7d57d7",→ trade_id"grossValue": 1536402000,"homeNotional": 0.02,"foreignNotional": 1536.402,"trdType": "Regular","pool": "Primary"}]}
Published rows · 2
timestamp. Milliseconds.trdMatchID UUID (Rust DefaultHasher, SipHash-1-3 with zero keys over the UUID bytes followed by 0xFF, with the top bit cleared). To match the BitMEX trade history, hash its trdMatchID with the same method.76270).size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).event_time. Milliseconds.true if side is Sell (the taker sold). false if it is Buy.Market. BitMEX does not send an order type for trades.Settlement at expiry (no side)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. The trade object is the BitMEX REST record. When BitMEX settled XBTUSDT on 2026-09-16 at 12:00 UTC, it published Settlement trades that have no side. The pipeline does not read trdType. Thus, we publish these trades as normal trades.
{"table": "trade","action": "insert","data": [{"timestamp": "2026-09-16T12:00:00.000Z",→ event_time · trade_time"symbol": "XBTUSDT",→ symbol"size": 3618200,→ quantity"price": 76152.5,→ price"tickDirection": "ZeroMinusTick","trdMatchID": "00000000-0079-1000-0000-0000669ebc65",→ trade_id"grossValue": 275534975500,"homeNotional": 3.6182,"foreignNotional": 275534.9755,"trdType": "Settlement","pool": "Primary"}]}
Published row
timestamp. Milliseconds.trdMatchID UUID (Rust DefaultHasher, SipHash-1-3 with zero keys over the UUID bytes followed by 0xFF, with the top bit cleared). To match the BitMEX trade history, hash its trdMatchID with the same method.76270).size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).event_time. Milliseconds.false. Settlement trades have no side, and the pipeline reads a missing side as Buy. Here, the value gives no aggressor information.Market. BitMEX does not send an order type for trades.Notes
- Sizes are in raw units of each instrument, not in base asset units. XBTUSD uses USD contracts, XBTUSDT uses 0.000001 XBT and ETHUSDT uses 0.00001 ETH. Spot pairs use 0.00000001 of the base asset. Before you compare with other venues, check the multiplier of the instrument.
- We remove duplicate trades only in the same hour file. After a reconnect, a
partialcan repeat a trade. If the first copy of that trade is in an earlier hour, we publish the trade again. To remove duplicates from the history, use (symbol,trade_id). - On liquid days, 5–20 % of trades are missing when you compare them with the trade history of BitMEX. Refer to Known Gaps & Corrections.
- We do not publish
trdType. Thus,Regulartrades andSettlementtrades at expiry look the same.
For the column types and descriptions, refer to the Trades schema.
Order Book
One row for each price level. After each connection or reconnection, a partial gives the full order book as snapshot rows. insert, update and delete messages become update rows.
- WebSocket orderBookL2:<symbol>
Partial (order book image after the subscription)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. After each connection or reconnection, BitMEX sends a partial with the full order book. Each level becomes one snapshot row. keys, types and filter are copies from an orderBookL2 partial that BitMEX sent on 2026-10-05.
Shortened: The original partial had 132 levels (99 bids, 33 asks). The example shows the two best asks and the two best bids, in the original order. BitMEX also sent timestamp and transactTime on each level. We do not publish these fields, thus the example does not show them.
{"table": "orderBookL2","action": "partial",→ event_type"keys": ["symbol", "id", "side"],"types": {"symbol": "symbol","id": "long","side": "symbol","size": "long","price": "float","pool": "symbol","timestamp": "timestamp","transactTime": "timestamp"},"filter": {"pool": "Aggregated","symbol": "XBTUSDT"},"data": [{"symbol": "XBTUSDT",→ symbol"id": 234034598936,→ first_update_id · final_update_id · last_update_id"side": "Sell",→ side"size": 291100,→ quantity"price": 76824.2→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034600390,→ first_update_id · final_update_id · last_update_id"side": "Sell",→ side"size": 267100,→ quantity"price": 76822.4→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034599815,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 6778700,→ quantity"price": 76754.1→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034599842,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 1900,→ quantity"price": 76745.9→ price}]}
Published rows · 4
received_time. We do not publish the BitMEX timestamp of each level.transactTime.snapshot for a partial message.first_update_id.first_update_id.bid for Buy. ask for Sell. One row for each level.76754.1). Thus, whole prices have no decimal point (240430).size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).Insert (new levels)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now.
Shortened: BitMEX also sent timestamp and transactTime on each level. We do not publish these fields, thus the example does not show them.
{"table": "orderBookL2","action": "insert",→ event_type"data": [{"symbol": "XBTUSDT",→ symbol"id": 234034541763,→ first_update_id · final_update_id · last_update_id"side": "Sell",→ side"size": 266900,→ quantity"price": 76863.7→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034541208,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 6775200,→ quantity"price": 76796.6→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034541214,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 1900,→ quantity"price": 76788.9→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034541226,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 8100,→ quantity"price": 76785.1→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034541235,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 3200,→ quantity"price": 76787.4→ price}]}
Published rows · 5
received_time. We do not publish the BitMEX timestamp of each level.transactTime.update for all insert, update and delete messages.first_update_id.first_update_id.bid for Buy. ask for Sell. One row for each level.76754.1). Thus, whole prices have no decimal point (240430).size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).Update (size change at an existing level)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. The level is identified by id, and its new size replaces the old size.
Shortened: BitMEX also sent timestamp and transactTime on each level. We do not publish these fields, thus the example does not show them.
{"table": "orderBookL2","action": "update",→ event_type"data": [{"symbol": "XBTUSDT",→ symbol"id": 234034599806,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"size": 11300,→ quantity"price": 76745.5→ price}]}
Published row
received_time. We do not publish the BitMEX timestamp of each level.transactTime.update for all insert, update and delete messages.first_update_id.first_update_id.bid for Buy. ask for Sell. One row for each level.76754.1). Thus, whole prices have no decimal point (240430).size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).Delete (levels removed)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. Delete rows do not contain a size. The pipeline writes quantity 0.
Shortened: BitMEX also sent timestamp and transactTime on each level. We do not publish these fields, thus the example does not show them.
{"table": "orderBookL2","action": "delete",→ event_type"data": [{"symbol": "XBTUSDT",→ symbol"id": 234034541192,→ first_update_id · final_update_id · last_update_id"side": "Sell",→ side"price": 76864.3→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034540919,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"price": 76778.2→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034540922,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"price": 76774.8→ price},{"symbol": "XBTUSDT",→ symbol"id": 234034541040,→ first_update_id · final_update_id · last_update_id"side": "Buy",→ side"price": 76787.1→ price}]}
Published rows · 4
received_time. We do not publish the BitMEX timestamp of each level.transactTime.update for all insert, update and delete messages.first_update_id.first_update_id.bid for Buy. ask for Sell. One row for each level.76754.1). Thus, whole prices have no decimal point (240430).0 for each level of a delete message. The level is removed.Notes
- Apply rows by level ID (
last_update_id), not by price. Anupdaterow sets the size of the level with that ID, and quantity0removes the level. IDs are not sequence numbers, thus you cannot find gaps with them. - Files do not start with a checkpoint of the order book. Continue from the order book of the previous hour, or start at the next
snapshotrows. event_timeis our receive time in nanoseconds, likereceived_time.- Sizes are in raw units of each instrument, not in base asset units. XBTUSD uses USD contracts, XBTUSDT uses 0.000001 XBT and ETHUSDT uses 0.00001 ETH. Spot pairs use 0.00000001 of the base asset. Before you compare with other venues, check the multiplier of the instrument.
For the column types and descriptions, refer to the Order Book schema.
Ticker
One row for each instrument message.
- WebSocket instrument:<symbol>
Partial (full instrument state after the subscription)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. After each connection or reconnection, BitMEX sends a partial with all instrument fields. Only this type of message contains all fields that the pipeline reads. keys, types and filter are copies from an instrument partial that BitMEX sent on 2026-10-05.
Shortened: A partial contains all instrument fields (the types header lists 100). The example shows only the fields that the pipeline reads. The other fields are not in our published data.
{"table": "instrument","action": "partial","keys": ["symbol"],"types": {"symbol": "symbol","rootSymbol": "symbol","instrumentID": "int","state": "symbol","typ": "symbol","listing": "timestamp","front": "timestamp","expiry": "timestamp","settle": "timestamp","listedSettle": "timestamp","relistInterval": "timespan","positionCurrency": "symbol","underlying": "symbol","quoteCurrency": "symbol","underlyingSymbol": "symbol","reference": "symbol","referenceSymbol": "symbol","calcInterval": "timespan","publishInterval": "timespan","publishTime": "timespan","maxOrderQty": "long","minPrice": "float","maxPrice": "float","lotSize": "long","tickSize": "float","multiplier": "long","settlCurrency": "symbol","underlyingToPositionMultiplier": "long","underlyingToSettleMultiplier": "long","quoteToSettleMultiplier": "long","isQuanto": "boolean","isInverse": "boolean","initMargin": "float","maintMargin": "float","riskLimit": "long","riskStep": "long","limit": "float","taxed": "boolean","deleverage": "boolean","makerFee": "float","takerFee": "float","settlementFee": "float","fundingBaseSymbol": "symbol","fundingQuoteSymbol": "symbol","fundingPremiumSymbol": "symbol","fundingTimestamp": "timestamp","fundingInterval": "timespan","fundingRate": "float","indicativeFundingRate": "float","rebalanceTimestamp": "timestamp","rebalanceInterval": "timespan","launchingTimestamp": "timestamp","prevClosePrice": "float","limitDownPrice": "float","limitUpPrice": "float","prevTotalVolume": "long","totalVolume": "long","volume": "long","volume24h": "long","prevTotalTurnover": "long","totalTurnover": "long","turnover": "long","turnover24h": "long","homeNotional24h": "float","foreignNotional24h": "float","prevPrice24h": "float","vwap": "float","highPrice": "float","lowPrice": "float","lastPrice": "float","lastPriceProtected": "float","lastTickDirection": "symbol","lastChangePcnt": "float","bidPrice": "float","midPrice": "float","askPrice": "float","impactBidPrice": "float","impactMidPrice": "float","impactAskPrice": "float","hasLiquidity": "boolean","openInterest": "long","openValue": "long","fairMethod": "symbol","fairBasisRate": "float","fairBasis": "float","fairPrice": "float","markMethod": "symbol","markPrice": "float","referencePrice": "float","indicativeSettlePrice": "float","settledPriceAdjustmentRate": "float","settledPrice": "float","instantPnl": "boolean","minTick": "float","fundingBaseRate": "float","fundingQuoteRate": "float","farLegSymbol": "symbol","nearLegSymbol": "symbol","tags": "symbol","timestamp": "timestamp"},"filter": {"symbol": "XBTUSDT"},"data": [{"symbol": "XBTUSDT",→ symbol"fundingTimestamp": "2026-09-02T20:00:00.000Z","fundingRate": 0.0001,"volume24h": 6131600,→ base_asset_volume"turnover24h": 473010789790,→ quote_asset_volume"prevPrice24h": 77932.3,→ price_change · open_price"highPrice": 78375.2,→ high_price"lowPrice": 76270,→ low_price"lastPrice": 76607.6,→ price_change · last_price"lastChangePcnt": -0.0166,→ price_change_percent"openInterest": 60628400,"markPrice": 76820.3,"indicativeSettlePrice": 76812.65,"timestamp": "2026-09-02T12:02:32.653Z"→ event_time}]}
Published row
timestamp. Milliseconds.lastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.lastChangePcnt × 100, in percent. BitMEX sends a fraction (-0.0166 becomes -1.66). Calculated in 64-bit floats. Thus, it can contain float noise (-1.6099999999999999).vwap.lastPrice.prevPrice24h, the price 24 hours earlier.highPrice.lowPrice.volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).Update after a trade
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. Updates contain only the fields that changed. If the field of a column is not in the update, the column is null. The pipeline does not keep the earlier value.
Shortened: The example shows only the fields that the pipeline reads. Other fields are not in our published data. Thus, we do not know which other fields BitMEX sent in this message.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"lastPrice": 76820.1,→ price_change · last_price"lastChangePcnt": -0.0143,→ price_change_percent"timestamp": "2026-09-02T12:02:35.599Z"→ event_time}]}
Published row
timestamp. Milliseconds.lastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.lastChangePcnt × 100, in percent. BitMEX sends a fraction (-0.0166 becomes -1.66). Calculated in 64-bit floats. Thus, it can contain float noise (-1.6099999999999999).vwap.lastPrice.prevPrice24h, the price 24 hours earlier.highPrice.lowPrice.volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).Update with no ticker fields
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. In this update, BitMEX sent fields that the pipeline does not read. Our published data does not show which fields they were. Thus, the example shows only symbol and timestamp. The message still makes a row in all three files, and all values in the row are null.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"timestamp": "2026-09-02T12:02:32.653Z"→ event_time}]}
Published row
timestamp. Milliseconds.lastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.lastChangePcnt × 100, in percent. BitMEX sends a fraction (-0.0166 becomes -1.66). Calculated in 64-bit floats. Thus, it can contain float noise (-1.6099999999999999).vwap.lastPrice.prevPrice24h, the price 24 hours earlier.highPrice.lowPrice.volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).Notes
- The
instrumenttable supplies the ticker, mark price and open interest files. Each message becomes one row in each of the three files, with the samereceived_time. - BitMEX sends only the changed fields, and the pipeline does not keep earlier values in later rows. Most rows are null in all value columns (XBTUSDT, 2026-09-02 12:00 UTC: 2,085 of 2,101 rows). Forward-fill the values for each symbol. Start from a
partialrow.
For the column types and descriptions, refer to the Ticker schema.
Mark Price
One row for each instrument message.
- WebSocket instrument:<symbol>
Partial (full instrument state after the subscription)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. After each connection or reconnection, BitMEX sends a partial with all instrument fields. Only this type of message contains all fields that the pipeline reads. keys, types and filter are copies from an instrument partial that BitMEX sent on 2026-10-05.
Shortened: A partial contains all instrument fields (the types header lists 100). The example shows only the fields that the pipeline reads. The other fields are not in our published data.
{"table": "instrument","action": "partial","keys": ["symbol"],"types": {"symbol": "symbol","rootSymbol": "symbol","instrumentID": "int","state": "symbol","typ": "symbol","listing": "timestamp","front": "timestamp","expiry": "timestamp","settle": "timestamp","listedSettle": "timestamp","relistInterval": "timespan","positionCurrency": "symbol","underlying": "symbol","quoteCurrency": "symbol","underlyingSymbol": "symbol","reference": "symbol","referenceSymbol": "symbol","calcInterval": "timespan","publishInterval": "timespan","publishTime": "timespan","maxOrderQty": "long","minPrice": "float","maxPrice": "float","lotSize": "long","tickSize": "float","multiplier": "long","settlCurrency": "symbol","underlyingToPositionMultiplier": "long","underlyingToSettleMultiplier": "long","quoteToSettleMultiplier": "long","isQuanto": "boolean","isInverse": "boolean","initMargin": "float","maintMargin": "float","riskLimit": "long","riskStep": "long","limit": "float","taxed": "boolean","deleverage": "boolean","makerFee": "float","takerFee": "float","settlementFee": "float","fundingBaseSymbol": "symbol","fundingQuoteSymbol": "symbol","fundingPremiumSymbol": "symbol","fundingTimestamp": "timestamp","fundingInterval": "timespan","fundingRate": "float","indicativeFundingRate": "float","rebalanceTimestamp": "timestamp","rebalanceInterval": "timespan","launchingTimestamp": "timestamp","prevClosePrice": "float","limitDownPrice": "float","limitUpPrice": "float","prevTotalVolume": "long","totalVolume": "long","volume": "long","volume24h": "long","prevTotalTurnover": "long","totalTurnover": "long","turnover": "long","turnover24h": "long","homeNotional24h": "float","foreignNotional24h": "float","prevPrice24h": "float","vwap": "float","highPrice": "float","lowPrice": "float","lastPrice": "float","lastPriceProtected": "float","lastTickDirection": "symbol","lastChangePcnt": "float","bidPrice": "float","midPrice": "float","askPrice": "float","impactBidPrice": "float","impactMidPrice": "float","impactAskPrice": "float","hasLiquidity": "boolean","openInterest": "long","openValue": "long","fairMethod": "symbol","fairBasisRate": "float","fairBasis": "float","fairPrice": "float","markMethod": "symbol","markPrice": "float","referencePrice": "float","indicativeSettlePrice": "float","settledPriceAdjustmentRate": "float","settledPrice": "float","instantPnl": "boolean","minTick": "float","fundingBaseRate": "float","fundingQuoteRate": "float","farLegSymbol": "symbol","nearLegSymbol": "symbol","tags": "symbol","timestamp": "timestamp"},"filter": {"symbol": "XBTUSDT"},"data": [{"symbol": "XBTUSDT",→ symbol"fundingTimestamp": "2026-09-02T20:00:00.000Z",→ next_funding_time"fundingRate": 0.0001,→ funding_rate"volume24h": 6131600,"turnover24h": 473010789790,"prevPrice24h": 77932.3,"highPrice": 78375.2,"lowPrice": 76270,"lastPrice": 76607.6,"lastChangePcnt": -0.0166,"openInterest": 60628400,"markPrice": 76820.3,→ mark_price"indicativeSettlePrice": 76812.65,→ estimated_settle_price"timestamp": "2026-09-02T12:02:32.653Z"→ event_time}]}
Published row
timestamp. Milliseconds.markPrice. Null if the message has no markPrice.indicativeSettlePrice. Null if the message does not contain it.fundingRate. A fraction for each funding period (8 hours for XBTUSDT). For example, 0.0001 is 0.01 %. Null if the message does not contain it.fundingTimestamp, the next funding time. Milliseconds. Null if the message does not contain it.Mark price at the funding time
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. At the 12:00 UTC funding time, the update contained a new markPrice and the next fundingTimestamp.
Shortened: The example shows only the fields that the pipeline reads. Other fields are not in our published data. Thus, we do not know which other fields BitMEX sent in this message.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"fundingTimestamp": "2026-09-02T20:00:00.000Z",→ next_funding_time"markPrice": 76837.13,→ mark_price"timestamp": "2026-09-02T12:00:00.000Z"→ event_time}]}
Published row
timestamp. Milliseconds.markPrice. Null if the message has no markPrice.indicativeSettlePrice. Null if the message does not contain it.fundingRate. A fraction for each funding period (8 hours for XBTUSDT). For example, 0.0001 is 0.01 %. Null if the message does not contain it.fundingTimestamp, the next funding time. Milliseconds. Null if the message does not contain it.Indicative settle price update
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. BitMEX sends markPrice and indicativeSettlePrice in different updates. Thus, each row has one of these values, and the other value is null.
Shortened: The example shows only the fields that the pipeline reads. Other fields are not in our published data. Thus, we do not know which other fields BitMEX sent in this message.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"indicativeSettlePrice": 76827.79,→ estimated_settle_price"timestamp": "2026-09-02T12:00:00.057Z"→ event_time}]}
Published row
timestamp. Milliseconds.markPrice. Null if the message has no markPrice.indicativeSettlePrice. Null if the message does not contain it.fundingRate. A fraction for each funding period (8 hours for XBTUSDT). For example, 0.0001 is 0.01 %. Null if the message does not contain it.fundingTimestamp, the next funding time. Milliseconds. Null if the message does not contain it.Notes
- The same
instrumentmessages also make the ticker rows and open interest rows. - BitMEX sends only the changed fields, and the pipeline does not keep earlier values in later rows. Most rows have only
mark_price, onlyestimated_settle_priceor no value (XBTUSDT, 2026-09-02 12:00 UTC: 684, 685 and 729 of 2,101 rows). Forward-fill the values for each symbol.
For the column types and descriptions, refer to the Mark Price schema.
Open Interest
One row for each instrument message.
- WebSocket instrument:<symbol>
Partial (full instrument state after the subscription)
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. After each connection or reconnection, BitMEX sends a partial with all instrument fields. Only this type of message contains all fields that the pipeline reads. keys, types and filter are copies from an instrument partial that BitMEX sent on 2026-10-05.
Shortened: A partial contains all instrument fields (the types header lists 100). The example shows only the fields that the pipeline reads. The other fields are not in our published data.
{"table": "instrument","action": "partial","keys": ["symbol"],"types": {"symbol": "symbol","rootSymbol": "symbol","instrumentID": "int","state": "symbol","typ": "symbol","listing": "timestamp","front": "timestamp","expiry": "timestamp","settle": "timestamp","listedSettle": "timestamp","relistInterval": "timespan","positionCurrency": "symbol","underlying": "symbol","quoteCurrency": "symbol","underlyingSymbol": "symbol","reference": "symbol","referenceSymbol": "symbol","calcInterval": "timespan","publishInterval": "timespan","publishTime": "timespan","maxOrderQty": "long","minPrice": "float","maxPrice": "float","lotSize": "long","tickSize": "float","multiplier": "long","settlCurrency": "symbol","underlyingToPositionMultiplier": "long","underlyingToSettleMultiplier": "long","quoteToSettleMultiplier": "long","isQuanto": "boolean","isInverse": "boolean","initMargin": "float","maintMargin": "float","riskLimit": "long","riskStep": "long","limit": "float","taxed": "boolean","deleverage": "boolean","makerFee": "float","takerFee": "float","settlementFee": "float","fundingBaseSymbol": "symbol","fundingQuoteSymbol": "symbol","fundingPremiumSymbol": "symbol","fundingTimestamp": "timestamp","fundingInterval": "timespan","fundingRate": "float","indicativeFundingRate": "float","rebalanceTimestamp": "timestamp","rebalanceInterval": "timespan","launchingTimestamp": "timestamp","prevClosePrice": "float","limitDownPrice": "float","limitUpPrice": "float","prevTotalVolume": "long","totalVolume": "long","volume": "long","volume24h": "long","prevTotalTurnover": "long","totalTurnover": "long","turnover": "long","turnover24h": "long","homeNotional24h": "float","foreignNotional24h": "float","prevPrice24h": "float","vwap": "float","highPrice": "float","lowPrice": "float","lastPrice": "float","lastPriceProtected": "float","lastTickDirection": "symbol","lastChangePcnt": "float","bidPrice": "float","midPrice": "float","askPrice": "float","impactBidPrice": "float","impactMidPrice": "float","impactAskPrice": "float","hasLiquidity": "boolean","openInterest": "long","openValue": "long","fairMethod": "symbol","fairBasisRate": "float","fairBasis": "float","fairPrice": "float","markMethod": "symbol","markPrice": "float","referencePrice": "float","indicativeSettlePrice": "float","settledPriceAdjustmentRate": "float","settledPrice": "float","instantPnl": "boolean","minTick": "float","fundingBaseRate": "float","fundingQuoteRate": "float","farLegSymbol": "symbol","nearLegSymbol": "symbol","tags": "symbol","timestamp": "timestamp"},"filter": {"symbol": "XBTUSDT"},"data": [{"symbol": "XBTUSDT",→ symbol"fundingTimestamp": "2026-09-02T20:00:00.000Z","fundingRate": 0.0001,"volume24h": 6131600,"turnover24h": 473010789790,"prevPrice24h": 77932.3,"highPrice": 78375.2,"lowPrice": 76270,"lastPrice": 76607.6,"lastChangePcnt": -0.0166,"openInterest": 60628400,→ sum_open_interest"markPrice": 76820.3,"indicativeSettlePrice": 76812.65,"timestamp": "2026-09-02T12:02:32.653Z"→ timestamp}]}
Published row
openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.openValue.timestamp. Milliseconds.Open interest update
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now.
Shortened: The example shows only the fields that the pipeline reads. Other fields are not in our published data. Thus, we do not know which other fields BitMEX sent in this message.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"openInterest": 60608400,→ sum_open_interest"timestamp": "2026-09-02T12:02:36.454Z"→ timestamp}]}
Published row
openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.openValue.timestamp. Milliseconds.Update without open interest
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now. In this update, BitMEX sent fields that the pipeline does not read. Our published data does not show which fields they were. Thus, the example shows only symbol and timestamp. The message still makes a row in all three files, and all values in the row are null.
{"table": "instrument","action": "update","data": [{"symbol": "XBTUSDT",→ symbol"timestamp": "2026-09-02T12:02:32.653Z"→ timestamp}]}
Published row
openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.openValue.timestamp. Milliseconds.Notes
- Open interest is null in most rows, because BitMEX sends it only when it changes (XBTUSDT, 2026-09-02 12:00 UTC: 8 of 2,101 rows have a value). Remove the null rows and forward-fill the values.
- Sizes are in raw units of each instrument, not in base asset units. XBTUSD uses USD contracts, XBTUSDT uses 0.000001 XBT and ETHUSDT uses 0.00001 ETH. Spot pairs use 0.00000001 of the base asset. Before you compare with other venues, check the multiplier of the instrument.
For the column types and descriptions, refer to the Open Interest schema.
Liquidations
One row for each row of the liquidation table. This table lists liquidation orders when BitMEX adds them to the order book.
- WebSocket liquidation:<symbol>
Reconstructed: BitMEX is closed, and it is not possible to capture its feed now.
Shortened: BitMEX also sent the orderID of the order (the key of the table). We do not publish it, thus the example does not show it.
{"table": "liquidation","action": "insert","data": [{"symbol": "XBTUSDT",→ symbol"side": "Sell",→ side"price": 78007,→ price · average_price"leavesQty": 14800→ quantity · last_filled_quantity · filled_quantity}]}
Published row
SELL closes a liquidated long position. BUY closes a liquidated short position.Market. This is a placeholder because BitMEX does not send an order type here.IOC. This is a placeholder because BitMEX does not send a time in force here.leavesQty (the table has no orderQty), in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (14800 is 0.0148 XBT).price. Not an average fill price.FILLED. This is a placeholder because the message gives no information about fills.quantity. Not a fill.quantity. Not a fill.event_time. Our receive time. Milliseconds from the 2026-10-04 correction, nanoseconds before it.Notes
- For most liquidation orders, BitMEX sent a second message a few seconds after the first, with the same side, price and quantity. The collector stored both messages, thus we published about 95 % of liquidations two times. On 2026-10-04, we corrected the published history. We removed the second of two identical rows (
symbol,side,price,quantity) within 30 seconds. We also convertedevent_timeandtrade_timefrom nanoseconds to milliseconds. - Originally, the example hour 2026-09-01 12:00 UTC had two identical rows that we received 10 seconds apart. The correction removed the second row.
order_type,time_in_forceandorder_statusare placeholders, and the fill columns repeatquantity.- Sizes are in raw units of each instrument, not in base asset units. XBTUSD uses USD contracts, XBTUSDT uses 0.000001 XBT and ETHUSDT uses 0.00001 ETH. Spot pairs use 0.00000001 of the base asset. Before you compare with other venues, check the multiplier of the instrument.
For the column types and descriptions, refer to the Liquidations schema.