Release notes

​

2026

​

1 September 2026

Scheduled maintenance and unplanned incident advisories are now surfaced across all Spot API protocols, so clients can wind down activity ahead of a maintenance window and understand why the engine is in a restricted state.

• Announced upcoming maintenance status visibility
• Advisories are additive on every protocol. Clients that do not read the new fields are unaffected, and the existing system status value continues to be driven by the trading engine — an advisory explains why a state is happening or coming, it does not dictate engine state
• Scheduled advisories carry a phase derived from the time remaining: announced, reminder_24h, approaching_30m, imminent_5m, final_warning_30s
• Emergency advisories relay the status page incident state 1:1: investigating, identified, monitoring. They are cleared at resolved and carry no order guidance — derive it from incident_status, next_steps and the system status value
• Affected surfaces are named with the tokens spot_ws, spot_rest, spot_fix, spot_trading, futures_ws, futures_rest, futures_fix, futures_trading and all

WS v2

• Added upcoming_maintenance object to the status channel data[]. Present when a trading-relevant scheduled event is within 72 hours, null otherwise, and cleared once the window starts. Carries event_id, expected_start_utc, expected_end_utc, time_to_start_s, phase, affected_services, order_submission, recommended_action and cancel_before_utc
• Added emergency object to the same status channel messages. Present while a status page incident is unresolved. Carries event_id, incident_status, impact, affected_services, started_at_utc, next_steps and source_url
• next_steps entries carry applies_to, type (one of expected_restart, expected_cancel_only, expected_post_only, expected_online) and expected_at_utc, ordered by expected_at_utc ascending. The array is empty when no forecast has been published
• time_to_start_s is refreshed on a 10-second push cadence during the approach phases
• Existing system field is unchanged

WS v1

• Added upcoming_maintenance and emergency objects to the systemStatus message, matching the WS v2 status channel field for field
• Existing status field is unchanged

REST v1

• Added upcoming_maintenance and emergency arrays to the SystemStatus response. upcoming_maintenance carries scheduled events within the next 72 hours, ordered by expected_start_utc ascending; emergency carries unresolved incidents. Both are empty or absent when no advisory is active, and the existing status and timestamp fields are unchanged
• Each upcoming_maintenance entry carries event_id, title, expected_start_utc, expected_end_utc, time_to_start_s, phase, affected_services, order_submission, recommended_action, cancel_before_utc and source_url
• Each emergency entry carries event_id, title, incident_status, impact, affected_services, started_at_utc, next_steps and source_url
• Added MaintenanceSchedule endpoint, returning events — all scheduled maintenance in the next 7 days, ordered by expected_start_utc ascending. Emergency incidents are not scheduled and do not appear here
• cancel_before_utc is expected_start_utc minus 5 minutes while an event is scheduled, and absent otherwise
• time_to_start_s is evaluated when the response is served. Responses are cacheable, so derive live countdowns from expected_start_utc rather than re-reading the field

FIX v1

• Added Tag 5200 (KrakenIncludeAdvisories) to TradingSessionStatusRequest (35=g) to opt in to advisories. Defaults to N; unsubscribe with SubscriptionRequestType (263) = 2. Advisories are never auto-emitted on Logon
• Added News (35=B) advisory messages, sent once per active advisory on subscription and again on every subsequent phase transition. Documented under API Reference → Unified FIX → News
• News reuses the native FIX 4.4 fields OrigTime (42), Urgency (61) — 0 for maintenance, 1 for emergency — Headline (148), URLLink (149), ValidUntilTime (62), and the standard NoLinesOfText group form (33=1 with 58)
• Added the FIX 5.0 News fields NewsID (1472), NewsCategory (1473) — always 3 (Technical News) — NewsRefID (1476) and NewsRefType (1477). Phase transitions emit a fresh NewsID with NewsRefID pointing at the previous message and NewsRefType = 0 (Replacement), letting clients correlate updates for a single event
• Added Kraken Tags 5203 (KrakenEventPhase), 5204 (KrakenAffectedServices), 5205 (KrakenExpectedStartUTC), 5206 (KrakenExpectedEndUTC), 5207 (KrakenCancelBeforeUTC), 5208 (KrakenRecommendedAction), 5209 (KrakenOrderSubmission), 5210 (KrakenTimeToStartSec), 5211 (KrakenNextStepType), 5212 (KrakenNextStepAtUTC) and 5213 (KrakenNextStepAppliesTo)
• Broadcast is scoped per gateway: Spot gateways emit News when 5204 includes spot_fix. Cross-product events are broadcast on both Spot and Derivatives gateways with the same NewsID, so clients connected to both should deduplicate on NewsID. Tag 5204 always carries the full list
• 5210 (KrakenTimeToStartSec) is computed once per transition rather than pushed on a timer — derive a live countdown from 5205
• URLLink (149) is currently populated on emergency advisories only; scheduled maintenance advisories will carry it in a follow-up release

