Exchange Wire Formats

Bitget Futures wire format

This page shows how Bitget USDT-M, USDC-M and Coin-M Futures 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 Bitget USDT-M, USDC-M and Coin-M Futures 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 subscribes to the books, trade and ticker channels for every tradable contract of these product types: USDT-FUTURES, USDC-FUTURES (for example BTCPERP) and COIN-FUTURES. It also subscribes to the liquidation topic one time for each product type. The examples use BTCUSDT. The collector does not use REST polls. Open interest and mark prices come from the ticker channel.

  • Public WebSocket V2 (order book, trades, ticker): wss://ws.bitget.com/v2/ws/public
  • Public WebSocket V3 (liquidations): wss://ws.bitget.com/v3/ws/public

Exchange API reference: www.bitget.com. For the conventions that apply to all exchanges, refer to the wire formats overview.

Trades

One row per trade from the trade channel.

  • WebSocket trade

Trade snapshot after subscription

Immediately after the collector subscribes, Bitget sends the recent trades again as one snapshot message, newest first. We publish them like all other trades, with the oldest trade first. We remove the trades that we already published in an earlier hour, or earlier in the same hour.

Shortened: The snapshot contained the 50 most recent trades. This example shows the newest three.

WebSocket message · tradereceived 2026-10-05 19:11:22.132028 UTC
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "trade",
"instId": "BTCUSDT"
},
"data": [
{
"ts": "1791227481512",
"price": "85599.9",
"size": "0.2581",
"side": "buy",
"tradeId": "1491081618619383808"
},
{
"ts": "1791227480460",
"price": "85599.9",
"size": "0.209",
"side": "buy",
"tradeId": "1491081614206976018"
},
{
"ts": "1791227480460",
"price": "85599.9",
"size": "0.0001",
"side": "buy",
"tradeId": "1491081614206976016"
}
],
"ts": 1791227482003
}

Published rows · 3

received_time1791227482132028000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227480460data[].tsCopied from the fill time of the trade, data[].ts, not from the envelope ts. Milliseconds.
symbolBTCUSDTarg.instIdCopied.
trade_id1491081614206976016data[].tradeIdCopied. We store it as an integer.
price85599.9data[].priceCopied as the exact decimal string.
quantity0.0001data[].sizeCopied as the exact decimal string. Base asset units.
trade_time1791227480460data[].tsCopied. Milliseconds. Same value as event_time.
is_buyer_makerfalsedata[].sidetrue when the taker side (side) is sell. false when it is buy.
order_typeMARKET—Always MARKET. Bitget does not send an order type, so this value is a placeholder.

Trade update

Later messages contain only new trades. One message can contain several trades, newest first. Each trade becomes its own row.

WebSocket message · tradereceived 2026-10-05 19:11:27.315542 UTC
{
"action": "update",
"arg": {
"instType": "USDT-FUTURES",
"channel": "trade",
"instId": "BTCUSDT"
},
"data": [
{
"ts": "1791227487186",
"price": "85599.8",
"size": "0.0027",
"side": "sell",
"tradeId": "1491081642417864704"
}
],
"ts": 1791227487186
}

Published row

received_time1791227487315542000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227487186data[].tsCopied from the fill time of the trade, data[].ts, not from the envelope ts. Milliseconds.
symbolBTCUSDTarg.instIdCopied.
trade_id1491081642417864704data[].tradeIdCopied. We store it as an integer.
price85599.8data[].priceCopied as the exact decimal string.
quantity0.0027data[].sizeCopied as the exact decimal string. Base asset units.
trade_time1791227487186data[].tsCopied. Milliseconds. Same value as event_time.
is_buyer_makertruedata[].sidetrue when the taker side (side) is sell. false when it is buy.
order_typeMARKET—Always MARKET. Bitget does not send an order type, so this value is a placeholder.

Notes

  • The Bitget side is the side of the taker. Bitget does not send an order type, so order_type is always MARKET. Use is_buyer_maker for the aggressor side.
  • Trade IDs increase over time, but they are not consecutive. Do not use gaps in trade_id to find trades that the collector did not receive.

For the column types and descriptions, refer to the Trades schema.

Order Book

One row per price level from the books channel. The channel sends a snapshot after the collector subscribes, then incremental updates.

  • WebSocket books

Order book snapshot

The first books message after the collector subscribes (and after each reconnection) is a snapshot of the order book. Each level becomes one snapshot row.

Shortened: Bitget sent 500 bid levels and 500 ask levels in this snapshot. This example shows the best three of each.

