Exchange Wire Formats

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.

WebSocket message (reconstructed) · trade:<symbol>received 2026-09-02 12:06:40.391901 UTC
{
"table": "trade",
"action": "insert",
"data": [
{
"timestamp": "2026-09-02T12:06:40.251Z",
"symbol": "XBTUSDT",
"side": "Sell",
"size": 100000,
"price": 76674.4,
"tickDirection": "PlusTick",
"trdMatchID": "00000000-006d-1000-0000-00367d7e88f4",
"grossValue": 7667440000,
"homeNotional": 0.1,
"foreignNotional": 7667.44,
"trdType": "Regular",
"pool": "Secondary"
}
]
}

Published row

received_time1788350800391901049—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350800251data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
trade_id7994828196135390476data[].trdMatchIDThis is not the BitMEX ID. It is a hash of the 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.
price76674.4data[].priceConverted through a 64-bit float and written in the shortest form. Thus, whole prices have no decimal point (76270).
quantity100000data[].sizeCopied from size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).
trade_time1788350800251data[].timestampSame as event_time. Milliseconds.
is_buyer_makertruedata[].sidetrue if side is Sell (the taker sold). false if it is Buy.
order_typeMarket—Constant 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.

WebSocket message (reconstructed) · trade:<symbol>received 2026-09-02 12:56:50.107284 UTC
{
"table": "trade",
"action": "insert",
"data": [
{
"timestamp": "2026-09-02T12:56:49.947Z",
"symbol": "XBTUSD",
"side": "Sell",
"size": 3000,
"price": 76591.5,
"tickDirection": "MinusTick",
"trdMatchID": "00000000-006d-1000-0000-00367d8ab963",
"grossValue": 3916890,
"homeNotional": 0.0391689,
"foreignNotional": 3000,
"trdType": "Regular",
"pool": "Primary"
},
{
"timestamp": "2026-09-02T12:56:49.947Z",
"symbol": "XBTUSD",
"side": "Sell",
"size": 800,
"price": 76584.8,
"tickDirection": "MinusTick",
"trdMatchID": "00000000-006d-1000-0000-00367d8ab964",
"grossValue": 1044592,
"homeNotional": 0.01044592,
"foreignNotional": 800,
"trdType": "Regular",
"pool": "Secondary"
}
]
}

Published rows · 2

received_time1788353810107284579—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788353809947data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDdata[].symbolCopied.
trade_id8597726609260770388data[].trdMatchIDThis is not the BitMEX ID. It is a hash of the 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.
price76591.5data[].priceConverted through a 64-bit float and written in the shortest form. Thus, whole prices have no decimal point (76270).
quantity3000data[].sizeCopied from 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.
trade_time1788353809947data[].timestampSame as event_time. Milliseconds.
is_buyer_makertruedata[].sidetrue if side is Sell (the taker sold). false if it is Buy.
order_typeMarket—Constant 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.

WebSocket message (reconstructed) · trade:<symbol>received 2026-09-02 12:02:37.163259 UTC
{
"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",
"symbol": "XBTUSDT",
"side": "Buy",
"size": 10000,
"price": 76607.6,
"tickDirection": "PlusTick",
"trdMatchID": "00000000-006d-1000-0000-00367d690e16",
"grossValue": 766076000,
"homeNotional": 0.01,
"foreignNotional": 766.076,
"trdType": "Regular",
"pool": "Secondary"
},
{
"timestamp": "2026-09-02T12:02:35.598Z",
"symbol": "XBTUSDT",
"side": "Buy",
"size": 20000,
"price": 76820.1,
"tickDirection": "PlusTick",
"trdMatchID": "00000000-006d-1000-0000-00367d7d57d7",
"grossValue": 1536402000,
"homeNotional": 0.02,
"foreignNotional": 1536.402,
"trdType": "Regular",
"pool": "Primary"
}
]
}

Published rows · 2

received_time1788350557163259883—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788347492933data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
trade_id1837481949224425487data[].trdMatchIDThis is not the BitMEX ID. It is a hash of the 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.
price76607.6data[].priceConverted through a 64-bit float and written in the shortest form. Thus, whole prices have no decimal point (76270).
quantity10000data[].sizeCopied from size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).
trade_time1788347492933data[].timestampSame as event_time. Milliseconds.
is_buyer_makerfalsedata[].sidetrue if side is Sell (the taker sold). false if it is Buy.
order_typeMarket—Constant 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.

