POST
/
v1
/
advanced
/
routes
Get a set of routes for a request that describes a transfer of tokens
curl --request POST \
  --url https://li.quest/v1/advanced/routes \
  --header 'Content-Type: application/json' \
  --data '{
  "fromChainId": 100,
  "fromAmount": "1000000000000000000",
  "fromTokenAddress": "0x0000000000000000000000000000000000000000",
  "toChainId": 137,
  "toTokenAddress": "0x0000000000000000000000000000000000000000",
  "options": {
    "integrator": "fee-demo",
    "referrer": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "slippage": 0.003,
    "fee": 0.02,
    "bridges": {
      "allow": [
        "relay"
      ]
    },
    "exchanges": {
      "allow": [
        "1inch",
        "openocean"
      ]
    },
    "allowSwitchChain": true,
    "order": "CHEAPEST",
    "maxPriceImpact": 0.1
  }
}'
{
  "routes": [
    {
      "id": "0x1e21fad9c26fff48b67ae2925f878e43bf81211da8b1cd9b7faa8bfd8d7ea9d9",
      "fromChainId": 100,
      "fromAmountUSD": "0.05",
      "fromAmount": "1000000000000000000",
      "fromToken": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.04547537276751318",
        "logoURI": ""
      },
      "toChainId": 137,
      "toAmountUSD": "0.00",
      "toAmount": "999500000000000000",
      "toAmountMin": "999500000000000000",
      "toToken": {
        "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 137,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0",
        "logoURI": ""
      },
      "gasCostUSD": "0.00",
      "steps": [
        {
          "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": "22737686383756.59",
                "included": true
              }
            ],
            "gasCosts": [
              {
                "type": "SEND",
                "price": "1.26",
                "estimate": "140000",
                "limit": "175000",
                "amount": "176400",
                "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"
        }
      ]
    },
    {
      "id": "0xb785f52e68f8a6fb147d5e392e06f122c1a418be84bdc28de0f311b91fa5e57e",
      "fromChainId": 100,
      "fromAmountUSD": "0.05",
      "fromAmount": "1000000000000000000",
      "fromToken": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.04547537276751318",
        "logoURI": ""
      },
      "toChainId": 137,
      "toAmountUSD": "0.00",
      "toAmount": "941511949935063841",
      "toAmountMin": "913266591437011926",
      "toToken": {
        "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 137,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0",
        "logoURI": ""
      },
      "gasCostUSD": "0.10",
      "steps": [
        {
          "id": "ea5abad4-2e2a-476f-981d-797816e5cc77",
          "type": "swap",
          "tool": "1inch",
          "action": {
            "fromChainId": 100,
            "toChainId": 100,
            "fromToken": {
              "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
              "symbol": "MIVA",
              "decimals": 18,
              "chainId": 100,
              "name": "Minerva Wallet SuperToken",
              "coinKey": "MIVA",
              "priceUSD": "0.04547537276751318",
              "logoURI": ""
            },
            "toToken": {
              "name": "Own a fraction",
              "symbol": "FRACTION",
              "coinKey": "FRACTION",
              "decimals": 18,
              "chainId": 100,
              "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
              "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
            },
            "fromAmount": "1000000000000000000",
            "slippage": 0.003
          },
          "estimate": {
            "fromAmount": "1000000000000000000",
            "toAmount": "809146346742",
            "toAmountMin": "784871956340",
            "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
            "feeCosts": [],
            "gasCosts": [
              {
                "type": "SEND",
                "price": "1.26",
                "estimate": "252364",
                "limit": "315455",
                "amount": "317979",
                "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": {
              "fromToken": {
                "name": "Minerva Wallet SuperToken",
                "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
                "symbol": "MIVA",
                "decimals": 18,
                "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png"
              },
              "toToken": {
                "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61",
                "decimals": 18,
                "symbol": "FRACTION",
                "name": "Own a fraction",
                "logoURI": "https://etherscan.io/images/main/empty-token.png",
                "isCustom": true
              },
              "toTokenAmount": "809146346742",
              "fromTokenAmount": "1000000000000000000",
              "protocols": [
                [
                  [
                    {
                      "name": "GNOSIS_HONEYSWAP",
                      "part": 100,
                      "fromTokenAddress": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
                      "toTokenAddress": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
                    }
                  ]
                ]
              ],
              "estimatedGas": 252364
            }
          },
          "integrator": "fee-demo"
        },
        {
          "id": "0x85e93238e8f2f83dd5840eb748c7b9099d69e1ea227a13e7a2e949cf6a32ab7d",
          "type": "cross",
          "tool": "relay",
          "action": {
            "fromChainId": 100,
            "toChainId": 137,
            "fromToken": {
              "name": "Own a fraction",
              "symbol": "FRACTION",
              "coinKey": "FRACTION",
              "decimals": 18,
              "chainId": 100,
              "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
              "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
            },
            "toToken": {
              "name": "Own a fraction",
              "symbol": "FRACTION",
              "coinKey": "FRACTION",
              "decimals": 18,
              "chainId": 137,
              "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
              "address": "0xbd80cfa9d93a87d1bb895f810ea348e496611cd4"
            },
            "fromAmount": "784871956340",
            "slippage": 0.003
          },
          "estimate": {
            "fromAmount": "784871956340",
            "toAmount": "784479520361",
            "toAmountMin": "784479520361",
            "approvalAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
            "feeCosts": [
              {
                "name": "Gas Fee",
                "description": "Covers gas expense for sending funds to user on receiving chain.",
                "percentage": "0",
                "token": {
                  "name": "Own a fraction",
                  "symbol": "FRACTION",
                  "coinKey": "FRACTION",
                  "decimals": 18,
                  "chainId": 100,
                  "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
                  "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
                },
                "amount": "0",
                "amountUSD": "0.00",
                "included": true
              },
              {
                "name": "Relay Fee",
                "description": "Covers gas expense for claiming user funds on receiving chain.",
                "percentage": "0",
                "token": {
                  "name": "Own a fraction",
                  "symbol": "FRACTION",
                  "coinKey": "FRACTION",
                  "decimals": 18,
                  "chainId": 100,
                  "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
                  "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
                },
                "amount": "0",
                "amountUSD": "0.00",
                "included": true
              },
              {
                "name": "Router Fee",
                "description": "Router service fee.",
                "percentage": "0.00050000000105749733",
                "token": {
                  "name": "Own a fraction",
                  "symbol": "FRACTION",
                  "coinKey": "FRACTION",
                  "decimals": 18,
                  "chainId": 100,
                  "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
                  "address": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61"
                },
                "amount": "392435979",
                "amountUSD": "0.00",
                "included": true
              }
            ],
            "gasCosts": [
              {
                "type": "SEND",
                "price": "1.26",
                "estimate": "140000",
                "limit": "175000",
                "amount": "176400",
                "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": "0x2bf2ba13735160624a0feae98f6ac8f70885ea61",
                "amount": "784871956340",
                "receivingChainId": 137,
                "receivingAssetId": "0xbd80cfa9d93a87d1bb895f810ea348e496611cd4",
                "amountReceived": "784479520361",
                "receivingAddress": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
                "transactionId": "0x85e93238e8f2f83dd5840eb748c7b9099d69e1ea227a13e7a2e949cf6a32ab7d",
                "expiry": 1643364189,
                "callDataHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
                "callTo": "0x0000000000000000000000000000000000000000",
                "encryptedCallData": "0x",
                "sendingChainTxManagerAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
                "receivingChainTxManagerAddress": "0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113",
                "bidExpiry": 1643105290
              },
              "gasFeeInReceivingToken": "0",
              "totalFee": "392435979",
              "metaTxRelayerFee": "0",
              "routerFee": "392435979"
            }
          },
          "integrator": "fee-demo"
        },
        {
          "id": "d8686af1-c131-4566-bf4a-ef8226f9879b",
          "type": "swap",
          "tool": "1inch",
          "action": {
            "fromChainId": 137,
            "toChainId": 137,
            "fromToken": {
              "name": "Own a fraction",
              "symbol": "FRACTION",
              "coinKey": "FRACTION",
              "decimals": 18,
              "chainId": 137,
              "logoURI": "https://assets.coingecko.com/coins/images/15099/large/fraction.png?1619691519",
              "address": "0xbd80cfa9d93a87d1bb895f810ea348e496611cd4"
            },
            "toToken": {
              "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
              "symbol": "MIVA",
              "decimals": 18,
              "chainId": 137,
              "name": "Minerva Wallet SuperToken",
              "coinKey": "MIVA",
              "priceUSD": "0",
              "logoURI": ""
            },
            "fromAmount": "784479520361",
            "slippage": 0.003
          },
          "estimate": {
            "fromAmount": "784479520361",
            "toAmount": "941511949935063841",
            "toAmountMin": "913266591437011926",
            "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
            "feeCosts": [],
            "gasCosts": [
              {
                "type": "SEND",
                "price": "129",
                "estimate": "549386",
                "limit": "686733",
                "amount": "70870794",
                "amountUSD": "0.10",
                "token": {
                  "address": "0x0000000000000000000000000000000000000000",
                  "symbol": "MATIC",
                  "decimals": 18,
                  "chainId": 137,
                  "name": "MATIC",
                  "coinKey": "MATIC",
                  "priceUSD": "1.469213",
                  "logoURI": "https://static.debank.com/image/matic_token/logo_url/matic/e5a8a2860ba5cf740a474dcab796dc63.png"
                }
              }
            ],
            "data": {
              "fromToken": {
                "address": "0xbd80cfa9d93a87d1bb895f810ea348e496611cd4",
                "decimals": 18,
                "symbol": "FRACTION",
                "name": "Own a fraction",
                "logoURI": "https://etherscan.io/images/main/empty-token.png",
                "isCustom": true
              },
              "toToken": {
                "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
                "decimals": 18,
                "symbol": "MIVA",
                "name": "Minerva Wallet SuperToken",
                "logoURI": "https://etherscan.io/images/main/empty-token.png",
                "isCustom": true
              },
              "toTokenAmount": "941511949935063841",
              "fromTokenAmount": "784479520361",
              "protocols": [
                [
                  [
                    {
                      "name": "POLYGON_QUICKSWAP",
                      "part": 100,
                      "fromTokenAddress": "0xbd80cfa9d93a87d1bb895f810ea348e496611cd4",
                      "toTokenAddress": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619"
                    }
                  ],
                  [
                    {
                      "name": "POLYDEX_FINANCE",
                      "part": 100,
                      "fromTokenAddress": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
                      "toTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
                    }
                  ],
                  [
                    {
                      "name": "POLYGON_QUICKSWAP",
                      "part": 100,
                      "fromTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
                      "toTokenAddress": "0xc0b2983a17573660053beeed6fdb1053107cf387"
                    }
                  ]
                ]
              ],
              "estimatedGas": 549386
            }
          },
          "integrator": "fee-demo"
        }
      ]
    }
  ],
  "errors": [
    {
      "errorType": "NO_QUOTE",
      "code": "NO_POSSIBLE_ROUTE",
      "action": {
        "fromChainId": 42161,
        "toChainId": 42161,
        "fromToken": {
          "address": "0xff970a61a04b1ca14834a43f5de4533ebddb5cc8",
          "decimals": 6,
          "symbol": "USDC",
          "coinKey": "USDC",
          "chainId": 42161,
          "name": "USDC",
          "logoURI": "http://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png\",",
          "priceUSD": "1.001"
        },
        "toToken": {
          "address": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
          "decimals": 6,
          "symbol": "USDT",
          "coinKey": "USDT",
          "chainId": 42161,
          "name": "Tether USD",
          "logoURI": "http://get.celer.app/cbridge-icons/USDT.png\""
        },
        "fromAmount": "100000",
        "slippage": 0.003
      }
    }
  ]
}

Headers

​
x-lifi-api-key
string

Authentication header, contact support if you want to get registered.

Body

application/json

The request object describes a desired any-to-any transfer and contains all information necessary to calculate the most efficient routes.

A description of a token transfer

​
fromChainId
number
required

The sending chain id

​
fromAmount
string
required

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

​
fromTokenAddress
string
required

The address of the sending Token

​
toChainId
number
required

The id of the receiving chain

​
toTokenAddress
string
required

The address of the receiving Token

​
options
object

Optional configuration for the routes

Example:
{
  "integrator": "fee-demo",
  "slippage": 0.003,
  "fee": 0.02,
  "bridges": { "allow": ["relay"] },
  "exchanges": { "allow": ["1inch", "openocean"] },
  "maxPriceImpact": 0.1
}
​
fromAddress
string

The sending wallet address

​
toAddress
string

The receiving wallet address

​
fromAmountForGas
string

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

Response

The resulting routes that can be used to realize the described transfer of tokens

A list of routes that can be used to realize the described transfer of tokens

​
routes
Root Type for Route · object[]
required

List of possible Routes for the given transfer

​
unavailableRoutes
object[]

An object representing the routes that are unavailable for the given transfer