Get gasless order status

Retrieve one or more gasless orders filtered, optionally filered by query param(s). The request must at minimum include one of the following parameters: orderId, orderIds, orderStatus, swapper, or filler.

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

Query Parameters

orderTypeenum

Dutch_V2Dutch_V3LimitPriority

The UniswapX order type to retrieve.

orderIdstring

A transaction hash for an order. orderId or orderIds must be provided, but not both.

orderIdsstring

A list of comma separated orderIds (transaction hashes). orderId or orderIds must be provided, but not both.

limitnumber

orderStatusenum

openexpirederrorcancelledfilledunverifiedinsufficient-funds

Filter by order status.

swapperstring

Filter by swapper address.

sortKeyenum

createdAt

Order the query results by the sort key.

sortstring

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

fillerstring

Filter by filler address.

cursorstring

Response

The request orders matching the query parameters.

requestIdstringrequired

A unique ID for the request.

ordersobject[]required

cursorstring

GET/orders

Request

curl --request GET \
  --url 'https://trade-api.gateway.uniswap.org/v1/orders' \
  --header 'x-api-key: <api-key>'

Response

200

{  "requestId": "<string>",  "orders": [    {      "type": "<string>",      "encodedOrder": "<string>",      "signature": "<string>",      "nonce": "<string>",      "orderStatus": "<string>",      "orderId": "<string>",      "chainId": "<number>",      "quoteId": "<string>",      "swapper": "<string>",      "txHash": "<string>",      "input": {        "token": "<string>",        "startAmount": "<string>",        "endAmount": "<string>"      },      "outputs": [        {          "token": "<string>",          "startAmount": "<string>",          "endAmount": "<string>",          "isFeeOutput": "<boolean>",          "recipient": "<string>"        }      ],      "settledAmounts": [        {          "tokenOut": "<string>",          "amountOut": "<string>",          "tokenIn": "<string>",          "amountIn": "<string>"        }      ],      "cosignature": "<string>",      "cosignerData": {        "decayStartTime": "<number>",        "decayEndTime": "<number>",        "exclusiveFiller": "<string>",        "inputOverride": "<string>",        "outputOverrides": [          "<string>"        ]      }    }  ],  "cursor": "<string>"}