WebSocket message · booksreceived 2026-10-05 19:11:22.394450 UTC
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "books",
"instId": "BTCUSDT"
},
"data": [
{
"asks": [
["85599.9", "0.5811"],
["85600", "0.1907"],
["85601.9", "0.0002"]
],
"bids": [
["85599.8", "3.4111"],
["85599.7", "0.0598"],
["85599.2", "0.2628"]
],
"ts": "1791227482002",
"seq": 1062970931190,
"pseq": 0
}
],
"ts": 1791227482021
}

Published rows · 6

received_time1791227482394450000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227482021tsCopied from the envelope ts, Bitget's push time. Milliseconds.
transaction_time1791227482002data[].tsCopied from data[].ts, the matching-engine time. Milliseconds.
symbolBTCUSDTarg.instIdCopied.
event_typesnapshotactionsnapshot when action is snapshot.
first_update_idnull—Null. Bitget sends one sequence number per push, not a range.
final_update_id1062970931190data[].seqCopied.
prev_final_update_idnull—Null for snapshots, because a snapshot starts a new seq chain. Bitget sends pseq 0 with snapshots.
last_update_idnull—Null. Bitget does not send a separate last update ID.
sidebiddata[].bidsdata[].asksbid for levels in bids, ask for levels in asks. One row per level.
price85599.8data[].bids[][0]data[].asks[][0]Copied as the exact decimal string.
quantity3.4111data[].bids[][1]data[].asks[][1]Copied as the exact decimal string. The value is the total size at that price. Base asset units.
order_countnull—Null. The Bitget books channel does not send order counts.

Order book update

The first update after the snapshot above. Its pseq equals the seq of the snapshot, so the sequence chain has no break.

Shortened: Bitget sent 8 bid levels and 17 ask levels in this update. This example shows the first 2 bid levels and the first 3 ask levels.

WebSocket message · booksreceived 2026-10-05 19:11:22.394832 UTC
{
"action": "update",
"arg": {
"instType": "USDT-FUTURES",
"channel": "books",
"instId": "BTCUSDT"
},
"data": [
{
"asks": [
["85602.2", "0"],
["85603.7", "0.0001"],
["85603.8", "0.0808"]
],
"bids": [
["85599.8", "3.8911"],
["85599.7", "0.0597"]
],
"ts": "1791227482100",
"seq": 1062970936888,
"pseq": 1062970931190
}
],
"ts": 1791227482103
}

Published rows · 5

received_time1791227482394832000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227482103tsCopied from the envelope ts, Bitget's push time. Milliseconds.
transaction_time1791227482100data[].tsCopied from data[].ts, the matching-engine time. Milliseconds.
symbolBTCUSDTarg.instIdCopied.
event_typeupdateactionupdate when action is update.
first_update_idnull—Null. Bitget sends one sequence number per push, not a range.
final_update_id1062970936888data[].seqCopied.
prev_final_update_id1062970931190data[].pseqCopied. The seq of the previous push on this subscription. If it is different from the final_update_id of the previous message, there is a gap. All rows of one message have the same value. Thus, check it one time per message, not per row.
last_update_idnull—Null. Bitget does not send a separate last update ID.
sidebiddata[].bidsdata[].asksbid for levels in bids, ask for levels in asks. One row per level.
price85599.8data[].bids[][0]data[].asks[][0]Copied as the exact decimal string.
quantity3.8911data[].bids[][1]data[].asks[][1]Copied as the exact decimal string. The value is the new total size at that price. Base asset units. 0 removes the level.
order_countnull—Null. The Bitget books channel does not send order counts.

Notes

  • From the October 2026 pipeline update, transaction_time contains the matching-engine time. In files that we wrote before this update, it is null. In all files, event_time is the push time.
  • The prev_final_update_id (pseq) of each update equals the final_update_id (seq) of the previous message. A different value shows a lost message. If this occurs, start again from the next snapshot.
  • We publish a message with no bid levels and no ask levels as one row with side noop, price 0 and quantity 0. Thus, the seq chain stays complete. A noop update does not change a level. A noop snapshot means that the order book is empty. When you replay it, clear your order book.
  • A file can start with a checkpoint snapshot of the order book that we kept from the previous hour. Its received_time is the start of the hour, and its transaction_time is null. Its final_update_id and last_update_id both contain the seq of the last message that we applied. The prev_final_update_id of the next update links to this checkpoint.

For the column types and descriptions, refer to the Order Book schema.

