Skip to main content
GET
/
orders
Get gasless orders
curl --request GET \
  --url https://trade-api.gateway.uniswap.org/v1/orders \
  --header 'x-api-key: <api-key>'
{
  "requestId": "<string>",
  "orders": [
    {
      "type": "DutchLimit",
      "encodedOrder": "<string>",
      "signature": "<string>",
      "nonce": "<string>",
      "orderStatus": "open",
      "orderId": "<string>",
      "chainId": 1,
      "quoteId": "<string>",
      "swapper": "<string>",
      "txHash": "<string>",
      "input": {
        "token": "<string>",
        "startAmount": "<string>",
        "endAmount": "<string>"
      },
      "outputs": [
        {
          "token": "<string>",
          "startAmount": "<string>",
          "endAmount": "<string>",
          "isFeeOutput": true,
          "recipient": "<string>"
        }
      ],
      "settledAmounts": [
        {
          "tokenOut": "<string>",
          "amountOut": "<string>",
          "tokenIn": "<string>",
          "amountIn": "<string>"
        }
      ],
      "cosignature": "<string>",
      "cosignerData": {
        "decayStartTime": 123,
        "decayEndTime": 123,
        "exclusiveFiller": "<string>",
        "inputOverride": "<string>",
        "outputOverrides": [
          "<string>"
        ]
      }
    }
  ],
  "cursor": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
orderType
enum<string>

The default orderType is Dutch_V1_V2 and will grab both Dutch and Dutch_V2 orders.

Available options:
Dutch,
Dutch_V2,
Dutch_V1_V2,
Dutch_V3,
Limit,
Priority
​
orderId
string

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

​
orderIds
string

A list of comma separated orderIds.

​
limit
number
​
orderStatus
enum<string>

Filter by order status. 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
​
swapper
string

Filter by swapper address.

​
sortKey
enum<string>

Order the query results by the sort key.

Available options:
createdAt
​
sort
string

Sort query. For example: sort=gt(UNIX_TIMESTAMP), sort=between(1675872827, 1675872930), or lt(1675872930).

​
filler
string

Filter by filler address.

​
cursor
string

Response

The request orders matching the query parameters.

​
requestId
string
required

A unique ID for the request.

​
orders
object[]
required
​
cursor
string