WebSocket message (reconstructed) · trade:<symbol>received 2026-09-16 12:00:03.616529 UTC
{
"table": "trade",
"action": "insert",
"data": [
{
"timestamp": "2026-09-16T12:00:00.000Z",
"symbol": "XBTUSDT",
"size": 3618200,
"price": 76152.5,
"tickDirection": "ZeroMinusTick",
"trdMatchID": "00000000-0079-1000-0000-0000669ebc65",
"grossValue": 275534975500,
"homeNotional": 3.6182,
"foreignNotional": 275534.9755,
"trdType": "Settlement",
"pool": "Primary"
}
]
}

Published row

received_time1789560003616529503—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1789560000000data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
trade_id8132317058320258754data[].trdMatchIDThis is not the BitMEX ID. It is a hash of the 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.
price76152.5data[].priceConverted through a 64-bit float and written in the shortest form. Thus, whole prices have no decimal point (76270).
quantity3618200data[].sizeCopied from size, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT, thus 100000 is 0.1 XBT (the BitMEX homeNotional).
trade_time1789560000000data[].timestampSame as event_time. Milliseconds.
is_buyer_makerfalse—false. Settlement trades have no side, and the pipeline reads a missing side as Buy. Here, the value gives no aggressor information.
order_typeMarket—Constant 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 partial can 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, Regular trades and Settlement trades 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.

WebSocket message (reconstructed) · orderBookL2:<symbol>received 2026-09-02 12:02:36.363458 UTC
{
"table": "orderBookL2",
"action": "partial",
"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",
"id": 234034598936,
"side": "Sell",
"size": 291100,
"price": 76824.2
},
{
"symbol": "XBTUSDT",
"id": 234034600390,
"side": "Sell",
"size": 267100,
"price": 76822.4
},
{
"symbol": "XBTUSDT",
"id": 234034599815,
"side": "Buy",
"size": 6778700,
"price": 76754.1
},
{
"symbol": "XBTUSDT",
"id": 234034599842,
"side": "Buy",
"size": 1900,
"price": 76745.9
}
]
}

Published rows · 4

received_time1788350556363458711—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350556363458711—Our receive time in nanoseconds. This is the same value as received_time. We do not publish the BitMEX timestamp of each level.
transaction_timenull—Null. We do not publish the BitMEX transactTime.
symbolXBTUSDTdata[].symbolCopied.
event_typesnapshotactionsnapshot for a partial message.
first_update_id234034598936data[].idThe BitMEX price-level ID. It identifies the level. It is not a sequence number.
final_update_id234034598936data[].idSame as first_update_id.
prev_final_update_idnull—Null. BitMEX does not send sequence numbers.
last_update_id234034598936data[].idSame as first_update_id.
sideaskdata[].sidebid for Buy. ask for Sell. One row for each level.
price76824.2data[].priceConverted through a 64-bit float and written in the shortest form (76754.1). Thus, whole prices have no decimal point (240430).
quantity291100data[].sizeCopied from size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).
order_countnull—Null. BitMEX does not send order counts.

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.

WebSocket message (reconstructed) · orderBookL2:<symbol>received 2026-09-02 12:00:00.314553 UTC
{
"table": "orderBookL2",
"action": "insert",
"data": [
{
"symbol": "XBTUSDT",
"id": 234034541763,
"side": "Sell",
"size": 266900,
"price": 76863.7
},
{
"symbol": "XBTUSDT",
"id": 234034541208,
"side": "Buy",
"size": 6775200,
"price": 76796.6
},
{
"symbol": "XBTUSDT",
"id": 234034541214,
"side": "Buy",
"size": 1900,
"price": 76788.9
},
{
"symbol": "XBTUSDT",
"id": 234034541226,
"side": "Buy",
"size": 8100,
"price": 76785.1
},
{
"symbol": "XBTUSDT",
"id": 234034541235,
"side": "Buy",
"size": 3200,
"price": 76787.4
}
]
}

Published rows · 5