​

20 August 2026 — Derivatives REST v1

• Announced upcoming off-book risk preferences, available from 27 August 2026, 07:00 UTC
• Added /rfq-assignment/max-leverage endpoints (GET, PUT, DELETE) to read, set and clear an account-level maximum leverage cap applied to off-book fills — liquidation assignments and RFQ offer fills. Book (maker/taker) orders are unaffected; master accounts only
• Added minimumProfitabilityPerAssignmentLongBps and minimumProfitabilityPerAssignmentShortBps parameters to /assignmentprogram/add and to the assignment participant response, setting the minimum profitability per assignment in integer basis points. Participants with a lower minimum receive assignments first

​

19 August 2026 — Spot REST v1

• Added ListWalletAccounts endpoint to list wallet accounts associated with the authenticated user
• Added account_id query parameter to Balance and Ledgers to select a specific wallet account

​

14 July 2026 — Spot REST v1

• Added pair request parameter to TradesHistory to filter results to a single trading pair
• Added aclass request parameter to TradesHistory to set the asset class of the pair filter (defaults to forex)
• Added limit request parameter to TradesHistory to set the number of trades returned per page (1–100, defaults to 50)

​

3 July 2026 — Spot FIX v1

• Added Tag 5052 (MDPricePrecision) to the Instrument List (35=y) response. Specifies the price decimal precision used on market data feeds, which may be greater than PricePrecision (2349) for rebased xStocks pairs

​

22 June 2026 — Derivatives REST v1

• DEPRECATED the Futures Fee Schedules endpoints and related fields (feeScheduleUid, FeeSchedule, FeeScheduleVolumes, FeeTier). Fee calculation for Futures trades has been migrated to a centralised Kraken fee service — use the Spot GetTradeVolume endpoint to determine the fee rate applied to your trades

​

16 June 2026 — Spot REST v1

• TradeVolume pair parameter now also accepts a list of { asset, aclass } objects, enabling fee queries for non-forex classes (such as derivatives and equity_pair)
• Added fee_schedule request parameter to TradeVolume to return the full per-pair fee schedule in the new schedules response field

​

18 May 2026 — Derivatives REST v1

• Added unknown value to multiple enums (order direction, orderType, triggerSignal, triggerSide, trailing-stop / max-deviation unit, and HistoricalPositionUpdateElement fields positionChange, tradeType, updateReason) as a fallback when the source value cannot be decoded

​

12 May 2026 — Spot REST v1

• Added FOK (fill-or-kill) value to timeinforce parameter on AddOrder and AddOrderBatch endpoints

​

7 May 2026 — Spot REST v1

• Added broker request body parameter to AddOrder and AddOrderBatch for qualified partners in Kraken’s API Partner Program

​

30 April 2026 — Spot REST v1

• Added execution_venue query parameter to AssetPairs endpoint (filter by international or bitnomial_exchange)

​

28 April 2026 — Spot WS v2

• Added execution_venue subscription parameter to the instrument channel (one of international, bitnomial-exchange; defaults to international)

​

27 April 2026 — Spot REST v1

• Added execution_venue field to AssetPairs response (one of international, bitnomial_exchange)

​

11 March 2026 — Spot REST v1

• Added GetApiKeyInfo endpoint to retrieve API key configuration and usage

---

​

2025

​

15 December 2025 — Spot REST v1

• Added Level3 endpoint for individual order-level (L3) order book data
• Added GroupedBook endpoint for aggregated order book data over configurable tick size

​

15 December 2025 — General Docs

• Migrated blog content to guides section
• Refreshed navigation menus for improved discoverability

​

2 December 2025 — Spot WS v2

• L3 WebSocket endpoint URL changed from wss://ws-auth.kraken.com/v2 to wss://ws-l3.kraken.com/v2

​

13 November 2025 — Spot ALL

