LI.FI — Get a quote for a token transfer

Retrieve a quote for a token transfer with the LI.FI API. Supply a from chain and a to chain. Sample fields include addresses and symbols. Use it for on-chain or crypto market research. The GET request schema also lists fromChain, toChain, fromToken. Use the response in a DeFi workflow for the selected protocol, and compare the request and response with the provider example.

Selected price
$0 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
The sending chain. Can be the chain id or chain key
The receiving chain. Can be the chain id or chain key
The token that should be transferred. Can be the address or the symbol
The token that should be transferred to. Can be the address or the symbol
The sending wallet address
The amount that should be sent including all decimals (e.g. 1000000 for 1 USDC (6 decimals))
Optional parameters (23)
The receiving wallet address. If none is provided, the fromAddress will be used
Which kind of route should be preferred **FASTEST**: This sorting criterion prioritizes routes with the shortest estimated execution time. Users who value speed and want their transactions to be completed as quickly as possible should choose the fastest routes. **CHEAPEST**: This criterion focuses on minimizing the cost of the transaction, whether in token amount or USD amount (USD amount minus gas cost). Users looking for the most economical option should choose the cheapest routes.
The maximum allowed slippage for the transaction as a decimal value. 0.005 represents 0.5%.
A string containing tracking information about the integrator of the API
The percent of the integrator's fee that is taken from every transaction. 0.02 represents 2%. The maximum fee amount should be less than 100%.
A string containing tracking information about the referrer of the integrator
List of bridges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
List of exchanges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
List of bridges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
List of exchanges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
One to 100 AMM pool or Solana venue identifiers to exclude from routing. Repeat the query parameter for multiple entries. Each entry is a non-zero Uniswap V2/V3 pool address (`0x` + 40 hex), a Uniswap V4 composite `-` where `poolId` is a 32-byte hex string (`0x` + 64 hex), or a Solana venue program ID (base58), which excludes every pool of that venue. Identifiers of other chains are rejected; individual Solana pool addresses are not supported. Only some exchanges can exclude pools: EVM pool entries restrict swaps on every chain except Solana to the `fly` exchange, and Solana program IDs restrict swaps on Solana to `jupiter`, `titan` and `okx`. Swaps on a chain with no matching entries are not restricted.
List of bridges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
List of exchanges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint. Also values `all`, `none`, `default` and `[]` are acceptable and mean all tools of the current type (`all`), no tools (for `none` and `[]` cases) and default tool's settings on the current stage.
Whether swaps or other contract calls should be allowed as part of the destination transaction of a bridge transfer. Separate swap transactions on the destination chain are not affected by this flag. By default, parameter is `true`.
The amount of the token to convert to gas on the destination side.
The price impact threshold above which routes are hidden. As an example, one should specify 0.15 (15%) to hide routes with more than 15% price impact. The default is 10%.
Timing setting to wait for a certain amount of swap rates. In the format `minWaitTime-${minWaitTimeMs}-${startingExpectedResults}-${reduceEveryMs}`. Please check [docs.li.fi](https://docs.li.fi) for more details.
Timing setting to wait for a certain amount of routes to be generated before chosing the best one. In the format `minWaitTime-${minWaitTimeMs}-${startingExpectedResults}-${reduceEveryMs}`. Please check [docs.li.fi](https://docs.li.fi) for more details.
Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.
Pre-configured routing optimization preset. The preset value `stablecoin` is supported for requesting swap and/or bridging operations involving stablecoin tokens. Each preset provides optimized default settings for slippage, price impact, and tool preferences that can be overridden by custom configuration parameters set in the request.
Maximum Solana transaction version the client can sign. Defaults to 0; omission or null uses v0. Set to 1 to allow V1 where enabled for the environment. Jito requests always use v0. Size overflow may fall back to v0. Read transactionRequest.svmTransactionVersion for the version actually built. Ignored for source chains other than Solana.
Priority fee level for Solana Virtual Machine (SVM) transactions.
Scope of `slippage`. `step` (default, same as omitted): `slippage` applies to every step and `toAmountMin` combines the steps' minimums. `route`: `slippage` is the budget for the whole route, `toAmountMin` is one floor, `ceil(expected output × (1 − slippage))`, that the returned transaction enforces, and the response carries a `routeSlippage` commitment. Supported for EVM routes with at most one swap: a swap on one chain, or a bridge that delivers to the recipient with or without one swap before it. Other routes are refused with `ROUTE_SLIPPAGE_UNSUPPORTED` instead of falling back to step scope. When `slippage` is omitted, the budget is the default slippage. See [Route-wide Slippage](/guides/route-wide-slippage).

Sample response

{
  "action": {
    "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "fromAmount": "100000000",
    "fromChainId": 1,
    "fromToken": {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1,
      "coinKey": "USDC",
      "decimals": 6,
      "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
      "name": "USD Coin",
      "priceUSD": "1.0002350525",
      "symbol": "USDC",
      "tags": [],
      "verificationStatus": "verified",
      "verificationStatusBreakdown": []
    },
    "slippage": 0.010701365645379253,
    "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "toChainId": 10,
    "toToken": {
      "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "chainId": 10,
      "coinKey": "USDC",
      "decimals": 6,
      "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
      "name": "USD Coin",
      "priceUSD": "1.0008373187",
      "symbol": "USDC",
      "tags": [],
      "verificationStatus": "verified",
      "verificationStatusBreakdown": []
    }
  },
  "estimate": {
    "approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
    "executionDuration": 2,
    "feeCosts": [
      {}
    ],
    "fromAmount": "100000000",
    "fromAmountUSD": "100.0235",
    "gasCosts": [
      {}
    ],
    "toAmount": "99739729",
    "toAmountMin": "99739729",
    "toAmountUSD": "99.8232",
    "tool": "across"
  },
  "id": "1823bb48-1821-45b1-8e7c-8f97d5698844:0",
  "includedSteps": [
    {
      "action": {},
      "estimate": {},
      "id": "3d3175b2-2e23-46bb-a62e-47f41b7c3e41",
      "tool": "feeCollection",
      "toolDetails": {},
      "type": "protocol"
    }
  ],
  "integrator": "lifi-api",
  "recommendedSlippage": 0.01099856322858362,
  "stepSimulation": {
    "gasSource": "simulation",
    "status": "success"
  },
  "tool": "across",
  "toolDetails": {
    "key": "across",
    "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
    "name": "AcrossV4"
  },
  "transactionId": "0x51d045f404866b9fc560f7806db5eecc183f0ad68409d563608198466803b33c",
  "transactionRequest": {
    "chainId": 1,
    "data": "0x1794958f000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000",
    "from": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "gasLimit": "0x425d3",
    "gasPrice": "0x2d4a467",
    "to": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
    "value": "0x0"
  },
  "type": "lifi"
}

Response result

Response structure

Inferred from examples
  • actionobject
    • fromAddressstring
    • fromAmountstring
    • fromChainIdinteger
    • fromTokenobject
      • addressstring
      • chainIdinteger
      • coinKeystring
      • decimalsinteger
      • logoURIstring
      • namestring
      • priceUSDstring
      • symbolstring
      • tagsunknown[]
      • verificationStatusstring
      • verificationStatusBreakdownunknown[]
    • slippagenumber
    • toAddressstring
    • toChainIdinteger
    • toTokenobject
      • addressstring
      • chainIdinteger
      • coinKeystring
      • decimalsinteger
      • logoURIstring
      • namestring
      • priceUSDstring
      • symbolstring
      • tagsunknown[]
      • verificationStatusstring
      • verificationStatusBreakdownunknown[]
  • estimateobject
    • approvalAddressstring
    • executionDurationinteger
    • feeCostsobject[]
    • fromAmountstring
    • fromAmountUSDstring
    • gasCostsobject[]
    • toAmountstring
    • toAmountMinstring
    • toAmountUSDstring
    • toolstring
  • idstring
  • includedStepsobject[]
    • actionobject
    • estimateobject
    • idstring
    • toolstring
    • toolDetailsobject
    • typestring
  • integratorstring
  • recommendedSlippagenumber
  • stepSimulationobject
    • gasSourcestring
    • statusstring
  • toolstring
  • toolDetailsobject
    • keystring
    • logoURIstring
    • namestring
  • transactionIdstring
  • transactionRequestobject
    • chainIdinteger
    • datastring
    • fromstring
    • gasLimitstring
    • gasPricestring
    • tostring
    • valuestring
  • typestring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use LI.FI — Get a quote for a token transfer with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.