From 8611f80c1dbf183b837cdcad40a74827b4da92a1 Mon Sep 17 00:00:00 2001 From: Ted Palmer Date: Mon, 15 Jun 2026 13:30:52 -0400 Subject: [PATCH 1/3] Deprecate old fees object in favor of expandedPriceImpact --- references/api/api_core_concepts/fees.mdx | 48 +++++++++++++---------- script.js | 2 +- 2 files changed, 28 insertions(+), 22 deletions(-) diff --git a/references/api/api_core_concepts/fees.mdx b/references/api/api_core_concepts/fees.mdx index 33143b72..b4c3edaf 100644 --- a/references/api/api_core_concepts/fees.mdx +++ b/references/api/api_core_concepts/fees.mdx @@ -113,33 +113,19 @@ If you are interested in learning how app fees work, and how you can add them to _Please note that the above fee structure applies to standard cases. In certain cases, such as route-specific campaigns or promotions, different fees may apply._ -## Fees Object +## Fees in the API -The Fees object is returned from the quote API and the requests API. These fees are only the Relay related fee, and are segmented as the following fees: +Both the quote API and the requests API return an order's fees in the `expandedPriceImpact` object, which breaks the total cost into the following components: -**relayerService**: The service fee paid to the relayer to facilitate execution. - -**relayerGas**: The gas fee given to the solver to pay gas fees on the destination chain. - -**relayer**: The sum of the relayerService and the relayerGas. - -**app**: Third party fees added on top of the existing fees, this fee is added by app developers and accrues offchain to minimize gas costs. +**execution** - Execution fees covering network gas on the origin and/or destination chain plus the flat fee. -**subsidized**: The Fees in the order that are subsidized by the integrator. - -## Price Impact - -If you are interested in understanding or showing your user the fees of the order more broadly, it's best to look at the `expandedPriceImpact` object which reports: - -**execution** - the price impact that results from execution fees (gas and flat fee). This covers the cost of executing the transaction on the origin and destination chains. +**swap** - Swap costs from cross-currency and cross-chain exchange, including DEX fees, swap slippage, and solver rebalancing. -**swap** - the price impact that results from cross-currency and cross-chain token exchange. This includes DEX fees, swap slippage, and solver rebalancing costs. +**relay** - The Relay fee, the flat basis-point fee charged by Relay for routing and meta-aggregation services. -**relay** - the price impact that results from the Relay API fee. This is the flat bps fee charged by Relay for routing and meta-aggregation services. +**app** - App fees added on top by the integrator, when present. -**app** - the price impact that results from the app fees (if applicable). - -**sponsored** - the price impact that is covered by the integrator via [Fee Sponsorship](/features/fee-sponsorship). This reflects the portion of fees subsidized on behalf of the user. +**sponsored** - The portion of fees the integrator subsidizes on behalf of the user via [Fee Sponsorship](/features/fee-sponsorship). When displaying fees to users, we recommend mapping the `expandedPriceImpact` fields as follows: @@ -159,3 +145,23 @@ Deposit addresses do not support `sponsoredFeeComponents`. See the [Fee Sponsorship Doc](/features/fee-sponsorship) for setup details. + +## Deprecated: Fees Object + + +The `fees` object is deprecated. It is still returned from the quote API and the [`GET /requests/v2`](/references/api/get-requests) API for backwards compatibility, but it only reports Relay-related fees and does not reflect the full cost of an order. Do not rely on it for new integrations. + +To understand or display the complete fee breakdown of an order, use the [`expandedPriceImpact`](#fees-in-the-api) object instead, which covers execution, swap, relay, app, and sponsored fees. + + +The deprecated `fees` object is segmented into the following fields: + +**relayerService**: The service fee paid to the relayer to facilitate execution. + +**relayerGas**: The gas fee given to the solver to pay gas fees on the destination chain. + +**relayer**: The sum of the relayerService and the relayerGas. + +**app**: Third party fees added on top of the existing fees, this fee is added by app developers and accrues offchain to minimize gas costs. + +**subsidized**: The Fees in the order that are subsidized by the integrator. diff --git a/script.js b/script.js index 380f442a..644d3978 100644 --- a/script.js +++ b/script.js @@ -109,7 +109,7 @@ function enhanceGetQuotePage() { addLearnMore( "response-fees", "/references/api/api_core_concepts/fees", - "Learn more about fees", + "Learn more about fees - [DEPRECATED]", "learn-more-fees", "before", ); From 6c25cfde996a3d9dfe0b2e55d4264e79f4170d48 Mon Sep 17 00:00:00 2001 From: Ted Palmer Date: Mon, 15 Jun 2026 13:43:50 -0400 Subject: [PATCH 2/3] Updates --- references/api/api_core_concepts/fees.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/references/api/api_core_concepts/fees.mdx b/references/api/api_core_concepts/fees.mdx index b4c3edaf..c73df394 100644 --- a/references/api/api_core_concepts/fees.mdx +++ b/references/api/api_core_concepts/fees.mdx @@ -115,7 +115,7 @@ _Please note that the above fee structure applies to standard cases. In certain ## Fees in the API -Both the quote API and the requests API return an order's fees in the `expandedPriceImpact` object, which breaks the total cost into the following components: +Both the quote API and the requests API return a request's fees in the `expandedPriceImpact` object, which breaks them down into the following components: **execution** - Execution fees covering network gas on the origin and/or destination chain plus the flat fee. @@ -149,9 +149,9 @@ See the [Fee Sponsorship Doc](/features/fee-sponsorship) for setup details. ## Deprecated: Fees Object -The `fees` object is deprecated. It is still returned from the quote API and the [`GET /requests/v2`](/references/api/get-requests) API for backwards compatibility, but it only reports Relay-related fees and does not reflect the full cost of an order. Do not rely on it for new integrations. +The `fees` object is deprecated. It is still returned from the quote API and the [`GET /requests/v2`](/references/api/get-requests) API for backwards compatibility, but it only reports Relay-related fees and does not reflect the full cost of a request. Do not rely on it for new integrations. -To understand or display the complete fee breakdown of an order, use the [`expandedPriceImpact`](#fees-in-the-api) object instead, which covers execution, swap, relay, app, and sponsored fees. +To understand or display the complete fee breakdown of a request, use the [`expandedPriceImpact`](#fees-in-the-api) object instead, which covers execution, swap, relay, app, and sponsored fees. The deprecated `fees` object is segmented into the following fields: From 67f3595b6b04c812b06f253d394d9f23d9247161 Mon Sep 17 00:00:00 2001 From: Ted Palmer Date: Mon, 15 Jun 2026 16:20:58 -0400 Subject: [PATCH 3/3] Remove deposit address sponsor components tag --- references/api/api_core_concepts/fees.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/references/api/api_core_concepts/fees.mdx b/references/api/api_core_concepts/fees.mdx index c73df394..fe8d0253 100644 --- a/references/api/api_core_concepts/fees.mdx +++ b/references/api/api_core_concepts/fees.mdx @@ -140,10 +140,6 @@ Integrators with [Fee Sponsorship](/features/fee-sponsorship) enabled can subsid For more granular control, use the **`sponsoredFeeComponents`** parameter in the quote request to choose which specific fee components to sponsor. This allows you to sponsor some fees (e.g. execution and relay fees) while letting the user pay others (e.g. swap fees). - -Deposit addresses do not support `sponsoredFeeComponents`. - - See the [Fee Sponsorship Doc](/features/fee-sponsorship) for setup details. ## Deprecated: Fees Object