Sign in

v17

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0122836.0 KB
Orders

Retrieve UniswapX orders

Retrieve orders filtered by query parameter(s). At least one of orderHash, orderHashes, chainId, orderStatus, swapper, filler, or pair must be provided. Not supported in combination: swapper with chainId; orderHashes with sortKey. sortKey is required whenever sort or desc is provided. The shape of each entry in orders depends on the order's type; filter with orderType to receive a single shape.

get/orders

Query parameters

limitnumber

Maximum number of orders to return.

orderStatus'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds'

Filter by order status. A comma-separated list of statuses is also accepted.

orderHashstring

Filter by order hash.

orderHashesstring
Example:orderHash,orderHash,orderHash

Filter by comma-separated order hashes (maximum 50). Cannot be combined with sortKey.

swapperstring
Example:0x50EC05ADe8280758E2077fcBC08D878D4aef79C3

Filter by swapper address. Cannot be combined with chainId.

fillerstring
Example:0x50EC05ADe8280758E2077fcBC08D878D4aef79C3

Filter by filler address.

executeAddressstring
Example:0x50EC05ADe8280758E2077fcBC08D878D4aef79C3

Filter by execution address.

orderType'Dutch' | 'Dutch_V2' | 'Dutch_V3' | 'Limit' | 'Relay' | 'Dutch_V1_V2' | 'Priority' | 'Hybrid'

Order type accepted by the orderType query parameter. Dutch_V1_V2 returns both Dutch V1 and Dutch V2 orders.

Filter by order type. Determines the entity shape of the returned orders.

pairstring

Filter by token pair, formatted as <tokenAddress>-<tokenAddress>-<chainId>.

sortKey'createdAt'

Order the query results by the sort key. Required when sort or desc is provided.

sortstring

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

descboolean

Boolean to sort query results by descending sort key.

cursorstring

Cursor param to page through results. This will be returned in the previous query if the results have been paginated.

chainId1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111

Chains supported by UniswapX.

Example:1

Filter by chain id. Cannot be combined with swapper.

Response

Request Successful

cursorstring

Defined when the results are paginated. Pass back via the cursor query parameter to fetch the next page.

Example response

{
  "orders": [
    {
      "chainId": 1,
      "swapper": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3",
      "input": {
        "token": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3"
      },
      "outputs": [
        {
          "token": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3",
          "recipient": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3"
        }
      ]
    }
  ]
}