Kraken Futures wire format
This page shows how Kraken 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 Kraken 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.
Kraken Futures lists linear contracts and inverse contracts. Linear multi-collateral contracts (PF_ perpetuals, FF_ fixed maturity) have sizes in base asset units. Inverse contracts (PI_ perpetuals, FI_ fixed maturity) have a value of USD 1 each. The collector subscribes to the book, trade and ticker feeds. Kraken sends prices and sizes as JSON numbers. We parse them as 64-bit floats and write the shortest decimal that round-trips. Thus, we drop a trailing .0. Ticker, mark price and open interest rows all come from the same ticker messages.
- Public WebSocket (book, trade, ticker feeds):
wss://futures.kraken.com/ws/v1 - REST (instrument metadata):
https://futures.kraken.com/derivatives/api/v3/instruments
Exchange API reference: docs.kraken.com. For the conventions that apply to all exchanges, refer to the wire formats overview.
Trades
One row per trade from the trade feed. This also includes the trade_snapshot that Kraken sends after each subscription.
- WebSocket trade
- WebSocket trade_snapshot
Trade
{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "66e6153c-44ae-4985-bf0c-6943336aa975",→ trade_id"side": "buy",→ is_buyer_maker"type": "fill",→ order_type"time": 1791227712160,→ event_time · trade_time"qty": 0.0129,→ quantity"price": 85664.0,→ price"seq": 1086905}
Published row
trade_time.uid is a UUID string. We store a stable 63-bit FNV-1a hash of it. Thus, the same uid always gives the same trade_id. The IDs are not sequential.85663.0 becomes 85663.price. For PF_ and FF_ contracts, the value is in base asset units (BTC for PF_XBTUSD). For inverse PI_ and FI_ contracts, the value is the number of USD 1 contracts.true when side is sell. Kraken's side is the taker's side.Market for fill, Liquidation for liquidation, Termination for termination, Block for block. Any other type (Kraken also sends assignment) becomes Market.Subscription trade snapshot
After each trade subscription, also after each reconnect, Kraken sends the most recent trades of the product in one trade_snapshot message. These trades fill the trades that the collector did not receive during the reconnect. We drop a trade if we already received its uid live or published it in an earlier hour. We also drop a trade if its time is more than 5 seconds before the hour that we process.
Shortened: Kraken sent 100 trades in this snapshot. The example shows the newest three trades. Each trade becomes a separate row.
{"feed": "trade_snapshot","product_id": "PF_XBTUSD","trades": [{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "11f44e6c-6e7c-49fa-8e00-47504294b2e7",→ trade_id"side": "buy",→ is_buyer_maker"type": "fill",→ order_type"time": 1791227710087,→ event_time · trade_time"qty": 0.0002,→ quantity"price": 85664.0,→ price"seq": 1086904},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "1b1d6268-e685-4330-892c-30281aa88fab",→ trade_id"side": "sell",→ is_buyer_maker"type": "fill",→ order_type"time": 1791227705302,→ event_time · trade_time"qty": 0.0002,→ quantity"price": 85663.0,→ price"seq": 1086903},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "17bef1f0-d4ff-4672-8004-143ef54ac870",→ trade_id"side": "sell",→ is_buyer_maker"type": "fill",→ order_type"time": 1791227705302,→ event_time · trade_time"qty": 0.0001,→ quantity"price": 85663.0,→ price"seq": 1086902}]}
Published rows · 3
trade_time.uid is a UUID string. We store a stable 63-bit FNV-1a hash of it. Thus, the same uid always gives the same trade_id. The IDs are not sequential.85663.0 becomes 85663.price. For PF_ and FF_ contracts, the value is in base asset units (BTC for PF_XBTUSD). For inverse PI_ and FI_ contracts, the value is the number of USD 1 contracts.true when side is sell. Kraken's side is the taker's side.Market for fill, Liquidation for liquidation, Termination for termination, Block for block. Any other type (Kraken also sends assignment) becomes Market.Subscription trade snapshot after the hour started
We received this snapshot 8.8 seconds after 20:00 UTC. If the time of a trade is up to 5 seconds before the hour, we publish the trade in the new hour. The two oldest trades in the example are 6.3 and 7.1 seconds older than the hour. We drop them, because they belong to the previous hour, and we already processed that hour.
Shortened: Kraken sent 100 trades in this snapshot. The example shows the newest trade and the four trades around the 5-second limit.
{"feed": "trade_snapshot","product_id": "PF_XBTUSD","trades": [{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "9735e2e3-bcd1-45e0-877b-3f4c4bd5a8e5",→ trade_id"side": "buy",→ is_buyer_maker"type": "fill",→ order_type"time": 1791230406349,→ event_time · trade_time"qty": 0.0003,→ quantity"price": 85737.0,→ price"seq": 1092138},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "a8e526ba-8336-4bb0-9849-0547959aca4e",→ trade_id"side": "sell",→ is_buyer_maker"type": "fill",→ order_type"time": 1791230395105,→ event_time · trade_time"qty": 0.0001,→ quantity"price": 85719.0,→ price"seq": 1092074},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "038370aa-388b-4e72-b694-abaf0cdcdf84",→ trade_id"side": "sell",→ is_buyer_maker"type": "fill",→ order_type"time": 1791230395105,→ event_time · trade_time"qty": 0.0111,→ quantity"price": 85719.0,→ price"seq": 1092073},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "95c75034-8f8e-482b-b4dc-2ba0831d1233",→ trade_id"side": "buy",→ is_buyer_maker"type": "fill",→ order_type"time": 1791230393740,→ event_time · trade_time"qty": 0.0012,→ quantity"price": 85720.0,→ price"seq": 1092072},{"product_id": "PF_XBTUSD",→ symbol"feed": "trade","uid": "8d6f2378-b87c-4a07-828e-fc5d6c3e714d",→ trade_id"side": "buy",→ is_buyer_maker"type": "fill",→ order_type"time": 1791230392891,→ event_time · trade_time"qty": 0.0012,→ quantity"price": 85723.0,→ price"seq": 1092071}]}
Published rows · 3
trade_time.uid is a UUID string. We store a stable 63-bit FNV-1a hash of it. Thus, the same uid always gives the same trade_id. The IDs are not sequential.85663.0 becomes 85663.price. For PF_ and FF_ contracts, the value is in base asset units (BTC for PF_XBTUSD). For inverse PI_ and FI_ contracts, the value is the number of USD 1 contracts.true when side is sell. Kraken's side is the taker's side.Market for fill, Liquidation for liquidation, Termination for termination, Block for block. Any other type (Kraken also sends assignment) becomes Market.Notes
trade_idis a hash of Kraken's UUIDuid, not a sequence number. You cannot find gaps fromtrade_id.- Kraken also sends trades with
typeassignment. We publish them withorder_typeMarket, as a normal fill. - Files from before the October 2026 pipeline update do not include trades that we recovered from
trade_snapshotmessages. Thus, these files do not contain the trades that the collector did not receive during a reconnect. - We also publish trades with
typeliquidationorterminationin the liquidations file. Refer to Liquidations below.
For the column types and descriptions, refer to the Trades schema.
Order Book
One row per price level. After each subscription, book_snapshot messages give the full order book. Each book message changes one level.
- WebSocket book_snapshot
- WebSocket book
Order book snapshot
After each book subscription, also after each reconnect, Kraken sends the order book in one book_snapshot message. Each level becomes one snapshot row.
Shortened: Kraken sent 2290 bid levels and 1181 ask levels. The example shows the best three levels of each side.
{"feed": "book_snapshot",→ event_type"product_id": "PF_XBTUSD",→ symbol"timestamp": 1791227712104,→ event_time"seq": 232413555,→ last_update_id"tickSize": null,"bids": [→ side{→ side"price": 85663.0,→ side · price"qty": 0.0844→ side · quantity},{→ side"price": 85662.0,→ side · price"qty": 0.015→ side · quantity},{→ side"price": 85661.0,→ side · price"qty": 0.014→ side · quantity}],"asks": [→ side{→ side"price": 85664.0,→ side · price"qty": 0.0129→ side · quantity},{→ side"price": 85665.0,→ side · price"qty": 0.0002→ side · quantity},{→ side"price": 85667.0,→ side · price"qty": 0.0674→ side · quantity}]}
Published rows · 6
snapshot for book_snapshot messages.book update usually carries seq + 1.bid for levels in bids, ask for levels in asks. One row per level.85663.0 becomes 85663.price. Base asset units for PF_ contracts, USD 1 contracts for PI_ contracts.Order book update (removed level)
Each book message changes one price level. qty is the new total at that price. 0.0 removes the level.
{"feed": "book",→ event_type"product_id": "PF_XBTUSD",→ symbol"side": "sell",→ side"seq": 232413575,→ last_update_id"price": 85664.0,→ price"qty": 0.0,→ quantity"timestamp": 1791227712162→ event_time}
Published row
update for book messages.book message for the product increases seq by 1. A jump is a gap.bid for buy, ask for sell.85663.0 becomes 85663.price. We publish 0.0 as 0, which removes the level.Notes
last_update_idcontains Kraken'sseq. Kraken countsseqfor each product. Eachbookmessage increases it by 1. Thus, a jump is a gap. The first update after abook_snapshotusually has theseqof the snapshot + 1, but it can be higher. The pipeline accepts it.- Several
bookmessages can have the sameevent_time. Sort the rows byreceived_timeand then bylast_update_id. - A file can start with a checkpoint snapshot of the order book from the previous hour. Its
received_timeis the start of the hour. Itslast_update_idis theseqof the last applied message. We write this snapshot only when we can prove that the order book is current. If there is no checkpoint snapshot, continue from the order book of the previous hour, or wait for the next snapshot in the file. - We publish an empty
book_snapshotas onesnapshotrow withsidenoop,price0andquantity0. This row has theseqof the snapshot. When you read this row, clear the order book.
For the column types and descriptions, refer to the Order Book schema.
Ticker
One row per ticker message. Kraken sends these messages at irregular intervals. On busy markets, Kraken sends several messages each second. Consecutive messages can have the same time.
- WebSocket ticker
Ticker, linear perpetual (PF_XBTUSD)
{"time": 1791227712132,→ event_time"product_id": "PF_XBTUSD",→ symbol"funding_rate": 0.35319855164890357,"funding_rate_prediction": 0.0612474778575,"relative_funding_rate": 4.123429166667e-6,"relative_funding_rate_prediction": 7.1475e-7,"next_funding_rate_time": 1791230400000,"leverage": "100x","premium": -0.0,"feed": "ticker","bid": 85663.0,"ask": 85664.0,"bid_size": 0.0856,"ask_size": 0.0129,"volume": 5864.7333,→ base_asset_volume"dtm": 0,"index": 85665.91,"last": 85664.0,→ price_change · last_price"change": 0.34,→ price_change_percent"suspended": false,"tag": "perpetual","pair": "XBT:USD","openInterest": 2145.0821,"markPrice": 85664.79402421133,"maturityTime": 0,"post_only": false,"volumeQuote": 504231341.4699,→ quote_asset_volume"open": 85376.0,→ price_change · open_price"high": 86990.0,→ high_price"low": 84963.0→ low_price}
Published row
last − open. We calculate it as an exact decimal. This is the absolute 24-hour change. Null when open is 0.change is the 24-hour change in percent. 0.34 means +0.34 %.85663.0 becomes 85663.volume (contracts) × the contract size from Kraken's instruments endpoint (1 for PF_XBTUSD). Base asset units.Ticker, inverse perpetual (PI_XBTUSD)
Each inverse contract has a value of USD 1. Thus, it is not possible to give their volume in BTC.
{"time": 1791227712067,→ event_time"product_id": "PI_XBTUSD",→ symbol"funding_rate": 3.85624173e-10,"funding_rate_prediction": 3.7702427e-10,"relative_funding_rate": 0.000033031220833333,"relative_funding_rate_prediction": 0.0000323075,"next_funding_rate_time": 1791230400000,"leverage": "50x","premium": 0.0,"feed": "ticker","bid": 85610.0,"ask": 85777.5,"bid_size": 10.0,"ask_size": 10573.0,"volume": 208456.0,→ base_asset_volume"dtm": 0,"index": 85665.91,"last": 85425.0,→ price_change · last_price"change": 0.07,→ price_change_percent"suspended": false,"tag": "perpetual","pair": "XBT:USD","openInterest": 2361300.0,"markPrice": 85688.7933200642,"maturityTime": 0,"post_only": false,"volumeQuote": 208456.0,→ quote_asset_volume"open": 85369.5,→ price_change · open_price"high": 86931.0,→ high_price"low": 85064.0→ low_price}
Published row
last − open. We calculate it as an exact decimal. This is the absolute 24-hour change. Null when open is 0.change is the 24-hour change in percent. 0.34 means +0.34 %.85663.0 becomes 85663.volume counts USD 1 contracts. These markets have no exact base asset volume.Notes
price_changeis absolute (last−open).price_change_percentis Kraken's percentage. Files from before the 2026-09 data-integrity release had Kraken's percentage inprice_change. We corrected these files on 2026-09-30.- For inverse
PI_andFI_contracts, files from before the October 2026 pipeline update have the contract count inbase_asset_volume. In current files, this value is null, because those contracts are USD amounts.
For the column types and descriptions, refer to the Ticker schema.
Mark Price
One row per ticker message, from the same messages as the ticker rows.
- WebSocket ticker
{"time": 1791227712132,→ event_time"product_id": "PF_XBTUSD",→ symbol"funding_rate": 0.35319855164890357,"funding_rate_prediction": 0.0612474778575,"relative_funding_rate": 4.123429166667e-6,→ funding_rate"relative_funding_rate_prediction": 7.1475e-7,"next_funding_rate_time": 1791230400000,→ next_funding_time"leverage": "100x","premium": -0.0,"feed": "ticker","bid": 85663.0,"ask": 85664.0,"bid_size": 0.0856,"ask_size": 0.0129,"volume": 5864.7333,"dtm": 0,"index": 85665.91,→ index_price"last": 85664.0,"change": 0.34,"suspended": false,"tag": "perpetual","pair": "XBT:USD","openInterest": 2145.0821,"markPrice": 85664.79402421133,→ mark_price"maturityTime": 0,"post_only": false,"volumeQuote": 504231341.4699,"open": 85376.0,"high": 86990.0,"low": 84963.0}
Published row
85663.0 becomes 85663.4.123429166667e-6 is 0.000412 %). We write it in plain decimal notation. Kraken's funding_rate field is an absolute amount for each contract, and we do not publish it. Null when Kraken does not send the field. Kraken does not send it when the rate is zero, and for fixed-maturity contracts.Notes
funding_rateis Kraken'srelative_funding_rate. You can compare it with other venues. Files from before the 2026-09 data-integrity release contain the absolutefunding_rate. Refer to the venue notes.- Kraken's API documentation describes
next_funding_rate_timeas the time until the next funding. The values that Kraken sends are Unix timestamps in milliseconds, as in this example.
For the column types and descriptions, refer to the Mark Price schema.
Open Interest
One row per ticker message, from Kraken's openInterest field.
- WebSocket ticker
Ticker, linear perpetual (PF_XBTUSD)
{"time": 1791227712132,→ timestamp"product_id": "PF_XBTUSD",→ symbol"funding_rate": 0.35319855164890357,"funding_rate_prediction": 0.0612474778575,"relative_funding_rate": 4.123429166667e-6,"relative_funding_rate_prediction": 7.1475e-7,"next_funding_rate_time": 1791230400000,"leverage": "100x","premium": -0.0,"feed": "ticker","bid": 85663.0,"ask": 85664.0,"bid_size": 0.0856,"ask_size": 0.0129,"volume": 5864.7333,"dtm": 0,"index": 85665.91,"last": 85664.0,"change": 0.34,"suspended": false,"tag": "perpetual","pair": "XBT:USD","openInterest": 2145.0821,→ sum_open_interest · sum_open_interest_value"markPrice": 85664.79402421133,→ sum_open_interest_value"maturityTime": 0,"post_only": false,"volumeQuote": 504231341.4699,"open": 85376.0,"high": 86990.0,"low": 84963.0}
Published row
PF_ contracts.openInterest × contract size × markPrice, as an exact decimal. We round it to 8 decimal places. Quote currency (USD for PF_XBTUSD).Ticker, inverse perpetual (PI_XBTUSD)
{"time": 1791227712067,→ timestamp"product_id": "PI_XBTUSD",→ symbol"funding_rate": 3.85624173e-10,"funding_rate_prediction": 3.7702427e-10,"relative_funding_rate": 0.000033031220833333,"relative_funding_rate_prediction": 0.0000323075,"next_funding_rate_time": 1791230400000,"leverage": "50x","premium": 0.0,"feed": "ticker","bid": 85610.0,"ask": 85777.5,"bid_size": 10.0,"ask_size": 10573.0,"volume": 208456.0,"dtm": 0,"index": 85665.91,"last": 85425.0,"change": 0.07,"suspended": false,"tag": "perpetual","pair": "XBT:USD","openInterest": 2361300.0,→ sum_open_interest · sum_open_interest_value"markPrice": 85688.7933200642,"maturityTime": 0,"post_only": false,"volumeQuote": 208456.0,"open": 85369.5,"high": 86931.0,"low": 85064.0}
Published row
PI_ contracts.openInterest × contract size (USD 1), as an exact decimal. We round it to 8 decimal places. USD.Notes
- When we process the hour, the contract size and type come from Kraken's instruments endpoint. If the endpoint does not list an instrument, or we cannot connect to the endpoint, the symbol prefix decides.
PI_/FI_are USD 1 inverse contracts.PF_/FF_are linear contracts with contract size 1. For other prefixes,sum_open_interest_valueis null. - Before the 2026-09 data-integrity release, the inverse
sum_open_interest_valuewas contracts × price. On 2026-09-30, we corrected it to contracts × contract size.
For the column types and descriptions, refer to the Open Interest schema.
Liquidations
One row per trade with type liquidation or termination, from the trade feed and from trade_snapshot messages.
- WebSocket trade
- WebSocket trade_snapshot
No example yet
We received no liquidation on any Kraken Futures market while we captured the examples for this page. Thus, this section has no example at this time. The notes below describe the mapping. They come from the conversion code.
Notes
- We publish each of these trades in the trades file and also in the liquidations file, after the same deduplication.
received_timeis the time when we received the message.event_timeandtrade_timeare thetimeof the trade in milliseconds.symbolis theproduct_idof the trade. sideis Kraken's takersidein upper case (BUY,SELL).priceandaverage_priceare the fill price.quantity,last_filled_quantityandfilled_quantityare theqtyof the fill. They use the same units as tradequantity(base asset forPF_/FF_, USD 1 contracts forPI_/FI_).order_typeMarket,time_in_forceIOCandorder_statusFILLEDare fixed placeholders.- A liquidation that fills at several prices gives one row per fill.
For the column types and descriptions, refer to the Liquidations schema.