Sign in
Orders

Retrieve UniswapX orders

Changed on

Retrieve orders filtered by query parameter(s). At least one of orderHash, orderHashes, chainId, orderStatus, swapper, filler, or pair must be provided. swapper cannot be combined with chainId. Results are a single page of the newest orders (createdAt descending, at most 50); there is no pagination or alternative ordering: sortKey=createdAt, sort=gt(0) and desc=true are accepted and ignored, any other value or any cursor returns 400. To enumerate limit orders beyond one page use /limit-orders. The shape of each entry in orders depends on the order's type; filter with orderType to receive a single shape.

get/orders

Request

  • Base URL: https://api.uniswap.org/v2
  • URL: https://api.uniswap.org/v2/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>.

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