> For the complete documentation index, see [llms.txt](https://txnlab.gitbook.io/haystack-dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://txnlab.gitbook.io/haystack-dev/haystack-router/changelog.md).

# Changelog

### 11/05/2026

* Every swap now executes through the [V4 Order Router App](/haystack-dev/haystack-router/architecture/order-router-app-v4.md), for every API key. The API no longer builds groups for V3: a quote made for V3 gets `400 Quote is no longer executable, fetch a new quote` from `fetchExecuteSwapTxns`. Integrations need [SDK](/haystack-dev/haystack-router/sdk.md) 3.2.0 or later.
* `fetchQuote` refuses a swap of an asset for itself with `400 same-asset swaps are not supported`, for every API key.
* Added routing through Pact V2 concentrated liquidity pools, on V4 only. The V4 Order Router App was updated in place to V4.3 to support them (protocol ID 13). Quotes run each pool's own swap math over its positions, so they match what the pool pays to the base unit. Pass `Pact` in `disabledProtocols` to exclude them with Pact's other pools. In quote responses their hops have class `PactV2ClammSwapper`, and their key in `flattenedRoute` and `protocolFees` is `pact-v2-clamm`.

### 11/03/2026

* New public free-tier key: [`hay_pk_4zhj33wahuxfplteyif5xpcgnm`](/haystack-dev/haystack-router/api-order-router.md#api-keys-and-rate-limits), with the same 60 requests per minute per IP. The previous free-tier key, `1b72df7e-1131-4449-8ce1-29b79dd3f51e`, is deprecated: its limit falls to 10 requests per minute between December 1, 2026 and March 1, 2027, and it stops working on April 1, 2027.
* On V4, swaps of [First Stage taxed tokens](/haystack-dev/haystack-router/special-tokens.md#first-stage-taxed-tokens) (MOOJ and others) from or into a frozen holding include First Stage's own calls, so any client can trade them without a First Stage middleware. `fetchQuote` takes the swapper's `address` to check the holding, quotes net of the tax, and reports it in `firstStage`. SDK 3.4.0 and later send `address`. Sells from a frozen holding are `fixed-input` only, and a `fixed-output` buy of a token with a buy tax needs a pool between the pair.

### 11/01/2026

* The API key can be sent in the [`X-API-Key` header](/haystack-dev/haystack-router/api-order-router.md#api-keys-and-rate-limits), which is now the recommended way: a key in the URL ends up in logs and browser history. The `apiKey` query parameter and body field keep working. SDK 3.3.0 and later use the header.
* `fetchQuote` rejects an unknown `chain` with `400 Invalid chain`.

### 10/31/2026

* Every API key can now quote and swap [pre-bonding HayLaunch tokens](/haystack-dev/haystack-router/special-tokens.md#pre-bonding-haylaunch-tokens), and `fetchAssets` lists them for everyone, each with a `launch` mark. Buying one credits a balance in the HayLaunch app rather than an ASA in the wallet, so integrators that don't display those balances should leave these tokens out.
* On V4, trades with enough price impact can split across up to 12 intermediate assets instead of 6. On our multi-hop trade ladder, 146 of 247 trades quoted better, by up to 9.5%, and none quoted worse. Those trades take longer to quote; others are unchanged.
* On V4, `maxDepth=5` now quotes the same as the default `4`. Beside the wider splits, 5-hop routes improved 3 of 474 test trades, by under 0.001%, for twice the quote time. See [`maxDepth`](/haystack-dev/haystack-router/api-order-router.md).

### 10/30/2026

* On V4, `maxDepth=5` plans split routes of up to 5 hops through the pools depth 4 uses, beside depth 4's own plans, and keeps whichever delivers more net of network fees. It never quotes less than the default depth of 4: on our multi-hop trade ladder, 16 of 247 trades quoted better, by up to 0.78%, and none quoted worse. See [`maxDepth`](/haystack-dev/haystack-router/api-order-router.md).

### 10/29/2026

* Released the [V4 Order Router App](/haystack-dev/haystack-router/architecture/order-router-app-v4.md) (app [3757715482](https://lora.algokit.io/mainnet/application/3757715482)) beside V3. Each swap is one `route` call, which leaves more of the 16-transaction group for routes and for integrators' own transactions. A fixed-output swap delivers exactly the target and returns the surplus in the input asset. V4 rolls out across API keys over time, first to select keys, then to all; keys not yet on V4 keep using V3.
* SDK 3.2.0 supports V4 transaction groups. Upgrade before your API key moves to V4.

### 10/27/2026

* Added routing through Humble pools again. Humble was turned off in July 2025 because swaps through it sent the pool the wrong swap direction and failed; that is fixed. Pass `Humble` in `disabledProtocols` to exclude it.

### 10/02/2026

* Fixed-output slippage now protects the swap. The extra input sent for slippage is swapped through the pool the route swaps its surplus back on, so a fixed-output swap still delivers if prices move against it by up to about half the slippage. When prices hold, this costs about two pool fees on the extra input.
* Fixed-output swaps for small amounts of high-value assets no longer quote far more input than they use. Where swapping the surplus back would cost more than it returns, the route overshoots the target by a few base units instead, which the Order Router app keeps as fee.
* Fixed the network fee for tALGO mint and unmint, which made fixed-output swaps involving tALGO fail.

### 10/01/2026

* Swaps on different asset pairs now share `User_swap` calls. This frees room in the 16-transaction group, so multi-hop routes can use more pools.
* Fixed-output quotes are now checked against a replay of their execution before they are returned, so they deliver the exact target at 0% slippage.

### 09/30/2026

* Routes can now share pools, for example splitting out of or into a hub asset such as ALGO, when that beats the standard route after the extra network fees.
* Fixed fixed-output swaps on pairs with no direct pool between the output and input asset, which failed at execution.

### 09/28/2026

* Added routing through Pact V2 pools (50/50 and 80/20 weighted pools). The Order Router app was updated in place to V2.5 to support them.
* Quotes now reserve transaction group slots for the opt-in transactions that `fetchExecuteSwapTxns` prepends, so routes no longer overflow the 16-transaction group limit.

### 01/19/2026

* Removed Humble and Tinyman V1 from routing.

### 08/15/2025

* Exposed xALGO native mint/burn as virtual pool for swapping at 0 internal fee w/ effectively unlimited liquidity.

### 07/06/2025

* Exposed tALGO native mint/burn as virtual pool for swapping at 0 internal fee w/ effectively unlimited liquidity.

***
