# Changelog Changes to the Broker as a Service API, MCP server, partner dashboard and this documentation site that integrators and partners can notice, grouped by month, newest first. Questions about a change: [Contact Us](https://docs.chainflip-broker.io/resources/contact/). ## 2026-10 - Changed: the partner dashboard's Swaps page has a new **Waiting** status filter (`status=waiting`, also in the CSV and JSON export) for deposit channels where no deposit has been seen yet. **In Progress** now shows only swaps whose deposit has been seen, from Receiving through Sent. The Active swaps card still counts both. - Added: live price protection. `/swap`, the [vault swap payloads](https://docs.chainflip-broker.io/features/tx-payload/) and the MCP tools `start_swap` and `start_dca_swap` take an optional `livePriceSlippageTolerancePercent`: how far, in percent (0 to 100, at most 2 decimals), the execution price may fall below Chainflip's oracle price before a chunk is retried and, after the retry window, refunded. Bitcoin payloads take at most `2.54`. A pair without an oracle price (FLIP, for example) answers 400 with code `live_price_protection_unavailable`. Leaving the parameter out keeps Chainflip's default protection. See [Live Price Protection](https://docs.chainflip-broker.io/features/start-swap/#live-price-protection). - Added: quotes (`/quotes`, `/quotes-native`, the deprecated `/quote` and `/quote-native`, MCP `get_quotes` and `get_native_quotes`) carry `recommendedRetryDurationInBlocks` (`300` with BTC on either side, `50` otherwise) and `recommendedLivePriceSlippageTolerancePercent` (absent when Chainflip has no recommendation for the pair). Boost quotes also carry their own `recommendedSlippageTolerancePercent` and `maxBoostFeeBps`. Existing fields are unchanged. - Added: the swap status responses (`/status-by-id`, `/status-by-deposit-channel`, `/status-by-transaction-hash`, `/swaps`, `/feed`, MCP `check_status`) carry the remaining fields of Chainflip's swap status: `estimatedDurationsSeconds`, `swap.livePriceExecutionDeltaPercentage`, `fillOrKillParams.maximumOraclePriceSlippage`, the retry and abort details of a chunk (`latestSwapRescheduledAt…`, `abortedAt…`), and on egresses the fallback `destinationAddress` and an aborted EVM broadcast's `transactionPayload`. Older swaps show them too; existing fields are unchanged. - Added: `/status-by-transaction-hash` accepts the 0x extrinsic hash of a Polkadot Assethub deposit, as wallets show it and in any letter case, next to Chainflip's `-` reference. The hash is found shortly after the deposit is witnessed; until then the lookup answers `swap_unknown`. - Added: every operation in the OpenAPI document has a stable `operationId` (`getQuotes`, `startSwap`, `getStatusById`, `listSwaps`, …) and a description, and the API reference's links follow them (`#tag/Quote/operation/getQuotes`). The document also declares the `apiKey` query parameter as its security scheme; the parameter itself is unchanged. - Added: `/onboarding`, a JSON summary for agents of what works without a key, how to get one, the testing environment, a first call and the pricing, each with a URL to check it. It is in the OpenAPI document as `getOnboarding`. - Added: an MCP Server Card at `/mcp/server-card` and an AI Catalog at `/.well-known/ai-catalog.json`, so agent clients and directories can discover the MCP server before connecting. - Added: a "When to use this" section and an Onboarding section in both `llms.txt` files (chainflip-broker.io and docs.chainflip-broker.io). - Added: Markdown versions of the landing page and of every page of this site: send `Accept: text/markdown` to the page URL, or fetch `index.md` beside a docs page. - Changed: this site now allows crawlers and has a `sitemap.xml` and an `llms.txt`. - Added: the [Contact Us](https://docs.chainflip-broker.io/resources/contact/) page covers email, Discord, X, private security reports and what to include in a support request, and a new [Privacy](https://docs.chainflip-broker.io/resources/privacy/) page describes what the service stores and why. ## 2026-09 - Added: the API, the MCP server, the landing page, registration and sign-in, the partner dashboard and this documentation site are reachable over Tor v3 onion services, on production and on the testing environment. See [Tor (.onion)](https://docs.chainflip-broker.io/environments/tor/). - Added: failed requests to the quote, swap and vault swap payload endpoints carry a stable, machine-readable `code` next to `detail`, so clients can branch on it instead of matching text. See [Error Codes](https://docs.chainflip-broker.io/features/error-codes/). - Changed: the HTTP status of those failures follows the code: amount, fee and liquidity rejections answer 400, and temporary conditions such as maintenance, a disabled asset or Chainflip's channel cap answer 503, where several answered 500 before. ## 2026-07 - Added: an Overview page in the partner dashboard, self-serve payout settings, and dashboard layouts for phones and tablets. - Changed: restyled registration, sign-in and onboarding pages, and a welcome email after registration. - Added: the fill-or-kill refund address on the dashboard's Swap Detail page. - Changed: the status endpoints serve swaps recorded in both Chainflip's earlier and current status formats. - Changed: the MCP server's registry listings carry richer metadata, and broken links in `llms.txt` are fixed. ## 2026-06 - Added: route configuration. The dashboard's Routes page sets which asset pairs your API key can quote and swap. - Added: a `platform` field on swap status responses, `/swaps` and `/feed`, naming the provider that handled the swap (today always `chainflip`), and a `platform` filter on `/swaps`. - Added: Swaps and Swap Detail pages in the partner dashboard, with block explorer links. - Added: a Commissions page in the partner dashboard with USD balances and redeeming the whole balance at once. - Added: an email when a commission payout is made. - Added: team roles: change a team member's role from the dashboard's Team page. - Added: the dashboard's Audit Log of sign-ins and account changes. - Added: the Settings menu with email notification preferences. - Added: a guided onboarding flow for new partners. - Fixed: the vault swap payload and `/rpc` endpoints accepted malformed parameters, assets on the wrong chain and invalid amounts; they are now rejected. - Fixed: Polkadot relay-chain DOT missing from `/assets`; it is listed again, as a disabled legacy asset. ## 2026-05 - Added: Tron, with TRX and USDT, including vault swap payloads (`/tx-payload/tron`). - Added: password reset and account recovery for dashboard users. - Added: team member invitations and management in the partner dashboard. - Fixed: a quote for an amount below the egress fee returned Chainflip's raw error instead of an explanation. ## 2026-04 - Added: partner dashboard accounts. Sign in with your email address and password. ## 2026-03 - Added: the MCP server at `https://chainflip-broker.io/mcp`, with tools to list assets, get quotes and start swaps, a swap-assistant prompt, tool annotations, server instructions and resources. It is listed in several MCP and AI registries. See [AI Documentation](https://docs.chainflip-broker.io/resources/ai-documentation/). - Added: `llms.txt` and a page documenting the platform for AI agents. - Added: WBTC on Ethereum, and USDT on Solana and Arbitrum. - Added: a new partner dashboard layout. ## 2025-12 - Changed: DCA swaps may use a single chunk (`numberOfChunks` of `1`). - Fixed: deposit channel lookups failing when the address's letter case differed. ## 2025-11 - Removed: swaps on the Polkadot relay chain. Existing Polkadot swaps still show in status lookups and swap history. - Fixed: boost quotes failing when Chainflip returned no estimated durations. ## 2025-08 - Added: Talisman on the landing page. ## 2025-07 - Added: automatic payouts of earned commission once it reaches a minimum amount. - Added: `/rpc` passes through more Chainflip methods, including `cf_encode_cf_parameters`. ## 2025-06 - Changed: a redesigned, multi-step registration form that works on phones. - Added: the refund fee in swap fee breakdowns. - Changed: `depositChannel` is optional in status responses, so vault swaps, which have none, are reported correctly. ## 2025-05 - Added: Polkadot Assethub. - Added: `/rpc` passes through the vault swap methods and `cf_environment`. - Added: more detailed errors when liquidity is too low for a quote. - Added: LeoDEX and Gem Wallet on the landing page. ## 2025-03 - Added: vault swaps, including Bitcoin and Solana: instead of a deposit address, the API returns a transaction for the user's wallet to sign. Fill-or-kill parameters are required. See [Vault Swap Transaction Payloads](https://docs.chainflip-broker.io/features/tx-payload/). - Added: Dexifier on the landing page. ## 2025-02 - Added: Cake Wallet on the landing page. - Added: the estimated price on boost quotes. - Fixed: `/feed` ignoring its `offset` parameter. - Fixed: an unhelpful error when liquidity was too low for a quote. ## 2025-01 - Added: extra affiliates per swap, each with its own commission. - Fixed: commissions above 95 bps being rejected. - Fixed: the in-browser funding step of registration. ## 2024-12 - Added: [`/feed`](https://docs.chainflip-broker.io/features/view-feed/), a feed of every completed swap through your broker, oldest first. - Added: a redesigned landing page with a mobile menu. - Added: validation errors name the minimum amount, and `retryDurationInBlocks` is validated. ## 2024-11 - Added: quotes include the estimated price and a recommended slippage tolerance. - Added: batch requests (JSON arrays) on the public RPC endpoint. - Added: minimum swap amounts follow Chainflip's on-chain minimums. ## 2024-10 - Changed: swap status uses Chainflip's status v2, with more detail. - Added: swap status lookup by transaction hash (`/status-by-transaction-hash`). - Added: [`/swaps`](https://docs.chainflip-broker.io/features/view-swaps/), the list of all your swaps. - Added: `commissionBps` on the legacy quote endpoints, and higher commission limits on the RPC endpoint. - Changed: a higher minimum swap amount for Solana. ## 2024-09 - Added: Solana. - Added: DCA swaps and quotes, including with boost. See [DCA](https://docs.chainflip-broker.io/features/start-swap/#dca). - Added: `commissionBps` to override your commission per swap. - Added: network and asset logos in API responses. - Added: hackathon guides for five chains. ## 2024-08 - Added: fill-or-kill swaps with a minimum price and a refund address. - Added: contract addresses of EVM tokens in `/assets`. - Added: Bitcoin testnet addresses on the testing environment. - Added: request examples in the API reference. ## 2024-07 - Added: `/networks`, listing the supported networks and their assets. - Added: cross-chain message (CCM) swaps. - Added: quotes include pool information and the deposit channel's expiry block. - Added: clearer errors for more of Chainflip's error responses. ## 2024-06 - Added: Arbitrum, with the `arbeth` and `arbusdc` shorthands. - Added: boost quotes. - Added: registration shows its steps and the progress of each. - Added: Babylon on the [Integrations](https://docs.chainflip-broker.io/resources/integrations/) page. - Fixed: quotes failing on the decimal estimated durations Chainflip 1.4 introduced. - Fixed: registration accepting commissions above the 10% maximum. ## 2024-05 - Added: self-service partner registration on chainflip-broker.io: sign up, fund FLIP from your browser wallet (RainbowKit, WalletConnect) and register the broker role, step by step. - Added: the testing environment on Chainflip's Perseverance testnet. See [Testing](https://docs.chainflip-broker.io/environments/testing/). - Added: `/assets`, listing every supported asset. - Added: amounts in native units across the API, and `/quote-native`. - Added: flexible asset notation on the quote and swap endpoints. - Added: low-liquidity warnings and estimated completion times on quotes. - Added: `boostFee` on swaps. ## 2024-04 - Added: USDT on Ethereum. ## 2024-03 - Added: swap status endpoints, and swap ids in swap responses. - Added: an RPC endpoint compatible with a native Chainflip broker. See [RPC Drop-In](https://docs.chainflip-broker.io/features/rpc/). - Added: this documentation site, with a getting started guide, a page per endpoint, pricing, use cases, integrations and contact. - Added: a branded landing page. - Added: clearer quote errors. - Removed: per-asset maximum swap amounts. ## 2024-02 - Added: first release at chainflip-broker.io: quotes, swaps through deposit channels and swap tracking, with a dedicated Chainflip broker account per partner. - Added: an endpoint to withdraw earned broker fees. - Added: the API reference.