---
title: "Get DEX Swap Quotes"
method: GET
path: "/defi/v1/dex/quotes"
tags: ["dex"]
---

# Get DEX Swap Quotes

`GET /defi/v1/dex/quotes`

## Request

- Base URL: `https://svc.blockdaemon.com`
- URL: `https://svc.blockdaemon.com/defi/v1/dex/quotes`
- Auth: API key in header `X-API-Key`

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)

## 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](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).
- `path` string, required: 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'.
- `amountIn` string, required: 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".
- `chainSymbol` string: The abbreviated chain name for queries or transactions.
- `excludedDexes` string: Comma-separated list of DEX protocol IDs (dexId values) to exclude from routing. Find available IDs via the /support endpoint.
- `poolFees` string: 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.
- `vsCurrencies` string: 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.
- `maxPriceImpact` string: 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.

## Response `200`

Successful response

- object
  - `status` number: Numeric status code indicating success or failure of the API call
  - `msg` string: Human-readable message describing the API result or error
  - `data` object[]
    - `dexId` string: Unique ID for a decentralized exchange
    - `dexName` string: Name of the decentralized exchange
    - `amountIn` string, required: Amount of input token in a swap
    - `path` string[], required: Array of token addresses representing a swap route
    - `amountsOut` string[], required: Expected output amounts from swaps or conversions
    - `bridgeId` string: Unique identifier for a bridge service
    - `bridgeName` string: Human-readable bridge service name
    - `priceImpact` object: Price impact details for the swap
      - `percentage` string: Price impact as a percentage (negative indicates unfavorable slippage)
      - `value` string: Price impact value in USD

---

[API](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api.md) - [All operations](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/revisions/ec053b7c8041?raw)
