advanced

Get information about available services, chains and tokens

Get a set of current possibilities based on a request that specifies which chains, exchanges and bridges are preferred or unwanted. Attention: This request is more complex and intended to be used via our JavaScript SDK.

post/v1/advanced/possibilities

Request

Base URL
https://li.quest
Auth
none declared
TypeScript
https://skmtc.dev/lifi/apis/li-fi-api/docs/v1/advanced/possibilities/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

x-lifi-api-keystring

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

Request body

chainsnumber[]

The ids of the chains that should be taken into consideration for the possibilities

includePossibilitiesTopicEnum[]

To reduce the size of the returned possibilities, you can select which kind of information you like to see. Possible values are chains, tokens, bridges, and exchanges.

Example request

{
  "chains": [
    100,
    137
  ],
  "bridges": {
    "allow": [
      "relay",
      "hop"
    ],
    "deny": [
      "cbridge"
    ],
    "prefer": [
      "relay"
    ]
  },
  "exchanges": {
    "allow": [
      "1inch",
      "paraswap",
      "openocean"
    ],
    "deny": [
      "0x"
    ],
    "prefer": [
      "1inch"
    ]
  }
}

Response

Object listing current possibilities for any-to-any cross-chain-swaps based on the provided preferences.

Example response

{
  "chains": [
    {
      "key": "pol",
      "name": "Polygon",
      "coin": "MATIC",
      "id": 137,
      "mainnet": true,
      "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/chains/polygon.svg",
      "tokenlistUrl": "https://unpkg.com/quickswap-default-token-list@1.0.71/build/quickswap-default.tokenlist.json",
      "faucetUrls": [
        "https://stakely.io/faucet/polygon-matic"
      ],
      "metamask": {
        "chainId": "0x89",
        "blockExplorerUrls": [
          "https://polygonscan.com/",
          "https://explorer-mainnet.maticvigil.com/"
        ],
        "chainName": "Matic(Polygon) Mainnet",
        "nativeCurrency": {
          "name": "MATIC",
          "symbol": "MATIC",
          "decimals": 18
        },
        "rpcUrls": [
          "https://polygon-rpc.com/",
          "https://polygon.llamarpc.com/"
        ]
      }
    }
  ],
  "tokens": [
    {
      "address": "0x6a023ccd1ff6f2045c3309768ead9e68f978f6e1",
      "decimals": 18,
      "symbol": "ETH",
      "chainId": 100,
      "coinKey": "ETH",
      "name": "ETH",
      "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0x6a023ccd1ff6f2045c3309768ead9e68f978f6e1/61844453e63cf81301f845d7864236f6.png",
      "priceUSD": "2254.1"
    },
    {
      "address": "0x7122d7661c4564b7c6cd4878b06766489a6028a2",
      "decimals": 18,
      "symbol": "MATIC",
      "chainId": 100,
      "coinKey": "MATIC",
      "name": "MATIC",
      "logoURI": "https://etherscan.io/token/images/matictoken_28.png",
      "priceUSD": "0"
    },
    {
      "address": "0xca8d20f3e0144a72c6b5d576e9bd3fd8557e2b04",
      "decimals": 18,
      "symbol": "BNB",
      "chainId": 100,
      "coinKey": "BNB",
      "name": "BNB",
      "logoURI": "https://assets.coingecko.com/coins/images/825/small/binance-coin-logo.png?1547034615",
      "priceUSD": "0"
    }
  ],
  "exchanges": [
    {
      "tool": "paraswap",
      "chains": [
        1,
        56,
        137,
        43114,
        3,
        4,
        42
      ]
    },
    {
      "tool": "1inch",
      "chains": [
        1,
        56,
        137,
        10,
        43114,
        100
      ]
    }
  ],
  "bridges": [
    {
      "tool": "relay",
      "fromChainId": 100,
      "fromToken": {
        "address": "0x6a023ccd1ff6f2045c3309768ead9e68f978f6e1",
        "decimals": 18,
        "symbol": "ETH",
        "chainId": 100,
        "coinKey": "ETH",
        "name": "ETH",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0x6a023ccd1ff6f2045c3309768ead9e68f978f6e1/61844453e63cf81301f845d7864236f6.png",
        "priceUSD": "2254.1"
      },
      "toChainId": 137,
      "toToken": {
        "address": "0x7ceb23fd6bc0add59e62ac25578270cff1b9f619",
        "decimals": 18,
        "symbol": "ETH",
        "chainId": 137,
        "coinKey": "ETH",
        "name": "ETH",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0x7ceb23fd6bc0add59e62ac25578270cff1b9f619/61844453e63cf81301f845d7864236f6.png",
        "priceUSD": "2254.1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    },
    {
      "tool": "relay",
      "fromChainId": 100,
      "fromToken": {
        "address": "0xddafbb505ad214d7b80b1f830fccc89b60fb7a83",
        "decimals": 6,
        "symbol": "USDC",
        "chainId": 100,
        "coinKey": "USDC",
        "name": "USDC",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0xddafbb505ad214d7b80b1f830fccc89b60fb7a83/adee072b10b0db7c5bd7a28dd4fbe96f.png",
        "priceUSD": "1"
      },
      "toChainId": 137,
      "toToken": {
        "address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
        "decimals": 6,
        "symbol": "USDC",
        "chainId": 137,
        "coinKey": "USDC",
        "name": "USDC",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0x2791bca1f2de4661ed88a30c99a7a9449aa84174/adee072b10b0db7c5bd7a28dd4fbe96f.png",
        "priceUSD": "1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    },
    {
      "tool": "relay",
      "fromChainId": 100,
      "fromToken": {
        "address": "0x4ecaba5870353805a9f068101a40e0f32ed605c6",
        "decimals": 6,
        "symbol": "USDT",
        "chainId": 100,
        "coinKey": "USDT",
        "name": "USDT",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0x4ecaba5870353805a9f068101a40e0f32ed605c6/66eadee7b7bb16b75e02b570ab8d5c01.png",
        "priceUSD": "1"
      },
      "toChainId": 137,
      "toToken": {
        "address": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f",
        "decimals": 6,
        "symbol": "USDT",
        "chainId": 137,
        "coinKey": "USDT",
        "name": "USDT",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0xc2132d05d31c914a87c6611c10748aeb04b58e8f/66eadee7b7bb16b75e02b570ab8d5c01.png",
        "priceUSD": "1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    },
    {
      "tool": "hop",
      "fromChainId": 137,
      "fromToken": {
        "address": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f",
        "decimals": 6,
        "symbol": "USDT",
        "chainId": 137,
        "coinKey": "USDT",
        "name": "USDT",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0xc2132d05d31c914a87c6611c10748aeb04b58e8f/66eadee7b7bb16b75e02b570ab8d5c01.png",
        "priceUSD": "1"
      },
      "toChainId": 100,
      "toToken": {
        "address": "0x4ecaba5870353805a9f068101a40e0f32ed605c6",
        "decimals": 6,
        "symbol": "USDT",
        "chainId": 100,
        "coinKey": "USDT",
        "name": "USDT",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0x4ecaba5870353805a9f068101a40e0f32ed605c6/66eadee7b7bb16b75e02b570ab8d5c01.png",
        "priceUSD": "1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    },
    {
      "tool": "hop",
      "fromChainId": 137,
      "fromToken": {
        "address": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
        "decimals": 6,
        "symbol": "USDC",
        "chainId": 137,
        "coinKey": "USDC",
        "name": "USDC",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0x2791bca1f2de4661ed88a30c99a7a9449aa84174/adee072b10b0db7c5bd7a28dd4fbe96f.png",
        "priceUSD": "1"
      },
      "toChainId": 100,
      "toToken": {
        "address": "0xddafbb505ad214d7b80b1f830fccc89b60fb7a83",
        "decimals": 6,
        "symbol": "USDC",
        "chainId": 100,
        "coinKey": "USDC",
        "name": "USDC",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/0xddafbb505ad214d7b80b1f830fccc89b60fb7a83/adee072b10b0db7c5bd7a28dd4fbe96f.png",
        "priceUSD": "1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    },
    {
      "tool": "hop",
      "fromChainId": 137,
      "fromToken": {
        "address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
        "decimals": 18,
        "symbol": "DAI",
        "chainId": 137,
        "coinKey": "DAI",
        "name": "DAI",
        "logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
        "priceUSD": "1"
      },
      "toChainId": 100,
      "toToken": {
        "address": "0x0000000000000000000000000000000000000000",
        "decimals": 18,
        "symbol": "DAI",
        "chainId": 100,
        "coinKey": "DAI",
        "name": "DAI",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png",
        "priceUSD": "1"
      },
      "maximumTransfer": "Infinity",
      "minimumTransfer": "1",
      "swapFeeRate": "0.005",
      "swapFeeMinimum": "0",
      "swapFeeMaximum": "Infinity"
    }
  ]
}

Changes

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