Get multi-protocol rates

get

https://api.tatum.io/defi/v1/swaps/quotes

/defi/v1/swaps/quotes

20 credits per API call

Compare swap rates across all supported protocols. Results are sorted by best price: highest buyAmount for sell orders, lowest sellAmount for buy orders.

Quotes are cached for up to 15 seconds (less than one Ethereum block). Each result includes an expiresAt field (Unix timestamp) indicating when the underlying quote was originally fetched from the protocol. Always check expiresAt against the current time before displaying or acting on a quote — if less than ~10 seconds remain, re-query to get a fresh price.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

sellToken

string

required

ERC-20 token contract address to sell.

buyToken

string

required

ERC-20 token contract address to buy.

amount

string

required

Fixed-side amount in base units. sell order (kind='sell'): exact amount of sellToken to spend. buy order (kind='buy'): exact amount of buyToken to receive.

fromAddress

string

required

Wallet address initiating the swap. Used for CoW fee estimation and quote context.

chain

string

enum

required

Tatum network slug (e.g. ethereum-mainnet, bsc-mainnet, polygon-mainnet). Matches the networks[].id field in https://blockchains.tatum.io/blockchains2.json.

kind

string

enum

Whether this is exact-input (sell) or exact-output (buy).

Allowed:

slippageBps

number

0 to 10000

Slippage tolerance in basis points (1 bps = 0.01%). Applied to the quoted amount to compute limitAmount.

mevFilter

string

enum

Filter quotes by MEV protection status.

protected — only MEV-safe protocols (CoW Protocol). unprotected — only non-MEV protocols (Uniswap, PancakeSwap). omitted — all protocols, no filter.

Allowed:

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200