received_time1788350400314553190—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350400314553190—Our receive time in nanoseconds. This is the same value as received_time. We do not publish the BitMEX timestamp of each level.
transaction_timenull—Null. We do not publish the BitMEX transactTime.
symbolXBTUSDTdata[].symbolCopied.
event_typeupdateactionupdate for all insert, update and delete messages.
first_update_id234034541763data[].idThe BitMEX price-level ID. It identifies the level. It is not a sequence number.
final_update_id234034541763data[].idSame as first_update_id.
prev_final_update_idnull—Null. BitMEX does not send sequence numbers.
last_update_id234034541763data[].idSame as first_update_id.
sideaskdata[].sidebid for Buy. ask for Sell. One row for each level.
price76863.7data[].priceConverted through a 64-bit float and written in the shortest form (76754.1). Thus, whole prices have no decimal point (240430).
quantity266900data[].sizeCopied from size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).
order_countnull—Null. BitMEX does not send order counts.

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.

WebSocket message (reconstructed) · orderBookL2:<symbol>received 2026-09-02 12:02:36.964308 UTC
{
"table": "orderBookL2",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"id": 234034599806,
"side": "Buy",
"size": 11300,
"price": 76745.5
}
]
}

Published row

received_time1788350556964308401—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350556964308401—Our receive time in nanoseconds. This is the same value as received_time. We do not publish the BitMEX timestamp of each level.
transaction_timenull—Null. We do not publish the BitMEX transactTime.
symbolXBTUSDTdata[].symbolCopied.
event_typeupdateactionupdate for all insert, update and delete messages.
first_update_id234034599806data[].idThe BitMEX price-level ID. It identifies the level. It is not a sequence number.
final_update_id234034599806data[].idSame as first_update_id.
prev_final_update_idnull—Null. BitMEX does not send sequence numbers.
last_update_id234034599806data[].idSame as first_update_id.
sidebiddata[].sidebid for Buy. ask for Sell. One row for each level.
price76745.5data[].priceConverted through a 64-bit float and written in the shortest form (76754.1). Thus, whole prices have no decimal point (240430).
quantity11300data[].sizeCopied from size. This is the new total of the level, in raw instrument units (XBTUSDT: 1 = 0.000001 XBT).
order_countnull—Null. BitMEX does not send order counts.

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.

WebSocket message (reconstructed) · orderBookL2:<symbol>received 2026-09-02 12:00:00.314243 UTC
{
"table": "orderBookL2",
"action": "delete",
"data": [
{
"symbol": "XBTUSDT",
"id": 234034541192,
"side": "Sell",
"price": 76864.3
},
{
"symbol": "XBTUSDT",
"id": 234034540919,
"side": "Buy",
"price": 76778.2
},
{
"symbol": "XBTUSDT",
"id": 234034540922,
"side": "Buy",
"price": 76774.8
},
{
"symbol": "XBTUSDT",
"id": 234034541040,
"side": "Buy",
"price": 76787.1
}
]
}

Published rows · 4

received_time1788350400314243121—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350400314243121—Our receive time in nanoseconds. This is the same value as received_time. We do not publish the BitMEX timestamp of each level.
transaction_timenull—Null. We do not publish the BitMEX transactTime.
symbolXBTUSDTdata[].symbolCopied.
event_typeupdateactionupdate for all insert, update and delete messages.
first_update_id234034541192data[].idThe BitMEX price-level ID. It identifies the level. It is not a sequence number.
final_update_id234034541192data[].idSame as first_update_id.
prev_final_update_idnull—Null. BitMEX does not send sequence numbers.
last_update_id234034541192data[].idSame as first_update_id.
sideaskdata[].sidebid for Buy. ask for Sell. One row for each level.
price76864.3data[].priceConverted through a 64-bit float and written in the shortest form (76754.1). Thus, whole prices have no decimal point (240430).
quantity0—0 for each level of a delete message. The level is removed.
order_countnull—Null. BitMEX does not send order counts.

Notes

  • Apply rows by level ID (last_update_id), not by price. An update row sets the size of the level with that ID, and quantity 0 removes 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 snapshot rows.
  • event_time is our receive time in nanoseconds, like received_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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:34.983233 UTC
{
"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",
"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,
"markPrice": 76820.3,
"indicativeSettlePrice": 76812.65,
"timestamp": "2026-09-02T12:02:32.653Z"
}
]
}

Published row