Ticker

One row per ticker push.

  • WebSocket ticker
WebSocket message · tickerreceived 2026-10-05 19:11:22.136978 UTC
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "ticker",
"instId": "BTCUSDT"
},
"data": [
{
"instId": "BTCUSDT",
"lastPr": "85599.9",
"bidPr": "85599.8",
"askPr": "85599.9",
"bidSz": "4.0378",
"askSz": "0.4618",
"open24h": "85345.7",
"high24h": "86966.9",
"low24h": "84929.5",
"change24h": "0.00298",
"fundingRate": "0.000063",
"nextFundingTime": "1791244800000",
"markPrice": "85599.9",
"indexPrice": "85636.34",
"holdingAmount": "31506.4859999999786",
"baseVolume": "41733.57",
"quoteVolume": "3588373746.3737",
"openUtc": "86473.2",
"symbolType": "1",
"symbol": "BTCUSDT",
"ts": "1791227481990"
}
],
"ts": 1791227481991
}

Published row

received_time1791227482136978000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227481991tsCopied from the envelope ts, Bitget's push time. Milliseconds.
symbolBTCUSDTdata[].instIdCopied.
price_changenull—Null. Bitget does not send the absolute 24h price change.
price_change_percent0.298data[].change24hchange24h multiplied by 100. Bitget sends a fraction (0.01 is 1 %). The column is in percent.
weighted_average_pricenull—Null. Bitget does not send a weighted average price.
last_price85599.9data[].lastPrCopied.
last_quantitynull—Null. Bitget's ticker does not send the last trade size.
open_price85345.7data[].open24hCopied. The price 24 hours ago (rolling window), not the open price of the UTC day.
high_price86966.9data[].high24hCopied. Rolling 24 hours.
low_price84929.5data[].low24hCopied. Rolling 24 hours.
base_asset_volume41733.57data[].baseVolumeCopied. 24h volume in base asset units.
quote_asset_volume3588373746.3737data[].quoteVolumeCopied. 24h volume in quote asset units.
statistics_open_timenull—Null. Bitget does not send the window bounds.
statistics_close_timenull—Null. Bitget does not send the window bounds.
first_trade_idnull—Null. Bitget does not send trade ID ranges.
last_trade_idnull—Null. Bitget does not send trade ID ranges.
total_tradesnull—Null. Bitget does not send a trade count.

Notes

  • From the October 2026 pipeline update, price_change_percent is in percent. Files that we wrote before this update contain the Bitget fraction without changes (0.01 for 1 %). Multiply those values by 100.
  • We do not publish the best bid and ask of the ticker (bidPr, askPr, bidSz, askSz) or openUtc. Mark price, index price and funding go to mark_price. Open interest goes to open_interest.

For the column types and descriptions, refer to the Ticker schema.

Mark Price

One row per futures ticker push, from the mark price, index price and funding fields of the ticker. The collector does not subscribe to a separate mark price channel.

  • WebSocket ticker

The same ticker message as on the ticker page. Every futures ticker push also becomes one mark price row.

WebSocket message · tickerreceived 2026-10-05 19:11:22.136978 UTC
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "ticker",
"instId": "BTCUSDT"
},
"data": [
{
"instId": "BTCUSDT",
"lastPr": "85599.9",
"bidPr": "85599.8",
"askPr": "85599.9",
"bidSz": "4.0378",
"askSz": "0.4618",
"open24h": "85345.7",
"high24h": "86966.9",
"low24h": "84929.5",
"change24h": "0.00298",
"fundingRate": "0.000063",
"nextFundingTime": "1791244800000",
"markPrice": "85599.9",
"indexPrice": "85636.34",
"holdingAmount": "31506.4859999999786",
"baseVolume": "41733.57",
"quoteVolume": "3588373746.3737",
"openUtc": "86473.2",
"symbolType": "1",
"symbol": "BTCUSDT",
"ts": "1791227481990"
}
],
"ts": 1791227481991
}

Published row

received_time1791227482136978000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227481991tsCopied from the envelope ts, Bitget's push time. Milliseconds.
symbolBTCUSDTdata[].instIdCopied.
mark_price85599.9data[].markPriceCopied.
index_price85636.34data[].indexPriceCopied.
estimated_settle_pricenull—Copied from deliveryPrice when the push contains it. Bitget documents this field for delivery contracts, and sends it from one hour before delivery. Null here, because this perpetual ticker has no deliveryPrice field.
funding_rate0.000063data[].fundingRateCopied. A fraction per funding period: 0.000063 is 0.0063 %.
next_funding_time1791244800000data[].nextFundingTimeCopied. The time of the next funding settlement, in milliseconds.

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

