Sign in

v17

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

Retrieve UniswapX limit orders

Retrieve limit orders filtered by query parameter(s). Query semantics are identical to /orders. Limit orders are returned with the Dutch order shape without decay (input and output startAmount equals endAmount).

get/limit-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"
        }
      ]
    }
  ]
}