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

Headers

x-agent-infostring

Optional attribution hint for AI-agent traffic; send it if an AI agent built or operates your integration. The value is a JSON object with up to three fields: decision_origin (required, exactly autonomous or human_mediated, case-sensitive), integration_name (optional string naming your integration, e.g. my-trading-bot), and version (optional string identifying your integration's version). Any other key is dropped, never rejected. The raw value must be at most 1024 bytes of printable US-ASCII (0x20-0x7E), so send non-ASCII text as JSON \u escapes; integration_name and version are each limited to 256 UTF-16 code units and may not contain control characters, U+2028, U+2029, or U+FFFD. Send the header once: repeated header lines are joined with , and the joined string is what gets parsed, so two complete objects fail as invalid JSON while a single object split across two lines still parses. The header is analytics-only and never affects the request: omitting it, sending it, or sending a value that fails these rules never changes the response status, body, or swap behavior. A value that fails to parse is dropped and reported by the x-agent-info-status response header. Never put a user ID, wallet address, email, session token, or API key in these fields.

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>"}