• Deprecated .F asset values returned by Balance and BalanceEx endpoints

​

18 September 2025 — Spot ALL

• Deprecated no_mpp parameter on AddOrder, EditOrder, and AddOrderBatch

​

5 September 2025 — Spot REST v1

• Added asset_class filter parameter to Ticker endpoint

​

15 August 2025 — Spot REST v1

• Added asset_class parameter to market data and trading endpoints for xStocks

​

15 August 2025 — Spot WS v2

• Added rebased parameter to executions and balances requests to specify xStocks mode

​

15 August 2025 — Spot WS v1

• Added rebased parameter to openOrders and ownTrades requests to specify xStocks mode

​

15 August 2025 — Spot FIX v1

• Added Tag 5051 to Logon requests to specify xStocks mode
• Added TS SecurityType to InstrumentListRequest

​

4 August 2025 — Derivatives REST v1

• Announced upcoming authentication breaking change effective October 1st, 2025

​

28 July 2025 — Spot REST v1

• Added documentation for CreditLines endpoint

​

24 June 2025 — Spot REST v1

• Fixed error message formatting on Account Data endpoints

​

29 May 2025 — Spot FIX v1

• Added Tag 78 and 79 for Subaccount Management for Broker accounts

​

28 May 2025 — Spot REST v1

• Moved OTC endpoints to Institutional menu section

​

28 May 2025 — Spot WS v2

• Added user field to executions and balances channels to help identify the account

​

8 May 2025 — Spot WS v1 (v1.9.6)

• Added stp_type to addOrder providing self trade prevention options

​

8 May 2025 — Spot WS v2 (v2.0.10)

• Added timestamp field to level3 channel to help clients track market data sequence

​

8 March 2025 — Derivatives FIX v1

• FIX now supports futures trading

---

​

2024

​

28 September 2024 — Spot FIX v1

• Added Tag 5050 LiquidityInd in ExecutionReport

​

27 September 2024 — Spot REST v1

• Added AmendOrder endpoint to modify order parameters
• Added OrderAmends endpoint to retrieve an audit trail of amend transactions
• Added amended flag to OpenOrders and ClosedOrders endpoints to identify amended orders

​

27 September 2024 — Spot WS v1 (v1.9.5)

• Added amendOrder endpoint to modify order parameters
• Added amended flag to openOrders channel to identify amended orders

​

27 September 2024 — Spot WS v2 (v2.0.9)

• Added amend_order endpoint to modify order parameters
• Added amended exec_type to executions channel to identify amended orders

​

27 September 2024 — Spot FIX v1

• Added order cancel-replace request message MsgType=G to modify order parameters

​

5 September 2024 — Spot REST v1

• Added cl_ord_id parameter to query endpoints: ClosedOrders, OpenOrders

​

22 August 2024 — Spot WS v2 (v2.0.8)

• Added liquidated flag to executions channel to show when an order has been liquidated
• Added subscription rate limits to the level3 market data feed

​

1 August 2024 — Spot WS v2 (v2.0.7)

• snap_trades parameter now defaults to false
• Added ext_ord_id field to openOrders and executions
• Added ext_exec_id field to ownTrades and executions
• Added margin_borrow flag to ownTrades and executions

​

27 June 2024 — Spot WS v2 (v2.0.6)

• Deprecated snapshot and snapshot_trades in executions channel

​

24 June 2024 — Spot REST v1

• Added cl_ord_id parameter to order endpoints: AddOrder, CancelOrder

​

30 May 2024 — Spot WS v2 (v2.0.5)

• Modified balances channel to always include wallet breakdown and cumulative balance
• Added asset_class to balances channel for future expansion

​

23 May 2024 — Spot FIX v1.8

• Changed ClOrdId (Tag 11) and OrigClOrdId format and validation

​

21 May 2024 — Spot REST v1

• Added country_code parameter to AssetPairs

​

16 May 2024 — Spot WS v2 (v2.0.4)

• Added cl_ord_id and sender_sub_id client order identifiers
• Clarified that GTD expire time is one month

​

16 May 2024 — Spot WS v1 (v1.9.3)

• Added cl_ord_id and sender_sub_id client order identifiers
• Added margin indicator for leveraged orders

​

14 May 2024 — Spot REST v1

• Added cl_ord_id and sender_sub_id identifiers to order queries
• Added margin indicator to leveraged orders

​