received_time1788350554983233849—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350552653data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
price_change-1324.699999999997data[].lastPricedata[].prevPrice24hlastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.
price_change_percent-1.66data[].lastChangePcntlastChangePcnt × 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).
weighted_average_pricenull—Null. We do not publish the BitMEX vwap.
last_price76607.6data[].lastPriceCopied from lastPrice.
last_quantitynull—Null. The instrument table has no last trade size.
open_price77932.3data[].prevPrice24hCopied from prevPrice24h, the price 24 hours earlier.
high_price78375.2data[].highPriceCopied from highPrice.
low_price76270data[].lowPriceCopied from lowPrice.
base_asset_volume6131600data[].volume24hCopied from volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).
quote_asset_volume473010789790data[].turnover24hCopied from turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).
statistics_open_timenull—Null. BitMEX does not send this value.
statistics_close_timenull—Null. BitMEX does not send this value.
first_trade_idnull—Null. BitMEX does not send this value.
last_trade_idnull—Null. BitMEX does not send this value.
total_tradesnull—Null. BitMEX does not send this value.

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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:35.747710 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"lastPrice": 76820.1,
"lastChangePcnt": -0.0143,
"timestamp": "2026-09-02T12:02:35.599Z"
}
]
}

Published row

received_time1788350555747710878—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350555599data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
price_changenulldata[].lastPricelastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.
price_change_percent-1.43data[].lastChangePcntlastChangePcnt × 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).
weighted_average_pricenull—Null. We do not publish the BitMEX vwap.
last_price76820.1data[].lastPriceCopied from lastPrice.
last_quantitynull—Null. The instrument table has no last trade size.
open_pricenull—Copied from prevPrice24h, the price 24 hours earlier.
high_pricenull—Copied from highPrice.
low_pricenull—Copied from lowPrice.
base_asset_volumenull—Copied from volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).
quote_asset_volumenull—Copied from turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).
statistics_open_timenull—Null. BitMEX does not send this value.
statistics_close_timenull—Null. BitMEX does not send this value.
first_trade_idnull—Null. BitMEX does not send this value.
last_trade_idnull—Null. BitMEX does not send this value.
total_tradesnull—Null. BitMEX does not send this value.

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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:32.796552 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"timestamp": "2026-09-02T12:02:32.653Z"
}
]
}

Published row

received_time1788350552796552489—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350552653data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
price_changenull—lastPrice − prevPrice24h, calculated in 64-bit floats. Thus, it can contain float noise (-1324.699999999997). Null if the message does not have both fields.
price_change_percentnull—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).
weighted_average_pricenull—Null. We do not publish the BitMEX vwap.
last_pricenull—Copied from lastPrice.
last_quantitynull—Null. The instrument table has no last trade size.
open_pricenull—Copied from prevPrice24h, the price 24 hours earlier.
high_pricenull—Copied from highPrice.
low_pricenull—Copied from lowPrice.
base_asset_volumenull—Copied from volume24h, in raw instrument units, not in base asset units. For XBTUSDT, 1 = 0.000001 XBT (6131600 is 6.1316 XBT).
quote_asset_volumenull—Copied from turnover24h, in BitMEX settlement units. For XBTUSDT, 1 = 0.000001 USDT (473010789790 is about 473,011 USDT).
statistics_open_timenull—Null. BitMEX does not send this value.
statistics_close_timenull—Null. BitMEX does not send this value.
first_trade_idnull—Null. BitMEX does not send this value.
last_trade_idnull—Null. BitMEX does not send this value.
total_tradesnull—Null. BitMEX does not send this value.

Notes

  • The instrument table supplies the ticker, mark price and open interest files. Each message becomes one row in each of the three files, with the same received_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 partial row.

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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:34.983233 UTC
{
"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",
"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,
"markPrice": 76820.3,
"indicativeSettlePrice": 76812.65,
"timestamp": "2026-09-02T12:02:32.653Z"
}
]
}

Published row

received_time1788350554983233849—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350552653data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
mark_price76820.3data[].markPriceCopied from markPrice. Null if the message has no markPrice.
index_pricenull—Null. The pipeline does not take an index price from the instrument table.
estimated_settle_price76812.65data[].indicativeSettlePriceCopied from indicativeSettlePrice. Null if the message does not contain it.
funding_rate0.0001data[].fundingRateCopied from 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.
next_funding_time1788379200000data[].fundingTimestampParsed from 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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:00:00.184573 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"fundingTimestamp": "2026-09-02T20:00:00.000Z",
"markPrice": 76837.13,
"timestamp": "2026-09-02T12:00:00.000Z"
}
]
}

Published row

