Create Order

post

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

Generates an unsigned limit order message for decentralized trading, specifying parameters for maker/taker assets, amounts, fees, and execution conditions. The endpoint returns EIP-712 domain data, type definitions, and a structured payload (including salt, addresses, and asset data), which must be signed using the Blockdaemon SDK to finalize the order on-chain.

💡
Compute Unit Value: 15 (Fixed)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

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

dexId

string

enum

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

amountOutMin

string

Minimum acceptable output amount in the token's smallest denomination (base units). Provides slippage protection — the transaction reverts if the output falls below this value. Set to "0" to disable slippage protection. Examples: to require at least 0.99 USDC (6 decimals), use "990000"; to require at least 0.99 WETH (18 decimals), use "990000000000000000".

decayStartTime

string

required

The start time for Dutch auction bidding. Provide a UNIX Timestamp.

decayEndTime

string

required

The end time for Dutch auction bidding. Provide a UNIX Timestamp.

deadline

string

required

The latest time the transaction is valid before expiration. Provide a UNIX Timestamp.

from

string

required

The wallet address of the token sender.

path

array of strings

required

Array of token contract addresses for the order pair. Provide [inputTokenAddress, outputTokenAddress].

path*

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".

string

required

The wallet address of the recipient of the token.

slippage

string

The percentage of the total swap value that is acceptable as slippage. Default: 1%. Valid range: 0% ≤ slippage ≤ 10%.

enableFee

boolean

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

makerAsset

string

required

The token address of the asset the Maker is offering (selling) in the order.

takerAsset

string

required

The token address of the asset the Maker expects to receive (buying) in return.

amountOut

string

required

Amount of the output token to receive, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: 1 WETH (18 decimals) = "1000000000000000000"; 1 USDC (6 decimals) = "1000000".

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