18 April 2024 — Spot FIX v1.7

• Added iceberg and trailing-stop order types to FIX

​

1 March 2024 — Spot REST v1

• Removed Staking section, deprecated and no longer supported

​

1 March 2024 — Spot WS v2 (v2.0.3)

• Added event_trigger parameter to the ticker channel

​

15 February 2024 — Spot WS v2 (v2.0.2)

• Added cash_order_qty to the executions channel

​

1 February 2024 — Spot REST v1

• Added maker and ledgers fields to TradesHistory and QueryTrades

​

10 January 2024 — Spot WS v1 (v1.9.2)

• Narrowed range of valid offsets (from current time) for the deadline parameter

​

1 January 2024 — Spot REST v1

• Removed support for POST requests to all public endpoints
• Added migration notes to Balance and Ledger endpoints

---

​

2023

​

14 December 2023 — Spot WS v2 (v2.0.1)

• Added trailing-stop and trailing-stop-limit order types
• Added trigger protection during connectivity issues with index providers

​

14 December 2023 — Spot REST v1

• Added trailing-stop and trailing-stop-limit order types

​

7 December 2023 — Spot WS v2 (v2.0.0)

• WebSocket v2 taken out of beta
• Added status and restated values to exec_type
• Added support for native amends in level3 channel
• Enabled level3 channel in all environments
• Added support for new ledger types in balances channel
• Enabled balances channel in all environments
• Deprecated cancel_reason in executions channel — use reason instead

​

1 November 2023 — Spot REST v1

• Added WithdrawMethods and WithdrawAddresses endpoints
• Added start, end, cursor, and limit parameters to WithdrawStatus

​

30 October 2023 — Spot FIX v1.0.0

• Added Tag 5041 ChecksumOrderBook parameter

​

1 October 2023 — Spot REST v1

• Added max_fee parameter to Withdraw and minimum field in response

​

1 September 2023 — Spot REST v1

• Added start, end, cursor, and limit parameters to DepositStatus

​

1 August 2023 — Spot REST v1

• Added earn / balance service documentation

​

14 July 2023 — Spot WS v2 (beta)

• Added support for iceberg order type

​

1 July 2023 — Spot REST v1

• Added private BalanceEx documentation

​

1 June 2023 — Spot FIX v1.0.0

• First version of FIX API in production beta

​

1 June 2023 — Spot REST v1

• Added amount parameter to DepositAddresses
• Added count parameter to Trades

​

1 May 2023 — Spot REST v1

• Added address parameter to Withdraw
• Added since parameter to Spread

​

3 April 2023 — Spot WS v2 (beta)

• OHLC channel: added interval field to request parameters

​

22 March 2023 — Spot WS v2 (beta)

• Edit Order request: added limit_price field, deprecated price field
• executions channel: added margin field to order details
• instrument channel: added additional support for price_precision

​

15 March 2023 — Spot WS v2 (beta)

• executions channel: added last_qty and last_price fields to trade events
• OHLC channel: added interval and interval_begin fields
• Corrected default time_in_force settings

​

2 March 2023 — Spot WS v1 (v1.9.1)

• Added contingent field on private open order feed
• Enabled fast reconnect on WebSockets following trading engine maintenance

​

1 March 2023 — Spot REST v1

• Added originators parameter to DepositStatus

​

1 February 2023 — Spot REST v1

• Added long and short position limits to AssetPairs
• Specified minimum and maximum number of txids and userrefs
• Specified maximum number of responses for DepositStatus and WithdrawStatus
• Added note to use %2b instead of + for URL encoding

​

1 January 2023 — Spot REST v1

• Removed requirement for asset in DepositStatus and WithdrawStatus
• Documented reduce_only parameter
• Added consolidate_taker to TradesHistory, ClosedOrders, and QueryOrders
• Added Subaccounts section
• Added trade_id to private TradesHistory

---

​

2022

​

1 December 2022 — Spot REST v1

• Fixed pair parameter restriction on TradeVolume
• EditOrder now allowed on margin orders

​

28 November 2022 — Spot WS v2 (beta)

• Corrected several details in the executions channel

​

22 November 2022 — Spot WS v2 (beta)

• Removed internal version from the About section
• Multiple formatting and data corrections

​

1 November 2022 — Spot REST v1

• Added tick_size and status parameters to AssetPairs
• Added status and collateral_value to Assets
• Added trade_id to public Trades

