Dynamic Pricing

Pricing for LI.FI’s enterprise features is agreed per integration, not a fixed rate card. LI.FI tailors the commercial model to your volume, chains, and the mix of flows you run.

Why pricing is per integration

Enterprise integrations vary widely. A stablecoin-heavy payments flow and a volatile-asset trading flow have very different economics, so a single flat rate either overcharges the thin-margin flows or underprices the rest. LI.FI sets pricing against the characteristics of your integration instead.

What shapes the rate

Volume. Higher, committed volume moves the rate.
Route type. Same-chain and cross-chain are priced differently.
Token type. Stablecoin-to-stablecoin flows can carry a lower rate than volatile-asset swaps.
Feature mix. Which enterprise features you enable, and how they are applied.

The DYNAMIC fee type

Dynamic Pricing is available to approved enterprise integrations. Enrollment is agreed with LI.FI. Integrations without Dynamic Pricing pay the standard fixed LI.FI service fee described in Fees and Monetization. Enrolling switches your integration to the DYNAMIC fee type. LI.FI then resolves its rate for each quote against your commercial model (see What shapes the rate). The fee type only changes how the LI.FI rate is determined. The resolved amount is returned as a normal fee entry on the quote and follows the same included behavior as any other fee. Your own integrator fee is unchanged and is paid in full to your configured fee wallet.

Per-request resolution

For every quote, LI.FI resolves its rate from these inputs:

The requested fromAmount.
The source and destination tokens: chain ID, address, and token tags such as stablecoin.
The chain pair, same-chain or cross-chain.
Your integrator fee, when set.

Two quotes from the same integration can carry different rates when these inputs differ. The exact weighting is part of your commercial terms and is not published. Treat the value on the returned quote as authoritative and do not reconstruct it client-side.

Fail-closed behavior

DYNAMIC never falls back to the standard fixed fee, and a failed resolution never becomes a zero-fee quote. See Error codes for the codes below.

Situation	Result
LI.FI cannot resolve the fee (outage, timeout, unknown integration)	HTTP `424`, code `1008` (`ThirdPartyError`)
The source chain is not supported	Request validation can reject the quote with HTTP `400`, code `1011`, before fee resolution. The `424` / `1008` error above applies to failures during fee resolution, not every unsupported-chain request. Ask your LI.FI contact before you add a new chain.
`fee` is set but the integration has no fee wallet on the source chain	HTTP `400`, code `1011` (`ValidationError`). Configure the wallet in the LI.FI Portal.
`intermediary` is set	HTTP `400`, code `1011`. Intermediary fees are not supported with `DYNAMIC`.

Where the resolved fee appears

Request a quote as usual with GET /v1/quote. Set your API key first:

export LIFI_API_KEY=your-api-key

This example charges a 0.5% integrator fee on 1,000 USDC from Ethereum to Polygon:

curl -X GET 'https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&toToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&fromAddress=0x1234567890123456789012345678901234567890&fromAmount=1000000000&integrator=your-integrator-id&fee=0.005' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

const params = new URLSearchParams({
  fromChain: '1',
  toChain: '137',
  fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  toToken: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174',
  fromAddress: '0x1234567890123456789012345678901234567890',
  fromAmount: '1000000000',
  integrator: 'your-integrator-id',
  fee: '0.005',
})

const response = await fetch(`https://li.quest/v1/quote?${params}`, {
  headers: { 'x-lifi-api-key': process.env.LIFI_API_KEY! },
})
const quote = await response.json()
if (!response.ok) {
  throw new Error(`Quote request failed (HTTP ${response.status}): ${JSON.stringify(quote)}`)
}

const feeEntry = quote.estimate?.feeCosts?.find((cost) =>
  cost.feeSplit?.recipients?.some((r) => r.type === 'DYNAMIC')
)
if (!feeEntry) {
  throw new Error('No DYNAMIC fee entry found. Do not interpret this as a zero fee; confirm your integration configuration with LI.FI.')
}

The resolved LI.FI fee and your integrator fee are returned together as one entry in estimate.feeCosts. There is no top-level dynamicFee field. With a resolved LI.FI rate of 0.1%, the entry for the request above looks like this:

{
  "name": "LIFI Fixed Fee",
  "description": "Fixed LIFI fee, independent of any other fee",
  "percentage": "0.0060",
  "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "symbol": "USDC", "decimals": 6 },
  "amount": "6000000",
  "amountUSD": "6.00",
  "included": true,
  "feeSplit": {
    "lifiFee": "1000000",
    "integratorFee": "5000000",
    "recipients": [
      { "name": "lifi", "fee": "1000000", "type": "DYNAMIC" },
      { "name": "your-integrator-id", "fee": "5000000", "type": "DYNAMIC" }
    ]
  }
}

Field	Meaning
`amount`, `amountUSD`	Total of the LI.FI fee and your integrator fee, in the smallest unit of `token` and in USD.
`percentage`	Total rate as a fraction of `fromAmount`, with four decimals.
`included`	`true`: already deducted from the quoted `toAmount`. `false`: charged on top of `fromAmount`. See Gas costs and fee costs.
`name`, `description`	Display labels. `DYNAMIC` quotes post `LIFI Fixed Fee`. Do not use them to detect the fee type.
`feeSplit.lifiFee`, `feeSplit.integratorFee`	LI.FI’s resolved share and your integrator fee, in the smallest unit of `token`.
`feeSplit.recipients[]`	One entry per recipient. `type` is one of `FIXED`, `SHARED`, `DYNAMIC`, `INTERMEDIARY`, `DISTRIBUTION`. New values can be added, so keep a default branch.

To detect Dynamic Pricing on a quote, look for a recipient with type: "DYNAMIC".

Transparency

Every resolved fee is returned with the quote, so the applied rate is visible to you and auditable per transaction. feeSplit shows LI.FI’s share and your integrator fee separately. Your integrator fee is paid in full to your configured fee wallet. See Monetizing the integration for how integrator fees are collected.

How to set it up

Pricing is agreed when your integration is configured, and it can be adjusted later.

Contact the LI.FI team

Tell us your volume and the flows you run. We propose a commercial model that fits.

Enterprise Features

Partner Portal

Dynamic Pricing

Why pricing is per integration

What shapes the rate

The DYNAMIC fee type

Per-request resolution

Fail-closed behavior

Where the resolved fee appears

Transparency

How to set it up

Contact the LI.FI team

​Why pricing is per integration

​What shapes the rate

​The DYNAMIC fee type

​Per-request resolution

​Fail-closed behavior

​Where the resolved fee appears

​Transparency

​How to set it up

Contact the LI.FI team

Why pricing is per integration

What shapes the rate

The DYNAMIC fee type

Per-request resolution

Fail-closed behavior

Where the resolved fee appears

Transparency

How to set it up