v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

dex

Get DEX Swap Quotes

Retrieves a comprehensive list of swap quotations from multiple DEXs for a specified token pair pool. By aggregating swap quotes across various DEXs, it enables users to compare rates and identify the most favorable trading option. The response includes detailed information such as the DEX name and identifier, the input amount, the swap path, and the resulting output amounts from each DEX, making it a valuable tool for pricing data and swap execution decisions.

💡 Compute Unit Value: 100 (Fixed)

get/defi/v1/dex/quotes

Query parameters

chainId'1' | '43114' | '56' | '137' | '42161' | '10' | '8453' | '324' | '5000' | '900' | '1400' | '1200' | '101' | '1700' | '1500' | '1100' | '1600' | '8217'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

Example:1

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

pathstring required

Comma-separated values of token pair.

Example:0x514910771AF9Ca656af840dff83E8264EcF986CA,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

Comma-separated values of token pair.

amountInstring required

Amount of token.

Example:10000

Amount of token.

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

The abbreviated chain name for queries or transactions.

excludedDexesstring

Comma-separated values of dexes to exclude.

Example:1700

Comma-separated values of dexes to exclude.

poolFeesstring

Different pool based on the fees. By default, it will take the pool with maximum amountOut.

Example:3000

Different pool based on the fees. By default, it will take the pool with maximum amountOut.

vsCurrenciesstring

A comma-separated list of currency symbols to convert the amount into, such as 'USD,EUR'. This parameter is optional and allows retrieving values in multiple fiat currencies.

Example:usd,eur,gbp

A comma-separated list of currency symbols to convert the amount into, such as 'USD,EUR'. This parameter is optional and allows retrieving values in multiple fiat currencies.

maxPriceImpactstring

The maximum price impact percentage to consider for the quote.

Example:0.01

The maximum price impact percentage to consider for the quote.

Response

Successful response

statusnumber

Numeric status code indicating success or failure of the API call

msgstring

Human-readable message describing the API result or error

Example response

{
  "status": 200,
  "msg": "success",
  "data": [
    {
      "dexId": "2200",
      "dexName": "Kyberswap",
      "amountIn": "1000000000000000000",
      "path": [
        "0x514910771AF9Ca656af840dff83E8264EcF986CA",
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
      ],
      "amountsOut": [
        "1000000000000000000",
        "9044988"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.0000",
        "value": "0.000000"
      }
    },
    {
      "dexId": "1300",
      "dexName": "UniswapV3",
      "amountIn": "1000000000000000000",
      "path": [
        "0x514910771AF9Ca656af840dff83E8264EcF986CA",
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
      ],
      "amountsOut": [
        "1000000000000000000",
        "9044309"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.3007",
        "value": "0.027282"
      }
    },
    {
      "bridgeId": "600",
      "bridgeName": "SquidRouterV2",
      "srcChainId": "1",
      "dstChainId": "1",
      "srcTokenSymbol": "LINK",
      "dstTokenSymbol": "USDC",
      "srcTokenAddress": "0x514910771AF9Ca656af840dff83E8264EcF986CA",
      "dstTokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "amountIn": "1000000000000000000",
      "amountsOut": [
        "1000000000000000000",
        "9044309"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.3619",
        "value": "0.032847"
      }
    },
    {
      "dexId": "1400",
      "dexName": "BalancerV2",
      "amountIn": "1000000000000000000",
      "path": [
        "0x514910771AF9Ca656af840dff83E8264EcF986CA",
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
      ],
      "amountsOut": [
        "1000000000000000000",
        "9033226"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.4840",
        "value": "0.043930"
      }
    },
    {
      "dexId": "1600",
      "dexName": "0x",
      "amountIn": "1000000000000000000",
      "path": [
        "0x514910771AF9Ca656af840dff83E8264EcF986CA",
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
      ],
      "amountsOut": [
        "1000000000000000000",
        "9025485"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "0.1500",
        "value": "0.013559"
      }
    },
    {
      "dexId": "1000",
      "dexName": "UniswapV2",
      "amountIn": "1000000000000000000",
      "path": [
        "0x514910771AF9Ca656af840dff83E8264EcF986CA",
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
      ],
      "amountsOut": [
        "1000000000000000000",
        "8787450"
      ],
      "prices": {
        "usd": [
          {
            "0x514910771AF9Ca656af840dff83E8264EcF986CA": "9.075482776456836"
          },
          {
            "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": "0.9998156269527559"
          }
        ]
      },
      "priceImpact": {
        "percentage": "3.0504",
        "value": "0.276486"
      }
    }
  ]
}