Sign in
Limit Orders

Retrieve UniswapX limit orders

Changed on

Retrieve limit orders filtered by query parameter(s). Query semantics match /orders, and this endpoint additionally pages with cursor and accepts sortKey, sort and desc: orderHashes cannot be combined with sortKey, and sortKey is required whenever sort or desc is provided. Limit orders are returned with the Dutch order shape without decay (input and output startAmount equals endAmount).

get/limit-orders

Request

  • Base URL: https://api.uniswap.org/v2
  • URL: https://api.uniswap.org/v2/limit-orders
  • Auth: none declared

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.

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

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 | 57073 | 81457 | 7777777 | 11155111

Chains supported by UniswapX.

Example:1

Filter by chain id. Cannot be combined with swapper.

Response

Request Successful

cursorstring

GET /limit-orders only. 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"
        }
      ]
    }
  ]
}

Changes

  • 367862f7590bRevision changes
    • ●

      deleted the query request parameter executeAddress

    • ●

      removed the optional property ////// from the response with the status

    • ●

      removed the optional property ////// from the response with the status

    • ●

      removed the optional property ////// from the response with the status

  • 2c6d3f46b411Revision changes
    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status