LIlifi

Get a quote for a token transfer

This endpoint can be used to request a quote for a transfer of one token to another, cross chain or not. The endpoint returns a Step object which contains information about the estimated result as well as a transactionRequest which can directly be sent to your wallet. The estimated result can be found inside the estimate, containing the estimated toAmount of the requested Token and the toAmountMin, which is the guaranteed minimum value that the transfer will yield including slippage. If you want to learn more about how to use this endpoint please have a look at our guide.

get/v1/quote

Request

Query parameters

fromChainstring required

The sending chain. Can be the chain id or chain key

toChainstring required

The receiving chain. Can be the chain id or chain key

fromTokenstring required

The token that should be transferred. Can be the address or the symbol

toTokenstring required

The token that should be transferred to. Can be the address or the symbol

fromAddressstring required

The sending wallet address

toAddressstring

The receiving wallet address. If none is provided, the fromAddress will be used

fromAmountstring required

The amount that should be sent including all decimals (e.g. 1000000 for 1 USDC (6 decimals))

order'FASTEST' | 'CHEAPEST'

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.

slippagenumber

The maximum allowed slippage for the transaction as a decimal value. 0.005 represents 0.5%.

slippageScope'step' | 'route'

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.

integratorstring

A string containing tracking information about the integrator of the API

feenumber

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%.

percentagenumber double required

Fraction of the source token's fromAmount to transfer to the receiver (on Solana swap-and-bridge routes, use the swap output in the intermediate token instead). Must be greater than 0 and strictly less than 0.5 per entry; the total of all distributionFees percentages plus the integrator fee must remain strictly less than 1.

receiverstring required

Recipient address in the form of the source chain: 20-byte 0x-prefixed hex on EVM/Tron (all-lowercase or a valid EIP-55 checksum), base58 public key on Solana. A receiver whose form does not match the source chain is rejected.

Optional array of partner-specified fee distributions. Each entry transfers its percentage of the source fromAmount to the receiver address in parallel with the integrator fee and any intermediary carve-out. On GET quote endpoints, encode entries with indexed query keys (distributionFees[0][receiver], distributionFees[0][percentage]); a JSON string in a single query parameter is rejected with a validation error. OpenAPI 3.0 does not define serialization for nested arrays of objects, so generated clients and API consoles must construct these indexed keys explicitly instead of using the default query serialization. On EVM and Tron this requires FeeForwarder on the source chain (legacy FeeCollector chains are rejected); on Solana each receiver is paid with its own transfer instruction and at most 2 entries are accepted. The receiver form must match the source chain: 0x-prefixed hex on EVM/Tron, base58 on Solana. Limits: 1..10 entries, each percentage in (0, 0.5); total of all distribution percentages plus the integrator fee must be strictly less than 1. Receivers are sanctions-screened at transaction-build time. On Solana swap-and-bridge routes the percentages apply to the swap output in the intermediate token.

referrerstring

A string containing tracking information about the referrer of the integrator

allowBridgesQuoteBridgesEnum[]

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.

allowExchangesQuoteExchangesEnum[]

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.

denyBridgesQuoteBridgesEnum[]

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.

denyExchangesQuoteExchangesEnum[]

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.

denyPoolsstring[]

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 <poolManagerAddress>-<poolId> 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.

preferBridgesQuoteBridgesEnum[]

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.

preferExchangesQuoteExchangesEnum[]

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.

allowDestinationCallboolean

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.

fromAmountForGasstring

The amount of the token to convert to gas on the destination side.

maxPriceImpactnumber

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%.

swapStepTimingStrategiesstring[]

Timing setting to wait for a certain amount of swap rates. In the format minWaitTime-${minWaitTimeMs}-${startingExpectedResults}-${reduceEveryMs}. Please check docs.li.fi for more details.

[
  "minWaitTime-600-4-300"
]
routeTimingStrategiesstring[]

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 for more details.

[
  "minWaitTime-600-4-300"
]
skipSimulationboolean

Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.

presetstring

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.

svmMaxSupportedTransactionVersion0 | 1 nullable

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.

svmPriorityFeeLevel'NORMAL' | 'FAST' | 'ULTRA'

Priority fee level for Solana Virtual Machine (SVM) transactions.

Headers

x-lifi-api-keystring

Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.

Response

The step populated with the transaction data

idstring required

Unique identifier of the step

type'swap' | 'cross' | 'lifi' | 'protocol' required