​

1 October 2022 — Spot REST v1

• Documented uv (unexecuted value) field in TradeBalance
• Added costmin trading parameter to AssetPairs
• Ticker wildcard support — pair no longer required

​

1 September 2022 — Spot REST v1

• AddOrder, EditOrder, and AddOrderBatch now support iceberg orders

​

1 July 2022 — Spot REST v1

• Added support for restricting API keys to specified IP address(es)

​

1 June 2022 — Spot REST v1

• Added custom self trade prevention options

​

1 May 2022 — Spot REST v1

• New AddOrderBatch endpoint to send multiple new orders
• New CancelOrderBatch endpoint to cancel multiple open orders

​

22 March 2022 — Spot WS v1 (v1.9.0)

• Added support for editOrder

​

1 March 2022 — Spot REST v1

• New EditOrder endpoint to edit volume and price on open orders

---

​

2021

​

1 December 2021 — Spot REST v1

• Added trigger optional parameter to AddOrder

​

31 March 2021 — Spot WS v1 (v1.8.3)

• Added deadline support to addOrder

​

25 February 2021 — Spot WS v1 (v1.8.0)

• Added timeinforce and Immediate-or-Cancel (IOC) support

​

4 February 2021 — Spot WS v1 (v1.7.1)

• Changed close code to 1008 (Policy Violation) from 1013
• Added policy rule for maximum rate of subscriptions
• Added new generic error type with optional internal error codes
• Improved public market data snapshot performance

​

30 January 2021 — Spot WS v1 (v1.7.0)

• Added userref field to openOrders and ownTrades update messages

​

13 January 2021 — Spot WS v1 (v1.6.1)

• Added Dead Man’s Switch (cancelAllOrdersAfter) REST endpoint
• Fixed intermittent public data WebSocket feed latency

---

​

2020

​

21 December 2020 — Spot WS v1 (v1.6.0)

• Introduced post_only trading mode for maintenance procedure

​

5 December 2020 — Spot WS v1 (v1.5.0)

• Added optional ratecounter argument for openOrders subscription
• Added maxratecount and current ratecount reporting
• Added cancel_only trading mode
• Relaxed slow-consumer constraint on WebSocket connections
• Maintained private WebSocket connections during maintenance
• Improved public market data snapshot/stream synchronisation

​

18 November 2020 — Spot WS v1 (v1.4.1)

• Added cancelAll REST endpoint

​

2 November 2020 — Spot WS v1 (v1.4.0)

• Added cancelAll trading request functionality
• Performance upgrade to cancelOrder request handling
• Improved messages and close codes when closing WebSocket connections
• Fixed incorrect error for addOrder with invalid pair

​

27 October 2020 — Spot WS v1 (v1.3.0)

• Added sequence numbers on private feeds (openOrders, ownTrades)

​

12 October 2020 — Spot WS v1 (v1.2.1)

• Eliminated trading rate limit penalty for filled orders
• Performance improvement for REST real-time and historical market data
• Rejected market conditional close orders
• Fixed intermittent bug affecting Ticker REST endpoint

​

31 August 2020 — Spot WS v1 (v1.2.0)

• Added cancel_reason to openOrders stream
• Added optional snapshot parameter for ownTrades feed

​

22 June 2020 — Spot WS v1 (v1.1.0)

• Added order book checksum

​

18 February 2020 — Spot WS v1 (v1.0.7)

• Added addOrder and cancelOrder endpoints

---

​

2019

​

1 October 2019 — Spot WS v1 (v1.0.6)

• Introduced openOrders and ownTrades channels

​

4 February 2019 — Spot WS v1 (v1.0.5)

• Fixed publishing of deleted price levels

​

23 January 2019 — Spot WS v1 (v1.0.4)

• Added connectionID field to systemStatus message

​

18 January 2019 — Spot WS v1 (v1.0.3)

• Added open prices on ohlc including 24-hour values
• Increased timestamp precision to microseconds
• Updated sandbox URL

---

​

2018

​

24 December 2018 — Spot WS v1 (v1.0.2)

• Changed timestamp field to string type

​

7 December 2018 — Spot WS v1 (v1.0.1)

• Released WebSocket public market data sandbox v0.0.4
• Changed timestamp precision to milliseconds

​

28 November 2018 — Spot WS v1 (v1.0.0)

• Released WebSocket public market data sandbox v0.0.3