Skip to main content
POST
/
order
Create a gasless order
curl --request POST \
  --url https://trade-api.gateway.uniswap.org/v1/order \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "signature": "<string>",
  "quote": {
    "encodedOrder": "<string>",
    "orderId": "<string>",
    "orderInfo": {
      "chainId": 1,
      "nonce": "<string>",
      "reactor": "<string>",
      "swapper": "<string>",
      "deadline": 123,
      "exclusiveFiller": "<string>",
      "exclusivityOverrideBps": "<string>",
      "input": {
        "startAmount": "<string>",
        "endAmount": "<string>",
        "token": "<string>"
      },
      "outputs": [
        {
          "startAmount": "<string>",
          "endAmount": "<string>",
          "token": "<string>",
          "recipient": "<string>"
        }
      ],
      "additionalValidationContract": "0x0000000000000000000000000000000000000000",
      "additionalValidationData": "0x",
      "decayStartTime": 123,
      "decayEndTime": 123
    },
    "portionBips": 123,
    "portionAmount": "<string>",
    "portionRecipient": "<string>",
    "quoteId": "<string>",
    "slippageTolerance": 123,
    "classicGasUseEstimateUSD": "<string>",
    "aggregatedOutputs": [
      {
        "token": "<string>",
        "amount": "<string>",
        "recipient": "<string>",
        "bps": 123,
        "minAmount": "<string>"
      }
    ]
  },
  "routing": "DUTCH_LIMIT"
}
'
{
  "requestId": "<string>",
  "orderId": "<string>",
  "orderStatus": "open"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
signature
string
required

The signed permit.

​
quote
object
required
​
routing
enum<string>

The routing for the proposed transaction.

Available options:
DUTCH_LIMIT,
CLASSIC,
DUTCH_V2,
DUTCH_V3,
BRIDGE,
LIMIT_ORDER,
PRIORITY,
WRAP,
UNWRAP,
CHAINED

Response

Encoded order submitted.

​
requestId
string
required

A unique ID for the request.

​
orderId
string
required

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

​
orderStatus
enum<string>
required

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.

Available options:
open,
expired,
error,
cancelled,
filled,
unverified,
insufficient-funds