Create a gasless order

The order endpoint is used to submit a UniswapX intent. If the routing field in the response to a quote is any of DUTCH_V2, DUTCH_V3, LIMIT_ORDER, or PRIORITY this endpoint is used to submit your order to the UniswapX protocol to be filled by the filler network. These orders are gasless because the filler will pay the gas to complete the transaction.

The order will be validated and, if valid, will be submitted to the filler network. The network will try to fill the order at the quoted startAmount. If the order is not filled at the startAmount by the deadline, the amount will start decaying until the endAmount is reached. The order will remain open until it is either filled, canceled, or has expired by remaining unfilled beyond the decayEndTime.

For simplicity, the order request is identical to the quote response except for the addition of the signed permit.

Native ETH on UniswapX: If the quote you are submitting uses native ETH as the input token (e.g. tokenIn is 0x0000000000000000000000000000000000000000), include x-erc20eth-enabled: true. Native ETH input on UniswapX requires wallet support for EIP-7914 and sufficient native allowance. For 7702-delegated smart contract wallets, you can generate the required approval call(s) via /swap_7702 when needed.

Get a UniswapX QuoteThis endpoint requires a signed UniswapX order. A Dutch auction quote will be fetched, but you'll need to sign the order with your wallet to submit it.

Authorization

x-api-keystringrequiredheader

Playground key

You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.

Get your keys

Headers

x-erc20eth-enabledbooleandefault:false

Enable native ETH input support for UniswapX via ERC20-ETH (EIP-7914). When set to true and tokenIn is the native currency address (e.g. 0x0000000000000000000000000000000000000000), the API may return UniswapX routes that spend native ETH for supported wallets.

Body

application/json

signaturestringrequired

The signed permit.

routingenum

CLASSICDUTCH_LIMITDUTCH_V2DUTCH_V3BRIDGELIMIT_ORDERPRIORITYWRAPUNWRAPCHAINED

The routing for the proposed transaction.

Response

Encoded order submitted.

requestIdstringrequired

A unique ID for the request.

orderIdstringrequired

A unique ID for the order. Used to track the order's status.

orderStatusenumrequired

The status of the order. Note that all of these are final states with the exception of Open, meaning that no further state changes will occur.
Open - order is not yet filled by a filler.
Expired - order has expired without being filled and is no longer fillable.
Error - a catchall for other final states which are not otherwise specified, where the order will not be filled.
Cancelled - order is cancelled. Note that to cancel an order, a new order must be placed with the same nonce as the prior open order and it must be placed within the same block as the original order.
Filled - order is filled.
Insufficient-funds - the swapper (you) do not have enough funds for the order to be completed and the order is cancelled and will not be filled.
Unverified - order has not been verified yet.

POST/order

Request

curl --request POST \
  --url 'https://trade-api.gateway.uniswap.org/v1/order' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-erc20eth-enabled: false'

Response

201

{  "requestId": "<string>",  "orderId": "<string>",  "orderStatus": "<string>"}