diff --git a/features/fee-sponsorship.mdx b/features/fee-sponsorship.mdx index f0be3ed..5f6f3f4 100644 --- a/features/fee-sponsorship.mdx +++ b/features/fee-sponsorship.mdx @@ -236,7 +236,7 @@ When you sponsor transactions, the quote response includes a `fees` object with } ``` -For more details on the fee structure, see [Relay Fees](/references/api/api_core_concepts/fees). +For more details on the fee structure, see [Cost & Fee Structure](/references/api/api_core_concepts/fees). --- @@ -257,5 +257,5 @@ For more details on the fee structure, see [Relay Fees](/references/api/api_core - [App Fees](/features/app-fees) — Learn how to collect fees from your users - [Get App Fee Balances](/references/api/get-app-fee-balances) — API reference for checking balances - [Get Quote](/references/api/get-quote-v2) — API reference for quote requests -- [Relay Fees](/references/api/api_core_concepts/fees) — Understanding Relay's fee structure +- [Cost & Fee Structure](/references/api/api_core_concepts/fees) — Understanding Relay's fee structure - [Solana Support](/references/api/api_guides/solana) — Guide to depositing and withdrawing on Solana diff --git a/features/price-stabilization.mdx b/features/price-stabilization.mdx index 04a59f4..3d7e37e 100644 --- a/features/price-stabilization.mdx +++ b/features/price-stabilization.mdx @@ -1300,4 +1300,4 @@ curl --request POST \ Stablecoin pairs are uniquely suited to price stabilization because the swap impact component of Relay's fees is typically sub 1bps between major stablecoins. That leaves the flat execution fee (\~\$0.02) and the Relay bps fee as the dominant costs — both small, predictable amounts that are cheap to sponsor or absorb into a fixed rate. -For a full breakdown of Relay's fee components and pricing tiers, see [Relay Fees](/references/api/api_core_concepts/fees). +For a full breakdown of Relay's fee components and pricing tiers, see [Cost & Fee Structure](/references/api/api_core_concepts/fees). diff --git a/references/api/api_core_concepts/fees.mdx b/references/api/api_core_concepts/fees.mdx index f238963..aefe040 100644 --- a/references/api/api_core_concepts/fees.mdx +++ b/references/api/api_core_concepts/fees.mdx @@ -1,20 +1,20 @@ --- -title: "Fee Structure" -description: "Learn about Relay's fee structure" +title: "Cost & Fee Structure" +description: "Learn about Relay's cost and fee structure" --- -In any given token swap or bridge powered by Relay, there are four potential fees: +In any given token swap or bridge powered by Relay, there are four potential fee and cost components: -1. **Execution Fees** +1. **Execution Cost (formerly Execution Fees)** Covers execution costs including network gas on the origin and/or destination chain, and includes: - $0.02 flat fee — always included - Destination (fill) gas estimate — always included, covers transaction fulfillment on the destination chain - Origin gas estimate — only included for gasless transactions, covers transaction submission on the origin chain on the user's behalf - For regular (non-gasless) transactions, the user pays origin gas directly from their own wallet to the network — it's not part of the Execution fee. + For regular (non-gasless) transactions, the user pays origin gas directly from their own wallet to the network — it's not part of the Execution Cost. -2. **Swap Fees** +2. **Swap Cost (formerly Swap Fees)** Covers payments to liquidity providers that facilitate cross-asset and cross-chain token swaps, and includes: - DEX fees @@ -23,7 +23,7 @@ In any given token swap or bridge powered by Relay, there are four potential fee Note: Hyperliquid charges a $1 activation fee for new deposits. Relay cannot change this fee — it is passed through to users. -3. **Relay Fees** +3. **Platform Fees (formerly Relay Fees)** A flat basis point fee charged for using the Relay API gateway and related services, including via the Relay.link frontend. @@ -39,7 +39,7 @@ In any given token swap or bridge powered by Relay, there are four potential fee - Relay Fee charged to end users + Platform Fees charged to end users 0.00% 0.01% 0.06% @@ -48,7 +48,7 @@ In any given token swap or bridge powered by Relay, there are four potential fee - Relay integrators can receive a revenue share on the Relay Fee. The revenue share varies by asset pair type and volume tier, as detailed below. To qualify, integrators must: + Relay integrators can receive a revenue share on the Platform Fees. The revenue share varies by asset pair type and volume tier, as detailed below. To qualify, integrators must: 1. Pass an API key in the Relay quote 2. Complete Know Your Business (KYB) verification @@ -117,11 +117,11 @@ _Please note that the above fee structure applies to standard cases. In certain [`GET /requests/v3`](/references/api/get-requests) returns a request's fees in the `data.fees` object, with `quoted` (estimated at quote time) and `actual` (computed at fill time) values. It breaks fees down into the following components: -**execution** - Execution fees covering network gas on the origin and/or destination chain plus the flat fee. +**execution** - Execution costs covering network gas on the origin and/or destination chain plus the flat fee. **swap** - Swap costs from cross-currency and cross-chain exchange, including DEX fees, swap slippage, and solver rebalancing. -**platform** - The platform fee, the flat basis-point fee charged by Relay for routing and meta-aggregation services. +**platform** - The Platform Fees, a flat basis-point fee charged by Relay for routing and meta-aggregation services. **app** - App fees added on top by the integrator, when present. @@ -129,9 +129,10 @@ _Please note that the above fee structure applies to standard cases. In certain When displaying fees to users, we recommend mapping the `data.fees` fields as follows: -- **platform** → Provider Fee -- **app** → Your App's Fee -- **swap** + **execution** → Swap Impact +- **execution** → Execution Cost +- **swap** → Swap Cost +- **platform** → Platform Fees +- **app** → App Fee @@ -142,7 +143,7 @@ In the quote API and [`GET /requests/v2`](/references/api/get-requests-v2), this Integrators with [Fee Sponsorship](/features/fee-sponsorship) enabled can subsidize fees for their users. By default, setting **`subsidizeFees`** to `true` sponsors all fee components. -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). +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 components (e.g. `execution` and `platform`) while letting the user pay others (e.g. `swap`). Deposit addresses do not support `sponsoredFeeComponents`. diff --git a/references/api/api_guides/bridging-integration-guide.mdx b/references/api/api_guides/bridging-integration-guide.mdx index 441577c..21f4dee 100644 --- a/references/api/api_guides/bridging-integration-guide.mdx +++ b/references/api/api_guides/bridging-integration-guide.mdx @@ -169,4 +169,4 @@ While not mandatory for integration, doing the following will improve the UX for - [**Deposit Addresses**](/features/deposit-addresses): Use Relay deposit addresses to unlock new chains and reduce wallet friction. - [**Fee Sponsorship**](/features/fee-sponsorship): Sponsor fees for your users to reduce friction and improve the user experience. - [**Handling Errors**](/references/api/api_core_concepts/handling-errors): Handle quote errors when using the Relay API. -- [**Relay Fees**](/references/api/api_core_concepts/fees): Understand the fees associated with using the Relay API. \ No newline at end of file +- [**Cost & Fee Structure**](/references/api/api_core_concepts/fees): Understand the fees associated with using the Relay API. \ No newline at end of file diff --git a/references/api/api_guides/calling-integration-guide.mdx b/references/api/api_guides/calling-integration-guide.mdx index ddff972..cfa2d39 100644 --- a/references/api/api_guides/calling-integration-guide.mdx +++ b/references/api/api_guides/calling-integration-guide.mdx @@ -1030,4 +1030,4 @@ const txs = [ - [**App Fees**](/features/app-fees): Monetize your integration by adding a fee (in bps) to every quote. - [**Fee Sponsorship**](/features/fee-sponsorship): Sponsor fees for your users to reduce friction and improve the user experience. - [**Handling Errors**](/references/api/api_core_concepts/handling-errors): Handle quote errors when using the Relay API. -- [**Relay Fees**](/references/api/api_core_concepts/fees): Understand the fees associated with using the Relay API. \ No newline at end of file +- [**Cost & Fee Structure**](/references/api/api_core_concepts/fees): Understand the fees associated with using the Relay API. \ No newline at end of file diff --git a/solutions/payment-service-providers.mdx b/solutions/payment-service-providers.mdx index 1b1e3b7..69d8d2c 100644 --- a/solutions/payment-service-providers.mdx +++ b/solutions/payment-service-providers.mdx @@ -43,7 +43,7 @@ Relay screens every transaction in real time against multiple independent blockc ## Pricing -Relay's cost is transparent in every quote. The `expandedPriceImpact` object breaks each payment into its execution, swap, and Relay fee components, plus any app fee you add — so your finance team can model unit economics exactly. Integrators above a volume threshold qualify for a revenue share on the Relay fee. See [Fee Structure](/references/api/api_core_concepts/fees). +Relay's cost is transparent in every quote. The `expandedPriceImpact` object breaks each payment into its execution, swap, and Relay fee components, plus any app fee you add — so your finance team can model unit economics exactly. Integrators above a volume threshold qualify for a revenue share on the Relay fee. See [Cost & Fee Structure](/references/api/api_core_concepts/fees). ## Security