--- updatedAt: 2026-05-14T11:27:34.000Z --- Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # 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) # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "contact": { "name": "Blockdaemon", "email": "info@blockdaemon.com" }, "description": "The Blockdaemon DeFi API provides a single interface to a multitude of DeFi projects and blockchains", "title": "Blockdaemon DeFi API", "version": "1.0.0", "x-logo": { "altText": "Blockdaemon logo", "backgroundColor": "#fafafa", "url": "https://storage.googleapis.com/blockdaemon-app-static-images/marketing/PNG/dark-logo.png" } }, "externalDocs": { "description": "Blockdaemon DeFi documentation", "url": "http://www.blockdaemon.com/api/defi" }, "servers": [ { "url": "https://svc.blockdaemon.com" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "`X-API-Key: ` header must be set to authenticate API requests.You can create tokens in the \"Configure\" tab of your API access area at https://app.blockdaemon.com." } } }, "tags": [ { "name": "dex", "description": "API endpoints for operations related to decentralized exchange" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/defi/v1/dex/quotes": { "get": { "tags": [ "dex" ], "summary": "Get DEX Swap Quotes", "description": "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.\n\n> 💡 \n**Compute Unit Value:** `100` (Fixed)", "operationId": "dexQuotes", "parameters": [ { "name": "chainId", "in": "query", "required": false, "schema": { "type": "string", "description": "The unique ID to direct queries or transactions to the correct blockchain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).", "enum": [ "1", "43114", "56", "137", "42161", "10", "8453", "324", "5000", "900", "1400", "1200", "101", "1700", "1500", "1100", "1600", "8217" ], "example": "1" }, "description": "The unique ID to direct queries or transactions to the correct blockchain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains)." }, { "name": "path", "in": "query", "required": true, "schema": { "type": "string", "description": "Ordered sequence of token contract addresses defining the swap route, provided as a comma-separated string. For a direct swap from token A to B: 'tokenInAddress,tokenOutAddress'. Example (WETH→USDC on Ethereum): '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'.", "example": "0x514910771AF9Ca656af840dff83E8264EcF986CA,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" }, "description": "Ordered sequence of token contract addresses defining the swap route, provided as a comma-separated string. For a direct swap from token A to B: 'tokenInAddress,tokenOutAddress'. Example (WETH→USDC on Ethereum): '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'." }, { "name": "amountIn", "in": "query", "required": true, "schema": { "type": "string", "description": "Amount of the input token to provide, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: to swap 1 WETH (18 decimals), use \"1000000000000000000\"; to swap 1 USDC (6 decimals), use \"1000000\".", "example": "1000000000000000000" }, "description": "Amount of the input token to provide, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: to swap 1 WETH (18 decimals), use \"1000000000000000000\"; to swap 1 USDC (6 decimals), use \"1000000\"." }, { "name": "chainSymbol", "in": "query", "required": false, "schema": { "type": "string", "description": "The abbreviated chain name for queries or transactions.", "example": "ETH" }, "description": "The abbreviated chain name for queries or transactions." }, { "name": "excludedDexes", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated list of DEX protocol IDs (dexId values) to exclude from routing. Find available IDs via the /support endpoint.", "example": "1700" }, "description": "Comma-separated list of DEX protocol IDs (dexId values) to exclude from routing. Find available IDs via the /support endpoint." }, { "name": "poolFees", "in": "query", "required": false, "schema": { "type": "string", "description": "Fee tier of the target liquidity pool in basis points (1 bp = 0.01%). Common values for Uniswap V3-style AMMs: 100 (0.01%), 500 (0.05%), 3000 (0.3%), 10000 (1%). If omitted, the pool yielding the highest output amount is selected automatically.", "example": "3000" }, "description": "Fee tier of the target liquidity pool in basis points (1 bp = 0.01%). Common values for Uniswap V3-style AMMs: 100 (0.01%), 500 (0.05%), 3000 (0.3%), 10000 (1%). If omitted, the pool yielding the highest output amount is selected automatically." }, { "name": "vsCurrencies", "in": "query", "required": false, "schema": { "type": "string", "description": "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" }, "description": "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." }, { "name": "maxPriceImpact", "in": "query", "required": false, "schema": { "type": "string", "description": "Maximum acceptable price impact as a percentage (e.g., '0.01' means 0.01% price impact). Quotes that would cause a price impact exceeding this value are excluded from results.", "example": "0.01" }, "description": "Maximum acceptable price impact as a percentage (e.g., '0.01' means 0.01% price impact). Quotes that would cause a price impact exceeding this value are excluded from results." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "number", "description": "Numeric status code indicating success or failure of the API call", "example": 200 }, "msg": { "type": "string", "description": "Human-readable message describing the API result or error" }, "data": { "type": "array", "items": { "type": "object", "properties": { "dexId": { "type": "string", "description": "Unique ID for a decentralized exchange", "example": "1000" }, "dexName": { "type": "string", "description": "Name of the decentralized exchange" }, "amountIn": { "type": "string", "description": "Amount of input token in a swap", "example": "10000" }, "path": { "type": "array", "items": { "type": "string" }, "description": "Array of token addresses representing a swap route", "example": [ "0x514910771AF9Ca656af840dff83E8264EcF986CA,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" ] }, "amountsOut": { "type": "array", "items": { "type": "string" }, "description": "Expected output amounts from swaps or conversions" }, "bridgeId": { "type": "string", "description": "Unique identifier for a bridge service", "example": "100" }, "bridgeName": { "type": "string", "description": "Human-readable bridge service name" }, "priceImpact": { "type": "object", "description": "Price impact details for the swap", "properties": { "percentage": { "type": "string", "description": "Price impact as a percentage (negative indicates unfavorable slippage)", "example": "-0.1368" }, "value": { "type": "string", "description": "Price impact value in USD", "example": "-0.116555" } } } }, "required": [ "amountIn", "path", "amountsOut" ] } } }, "example": { "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" } } ] } } } } } }, "x-bd-cu": "100", "x-bd-cu-type": "fixed", "x-internal": false } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```