The type of the step. swap executes a DEX swap on a single chain, cross bridges assets between chains, lifi runs LiFi's internal multi-action logic, and protocol represents protocol-level actions such as fee collection or vault interactions executed inside LiFi managed contracts.

toolstring required

The tool used for this step. E.g. relay

integratorstring

A string containing tracking information about the integrator of the API

referrerstring

A string containing tracking information about the referrer of the integrator

executionunknown

Example response

{
  "id": "0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9",
  "type": "cross",
  "tool": "relay",
  "action": {
    "fromChainId": 100,
    "toChainId": 137,
    "fromToken": {
      "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
      "symbol": "MIVA",
      "decimals": 18,
      "chainId": 100,
      "name": "Minerva Wallet SuperToken",
      "coinKey": "MIVA",
      "priceUSD": "0.04547537276751318",
      "logoURI": ""
    },
    "toToken": {
      "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
      "symbol": "MIVA",
      "decimals": 18,
      "chainId": 137,
      "name": "Minerva Wallet SuperToken",
      "coinKey": "MIVA",
      "priceUSD": "0",
      "logoURI": ""
    },
    "fromAmount": "1000000000000000000",
    "slippage": 0.003
  },
  "estimate": {
    "fromAmount": "1000000000000000000",
    "toAmount": "999500000000000000",
    "toAmountMin": "999500000000000000",
    "approvalAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
    "feeCosts": [
      {
        "name": "Gas Fee",
        "description": "Covers gas expense for sending funds to user on receiving chain.",
        "percentage": "0",
        "token": {
          "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
          "symbol": "MIVA",
          "decimals": 18,
          "chainId": 100,
          "name": "Minerva Wallet SuperToken",
          "coinKey": "MIVA",
          "priceUSD": "0.04547537276751318",
          "logoURI": ""
        },
        "amount": "0",
        "amountUSD": "0.00",
        "included": true
      },
      {
        "name": "Relay Fee",
        "description": "Covers gas expense for claiming user funds on receiving chain.",
        "percentage": "0",
        "token": {
          "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
          "symbol": "MIVA",
          "decimals": 18,
          "chainId": 100,
          "name": "Minerva Wallet SuperToken",
          "coinKey": "MIVA",
          "priceUSD": "0.04547537276751318",
          "logoURI": ""
        },
        "amount": "0",
        "amountUSD": "0.00",
        "included": true
      },
      {
        "name": "Router Fee",
        "description": "Router service fee.",
        "percentage": "0.0005",
        "token": {
          "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
          "symbol": "MIVA",
          "decimals": 18,
          "chainId": 100,
          "name": "Minerva Wallet SuperToken",
          "coinKey": "MIVA",
          "priceUSD": "0.04547537276751318",
          "logoURI": ""
        },
        "amount": "500000000000000",
        "amountUSD": "0.00",
        "included": true
      }
    ],
    "gasCosts": [
      {
        "type": "SEND",
        "price": "1260000000",
        "estimate": "140000",
        "limit": "175000",
        "amount": "176400000000000",
        "amountUSD": "0.00",
        "token": {
          "address": "0x0000000000000000000000000000000000000000",
          "symbol": "xDai",
          "decimals": 18,
          "chainId": 100,
          "name": "xDai",
          "coinKey": "xDai",
          "priceUSD": "1",
          "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
        }
      }
    ],
    "data": {
      "bid": {
        "user": "0x53F68B2186E4a4aB4dD976eD32de68db45BA360b",
        "router": "0xeE2Ef40F688607CB23618d9312d62392786d13EB",
        "initiator": "0x53F68B2186E4a4aB4dD976eD32de68db45BA360b",
        "sendingChainId": 100,
        "sendingAssetId": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "amount": "1000000000000000000",
        "receivingChainId": 137,
        "receivingAssetId": "0xc0b2983a17573660053beeed6fdb1053107cf387",
        "amountReceived": "999500000000000000",
        "receivingAddress": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
        "transactionId": "0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9",
        "expiry": 1643364189,
        "callDataHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
        "callTo": "0x0000000000000000000000000000000000000000",
        "encryptedCallData": "0x",
        "sendingChainTxManagerAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
        "receivingChainTxManagerAddress": "0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113",
        "bidExpiry": 1643105290
      },
      "gasFeeInReceivingToken": "0",
      "totalFee": "500000000000000",
      "metaTxRelayerFee": "0",
      "routerFee": "500000000000000"
    }
  },
  "integrator": "fee-demo"
}

Changes

No recorded changes to this operation across all 1 revision of this API.