received_time1788350400184573173—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350400000data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
mark_price76837.13data[].markPriceCopied from markPrice. Null if the message has no markPrice.
index_pricenull—Null. The pipeline does not take an index price from the instrument table.
estimated_settle_pricenull—Copied from indicativeSettlePrice. Null if the message does not contain it.
funding_ratenull—Copied from 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.
next_funding_time1788379200000data[].fundingTimestampParsed from 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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:00:00.228274 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"indicativeSettlePrice": 76827.79,
"timestamp": "2026-09-02T12:00:00.057Z"
}
]
}

Published row

received_time1788350400228274616—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788350400057data[].timestampParsed from the ISO 8601 timestamp. Milliseconds.
symbolXBTUSDTdata[].symbolCopied.
mark_pricenull—Copied from markPrice. Null if the message has no markPrice.
index_pricenull—Null. The pipeline does not take an index price from the instrument table.
estimated_settle_price76827.79data[].indicativeSettlePriceCopied from indicativeSettlePrice. Null if the message does not contain it.
funding_ratenull—Copied from 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.
next_funding_timenull—Parsed from fundingTimestamp, the next funding time. Milliseconds. Null if the message does not contain it.

Notes

  • The same instrument messages 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, only estimated_settle_price or 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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:34.983233 UTC
{
"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",
"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,
"markPrice": 76820.3,
"indicativeSettlePrice": 76812.65,
"timestamp": "2026-09-02T12:02:32.653Z"
}
]
}

Published row

received_time1788350554983233849—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
symbolXBTUSDTdata[].symbolCopied.
sum_open_interest60628400data[].openInterestCopied from openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.
sum_open_interest_valuenull—Null. We do not publish the BitMEX openValue.
timestamp1788350552653data[].timestampParsed from the ISO 8601 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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:36.595997 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"openInterest": 60608400,
"timestamp": "2026-09-02T12:02:36.454Z"
}
]
}

Published row

received_time1788350556595997632—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
symbolXBTUSDTdata[].symbolCopied.
sum_open_interest60608400data[].openInterestCopied from openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.
sum_open_interest_valuenull—Null. We do not publish the BitMEX openValue.
timestamp1788350556454data[].timestampParsed from the ISO 8601 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.

WebSocket message (reconstructed) · instrument:<symbol>received 2026-09-02 12:02:32.796552 UTC
{
"table": "instrument",
"action": "update",
"data": [
{
"symbol": "XBTUSDT",
"timestamp": "2026-09-02T12:02:32.653Z"
}
]
}

Published row

received_time1788350552796552489—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
symbolXBTUSDTdata[].symbolCopied.
sum_open_interestnull—Copied from openInterest, in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (60628400 is 60.6284 XBT). Null if the message has no openInterest.
sum_open_interest_valuenull—Null. We do not publish the BitMEX openValue.
timestamp1788350552653data[].timestampParsed from the ISO 8601 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.

WebSocket message (reconstructed) · liquidation:<symbol>received 2026-09-01 12:01:26.784605 UTC
{
"table": "liquidation",
"action": "insert",
"data": [
{
"symbol": "XBTUSDT",
"side": "Sell",
"price": 78007,
"leavesQty": 14800
}
]
}

Published row

received_time1788264086784605200—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. BitMEX does not send this value.
event_time1788264086784—BitMEX liquidation messages do not contain a timestamp, thus this is our receive time. The pipeline wrote it in nanoseconds. On 2026-10-04, we converted the published history to milliseconds.
symbolXBTUSDTdata[].symbolCopied.
sideSELLdata[].sideChanged to uppercase. The side of the BitMEX liquidation order. SELL closes a liquidated long position. BUY closes a liquidated short position.
order_typeMarket—Constant Market. This is a placeholder because BitMEX does not send an order type here.
time_in_forceIOC—Constant IOC. This is a placeholder because BitMEX does not send a time in force here.
quantity14800data[].leavesQtyCopied from leavesQty (the table has no orderQty), in raw instrument units. For XBTUSDT, 1 = 0.000001 XBT (14800 is 0.0148 XBT).
price78007data[].priceCopied. The price of the liquidation order. Converted through a 64-bit float and written in the shortest form.
average_price78007data[].priceSame value as price. Not an average fill price.
order_statusFILLED—Constant FILLED. This is a placeholder because the message gives no information about fills.
last_filled_quantity14800data[].leavesQtySame value as quantity. Not a fill.
filled_quantity14800data[].leavesQtySame value as quantity. Not a fill.
trade_time1788264086784—Same as 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 converted event_time and trade_time from 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_force and order_status are placeholders, and the fill columns repeat quantity.
  • 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.

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

Contact support