Open Interest

One row per ticker push, from the ticker's holdingAmount. There is no REST poll.

  • WebSocket ticker

The same ticker message again. Every futures ticker push also becomes one open interest row.

WebSocket message · tickerreceived 2026-10-05 19:11:22.136978 UTC
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "ticker",
"instId": "BTCUSDT"
},
"data": [
{
"instId": "BTCUSDT",
"lastPr": "85599.9",
"bidPr": "85599.8",
"askPr": "85599.9",
"bidSz": "4.0378",
"askSz": "0.4618",
"open24h": "85345.7",
"high24h": "86966.9",
"low24h": "84929.5",
"change24h": "0.00298",
"fundingRate": "0.000063",
"nextFundingTime": "1791244800000",
"markPrice": "85599.9",
"indexPrice": "85636.34",
"holdingAmount": "31506.4859999999786",
"baseVolume": "41733.57",
"quoteVolume": "3588373746.3737",
"openUtc": "86473.2",
"symbolType": "1",
"symbol": "BTCUSDT",
"ts": "1791227481990"
}
],
"ts": 1791227481991
}

Published row

received_time1791227482136978000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
symbolBTCUSDTdata[].instIdCopied.
sum_open_interest31506.4859999999786data[].holdingAmountCopied exactly as Bitget sent it, with its float noise (…9999786). Base asset units.
sum_open_interest_value2696952050.95139817data[].holdingAmountdata[].markPriceholdingAmount × markPrice, computed in exact decimal and rounded to 8 decimal places. Quote currency (USDT for USDT-margined contracts, USDC for USDC-margined contracts, USD for coin-margined contracts). Null if the push does not contain one of the two fields.
timestamp1791227481990data[].tsCopied from data[].ts, Bitget's data time. Milliseconds.

Notes

  • Rows repeat at the rate of the ticker, even when open interest does not change.
  • sum_open_interest_value was empty before the 2026-09 data-integrity release.

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

Liquidations

One row per entry of the V3 liquidation topic. The collector subscribes to this topic one time for each product type (usdt-futures, usdc-futures, coin-futures).

  • WebSocket liquidation

No BTCUSDT liquidation arrived during our capture, so this example is for ZECUSDT. The sell side means that a short position was liquidated.

WebSocket message · liquidationreceived 2026-10-05 19:13:37.850963 UTC
{
"action": "update",
"arg": {
"instType": "usdt-futures",
"topic": "liquidation"
},
"data": [
{
"symbol": "ZECUSDT",
"side": "sell",
"price": "1348.598068598069",
"amount": "775.443889443889",
"ts": "1791227617704"
}
],
"ts": 1791227617724
}

Published row

received_time1791227617850963000—Our collector's clock when it received the message, in nanoseconds since the Unix epoch. Bitget does not send this value.
event_time1791227617704data[].tsCopied from the liquidation time data[].ts. Milliseconds.
symbolZECUSDTdata[].symbolCopied.
sideBUYdata[].sideThe side of the liquidation order. buy (a long position was liquidated) becomes SELL. sell (a short position was liquidated) becomes BUY.
order_typeMarket—Always Market. This value is a placeholder, because Bitget does not send an order type.
time_in_forceIOC—Always IOC. This value is a placeholder, because Bitget does not send a time in force.
quantity0.575data[].amountdata[].priceamount ÷ price, computed in exact decimal and rounded to 6 decimal places. Base asset units. Bitget sends amount in quote currency.
price1348.598068598069data[].priceCopied. Bitget's liquidation price.
average_price1348.598068598069data[].priceA copy of price. Bitget does not send an average fill price.
order_statusFILLED—Always FILLED. This value is a placeholder, because Bitget does not send an order status.
last_filled_quantity0.575data[].amountdata[].priceSame value as quantity.
filled_quantity0.575data[].amountdata[].priceSame value as quantity.
trade_time1791227617704data[].tsCopied. Milliseconds. Same value as event_time.

Notes

  • Bitget sends liquidations one time per second. Each second, it sends at most one record per symbol and position side: the largest record. The rows are a sample that the exchange selects, and do not include every liquidation. Thus, counts and totals are a lower bound.
  • We do not publish an entry without a positive price and amount, because it has no valid base quantity. Before the October 2026 pipeline update, we published such an entry with the quote amount as its quantity.

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