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.
Query parameters
Maximum number of orders to return.
Filter by order status. A comma-separated list of statuses is also accepted.
Filter by order hash.
Filter by comma-separated order hashes (maximum 50). Cannot be combined with sortKey.
Filter by swapper address. Cannot be combined with chainId.
Filter by filler address.
Filter by execution address.
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.
Filter by token pair, formatted as <tokenAddress>-<tokenAddress>-<chainId>.
Order the query results by the sort key. Required when sort or desc is provided.
Sort query. For example: sort=gt(UNIX_TIMESTAMP), sort=between(1675872827, 1675872930), or lt(1675872930).
Boolean to sort query results by descending sort key.
Cursor param to page through results. This will be returned in the previous query if the results have been paginated.
Chains supported by UniswapX.
Filter by chain id. Cannot be combined with swapper.
Response
Request Successful
Example response
{
"orders": [
{
"chainId": 1,
"swapper": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3",
"input": {
"token": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3"
},
"outputs": [
{
"token": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3",
"recipient": "0x50EC05ADe8280758E2077fcBC08D878D4aef79C3"
}
]
}
]
}