Create DEX Swap Transaction

post

https://svc.blockdaemon.com/defi/v1/dex/swap

Enables users to perform token swaps on a DEX by supplying source tokens, desired output tokens, and other trade parameters. This endpoint calculates the optimal path (or uses a given path) across liquidity pools, then returns key details such as the route taken, final amounts, and any additional transaction data needed to finalize the swap on-chain. It is particularly useful for DeFi integrations that require seamless conversions between multiple ERC20 tokens within a single request.

Compute Unit Value: 55 (Fixed)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The request body for a /defi/v1/dex/swap

dexId

string

enum

The unique ID to specify the decentralized exchange (DEX) within a particular blockchain. Find more here.

path

array of strings

required

Array of token addresses to swap, in order of the swap.

path*

amountIn

string

required

Amount of token to be swapped.

amountOutMin

string

Minimum amount accepted as the result of the swap.

string

required

Address of the recipient of the token.

deadline

string

required

Deadline for the transaction to be executed (UNIX Timestamp).

from

string

required

Address of the sender of the token.

gas

string

Maximum gas to be approved for the transaction.

gasPriority

string

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

slippage

string

Percentage of total swap value allowed for slippage. Default is 1 (0 <= slippage <= 100).

enableFee

boolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

batchOption

string

enum

The batch option to be used for the transaction.

Allowed:

batcherContract

string

The EOA address of the batcher that will be used to execute the transaction when using EIP-7702 batching. If not provided, the default batcher contract for the chain will be used.

poolFees

string

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

Response

Language

Credentials

Header

Loading…

Response

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

application/json

200Successful response