Skip to Content
ResourcesChangelog

Changelog

Product updates that affect XO Swap API integrations, newest first. Only integration-visible features, fixes, changes, and documentation updates are included.

July 14, 2026

New

  • Actionable quote errors. V3 trade and chained-route quote failures now return specific error codes instead of a generic no-quote response. New codes include AMOUNT_ABOVE_LIMIT, AMOUNT_BELOW_LIMIT, INSUFFICIENT_FUNDS, INVALID_ADDRESS, UNSUPPORTED_SWAP_MODE, HIGH_RISK_TOKENS, and INSUFFICIENT_LIQUIDITY.
  • Stock-token market states. Quote failures now distinguish MARKET_CLOSED, ASSET_PAUSED, and RESTRICTED_REGION where applicable.

Fixed

  • Stable completion states. Order status responses now report complete once provider completion is observed and no longer regress after reaching a completed state.

July 9, 2026

Fixed

July 2, 2026

Fixed

  • Correct order error status. V3 order creation now keeps client-caused failures as 4xx responses and returns 5xx for provider or internal failures. Error responses include a stable code and the order ID when one is available.

June 2, 2026

New

  • Sponsored rate variants. GET/v3/pairs/:pairId/rates may return campaign-sponsored rate variants alongside the base rates. Sponsored entries include sponsoredByCampaignId and cap max to the campaign’s per-swap limit.
  • Campaign attribution. Campaign-sponsored V3 quotes and orders, and V4 quotes, now expose sponsoredByCampaignId so integrations do not need to infer sponsorship from fee calculations.

May 19, 2026

Fixed

  • Fresh rate responses. GET/v3/pairs/:pairId/rates no longer returns rates that expire while providers are being queried or the response is being prepared.

May 5, 2026

New

  • Tokenized stock swaps. Supported stock tokens can now appear in GET/v3/pairs and be quoted through V3. Availability follows market hours and regional eligibility rules.

April 29, 2026

New

  • Exact-output quotes. POST/v4/quotes now supports ExactOut quotes.
  • Richer V4 errors. Quote and order errors now include more actionable details, including unresolved assets, invalid amounts, expired quotes, unsupported networks, and unavailable routes.

April 21, 2026

New

  • Revenue-share visibility. GET/v3/pairs/:pairId/quotes responses now include partnerRevenueShareAmount when revenue sharing is configured for the integration. The amount is denominated in the source asset.

March 13, 2026

New

  • Consistent error model. V3 and V4 errors were standardized around status, code, and details fields.

Fixed

  • Restricted EVM addresses. The zero address and other restricted addresses now return 403 RESTRICTED_ADDRESS.

January 20, 2026

New

  • Configurable slippage. POST/v4/quotes now accepts a slippage percentage from 0 to 100.
  • Flexible asset identifiers. GET/v4/assets can return CAIP-19 or legacy XO asset identifiers through the caip19 query parameter.

January 6, 2026

New

  • Deferred sender addresses. POST/v3/orders now accepts fromAddress: null for providers that support deferred sender-address collection.
  • V4 API beta. Launched a streamlined swap flow: discover assets through GET/v4/assets, request the best route from POST/v4/quotes, and create the swap with POST/v4/orders.
  • CAIP-19 pair identifiers. V4 quote and order responses use CAIP-19 identifiers by default, with legacy XO identifiers available through the caip19 query parameter.
  • Wallet-native signing. Order creation returns ready-to-sign transactions for EVM, Solana, Bitcoin, and TRON source networks, keeping private-key signing in the user’s wallet.
  • Restricted-address screening. Added checks to V4 quote and order creation.

December 23, 2025

Changed

  • Fantom removal. FTMMAINNET assets are no longer returned by V3 asset discovery. See Available Networks for the current network list.

December 9, 2025

New

  • Floating quotes. Launched real-time, amount-specific V3 pricing. Floating quotes can support higher maximums than the rates endpoint and return the expected output for the exact amount the user wants to swap.
  • Purpose-built execution flow. Request an amount-specific quote from GET/v3/pairs/:pairId/quotes , then create the order with POST/v3/orders/float .

Docs

  • Direct Swaps guide. Added a complete integration guide with guidance for choosing rates or quotes, end-to-end examples, transaction submission, and order tracking.

November 20, 2025

Docs

  • Task-oriented navigation. Reorganized the documentation around integration flows, endpoint references, and shared resources.
  • End-to-end examples. Added step-by-step integration guidance and complete request/response examples.
  • API playground. Launched the interactive playground , where integrations can explore the API with dummy data and fetch live rates.

June 27, 2025

Changed

  • Header-based client identification. V3 stopped accepting the legacy base64 Authorization header. Integrations should identify themselves with the headers described in Authorization, including App-Name and the optional App-Version.

May 13, 2025

New

  • Network discovery APIs. Added GET /v3/networks, GET /v3/networks/:networkId, and GET /v3/networks/:networkId/assets. The Available Networks page uses this API to show the current V3 network list.

November 13, 2024

New

  • Blockchain-derived output amounts. Added the toAmount property to GET/v3/orders/:orderId . This property indicates the destination amount based on blockchain data. It remains null until the monitoring system has analyzed the transaction.

July 6, 2023

New

  • V3 API. Launched asset and pair discovery, live rates, order creation, order status tracking, and restricted-address screening. See the V3 overview to start an integration.
Last updated on
Available Networks