How it works
When using LI.FI Widget or calling our SDK/API to request quotes for a transaction, you can pass a fee parameter specifying the percentage fee you’d be taking from the requested transaction.Multi-recipient fees
Eligible EVM/Tron flows (FeeForwarder) and Solana (per-receiver transfer instructions, max 2 entries) support multi-recipient fee forwarding: keep the integratorfee for your configured fee wallet and add recipient-specific percentages of fromAmount with distributionFees[]. On Solana swap-and-bridge routes, the percentages apply to the swap output in the intermediate token instead of fromAmount. These entries are additional fees, not shares of fee. See Multi-party fee distribution for the exact request shape, encoding, validation limits, and availability constraints.
EVM
On EVM chains where FeeForwarder is deployed and enabled, fees are forwarded directly to your configured fee wallet at transaction execution time. If that deployment is unavailable or legacy collection is enabled, LI.FI falls back to FeeCollector and those fees must be withdrawn later. See FeeForwarder for full details on how this works, including how to withdraw any legacy fees that were collected before this upgrade.Only the designated fee-collection wallet receives forwarded fees. If the fee-collection wallet is updated, only fees from transactions after the update will be sent to the new wallet.
Sui
The fees are sent to the fee wallet directly and do not need to be claimed.Solana
The fees are sent to the fee wallet directly and do not need to be claimed.Bitcoin
The fees are sent to the fee wallet directly and do not need to be claimed.When collecting fees on Bitcoin, the transaction data must remain unaltered.
This data contains critical transfer and user refund instructions that are
specific to each bridge integration. Modifying the transaction data may lead
to irreversible loss of funds.
Stellar
The fees are sent to the fee wallet directly and do not need to be claimed.Configure a Stellar fee-collection wallet in the Partner
Portal before charging integrator fees on Stellar.
The wallet must be a
G... account or C... contract address; muxed M...
addresses are not accepted as fee destinations.A G... account must have a trustline for each non-XLM asset it receives as
a fee. Without the required trustline, transaction generation fails for the
whole route (not only the fee transfer) until the trustline is added.Stellar routes using Near Intents (tool key: near) cannot carry an
integrator fee: the quote is returned without a fee step rather than
rejected, so a fee passed on such a route is silently not collected. Other
Stellar routes collect fees on-chain at execution time.Stellar applies fees in whole basis points (1 bp = 0.01%) and rounds down.
A fee rate below 1 bp therefore collects no fee on Stellar.How to set-up fee wallets
To set up your account and to start collecting fees, please set up your integration on https://portal.li.fi/. Fees are collected on every chain and for every token individually. Direct delivery depends on the fee contract active on the source chain; FeeCollector balances remain withdrawable rather than arriving immediately. You can view your fee activity and balances in the Partner Portal.How to set up fee collection
Thefee parameter is a fraction of the transaction’s fromAmount, except on Solana swap-and-bridge routes, where fees are collected from the swap output in the intermediate token. It expects a decimal number; for example, 0.02 means 2% of the transaction volume. The fee must be less than 100%. Also pass your custom integrator string to ensure the fees are collected for the correct account. LI.FI may receive a share of the collected fees depending on the use case and volume.
See examples of how to set up fee collection for different environments:
LI.FI Widget monetization guide
Detailed examples of how to configure fees in the LI.FI Widget, including
simple and advanced configurations.
LI.FI SDK monetization guide
Learn about how to configure fees and monetize your LI.FI SDK integration.
Dynamic Pricing
Enterprise integrations can move from the standard fixed LI.FI fee to a
DYNAMIC rate resolved per request. Your integrator fee is unchanged, and
feeSplit on the quote shows both shares.
