--- title: "Retrieve UniswapX limit orders" method: GET path: "/limit-orders" tags: ["Limit Orders"] --- # Retrieve UniswapX limit orders `GET /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). ## Query parameters - `limit` number - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds' - `orderHash` string - `orderHashes` string - `swapper` string - `filler` string - `executeAddress` string - `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. - `pair` string - `sortKey` 'createdAt' - `sort` string - `desc` boolean - `cursor` string - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111 — Chains supported by UniswapX. ## Response `200` Request Successful - GetOrdersResponse - `orders` union[] - union - DutchOrderEntity — Dutch V1 and Limit orders. Legacy DutchLimit entries share this shape. - `type` 'Dutch' | 'DutchLimit' | 'Limit' - `encodedOrder` string — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string — EIP-712 signature over the order. - `nonce` string — Permit2 nonce, uint256 encoded as a base-10 string. - `orderHash` string - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds' - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111 — Chains supported by UniswapX. - `swapper` string — EIP-55 checksummed Ethereum address. - `input` OrderInput - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string — uint256 encoded as a base-10 string. - `endAmount` string — uint256 encoded as a base-10 string. - `outputs` OrderOutput[] - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string, required — uint256 encoded as a base-10 string. - `endAmount` string, required — uint256 encoded as a base-10 string. - `recipient` string, required — EIP-55 checksummed Ethereum address. - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `quoteId` string, uuid — Defined when the order has a quote associated with it. - `requestId` string, uuid — Defined when the order has a quote request associated with it. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - DutchV2OrderEntity — Dutch V2 orders: cosigned Dutch auctions with time-based decay. - `type` 'Dutch_V2', required - `encodedOrder` string, required — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string, required — EIP-712 signature over the order. - `nonce` string — Permit2 nonce, uint256 encoded as a base-10 string. - `orderHash` string, required - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds', required - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111, required — Chains supported by UniswapX. - `swapper` string, required — EIP-55 checksummed Ethereum address. - `input` object - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string, required — uint256 encoded as a base-10 string. - `endAmount` string, required — uint256 encoded as a base-10 string. - `outputs` OrderOutput[] - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string, required — uint256 encoded as a base-10 string. - `endAmount` string, required — uint256 encoded as a base-10 string. - `recipient` string, required — EIP-55 checksummed Ethereum address. - `cosignerData` object - `decayStartTime` number - `decayEndTime` number - `exclusiveFiller` string — EIP-55 checksummed Ethereum address. - `inputOverride` string — uint256 encoded as a base-10 string. - `outputOverrides` Amount[] - `cosignature` string - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `quoteId` string, uuid — Defined when the order has a quote associated with it. - `requestId` string, uuid — Defined when the order has a quote request associated with it. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - `route` Route — Classic-route quote metadata associated with the order's quote. - `quote` string — uint256 encoded as a base-10 string. - `quoteGasAdjusted` string — uint256 encoded as a base-10 string. - `gasPriceWei` string — uint256 encoded as a base-10 string. - `gasUseEstimateQuote` string — uint256 encoded as a base-10 string. - `gasUseEstimate` string — uint256 encoded as a base-10 string. - `methodParameters` object - `calldata` string - `value` string - `to` string — EIP-55 checksummed Ethereum address. - DutchV3OrderEntity — Dutch V3 orders: cosigned Dutch auctions with block-based nonlinear decay, used on fast chains. - `type` 'Dutch_V3', required - `encodedOrder` string, required — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string, required — EIP-712 signature over the order. - `nonce` string — Permit2 nonce, uint256 encoded as a base-10 string. - `orderHash` string, required - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds', required - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111, required — Chains supported by UniswapX. - `swapper` string, required — EIP-55 checksummed Ethereum address. - `startingBaseFee` string — uint256 encoded as a base-10 string. - `input` object - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string, required — uint256 encoded as a base-10 string. - `curve` NonlinearDutchDecayCurve — Piecewise decay curve relative to the decay start block. - `relativeBlocks` number[] - `relativeAmounts` string[] - `maxAmount` string — uint256 encoded as a base-10 string. - `adjustmentPerGweiBaseFee` string — uint256 encoded as a base-10 string. - `outputs` object[] - `token` string, required — EIP-55 checksummed Ethereum address. - `startAmount` string, required — uint256 encoded as a base-10 string. - `curve` NonlinearDutchDecayCurve — Piecewise decay curve relative to the decay start block. - `relativeBlocks` number[] - `relativeAmounts` string[] - `recipient` string, required — EIP-55 checksummed Ethereum address. - `minAmount` string — uint256 encoded as a base-10 string. - `adjustmentPerGweiBaseFee` string — uint256 encoded as a base-10 string. - `cosignerData` object - `decayStartBlock` number - `exclusiveFiller` string — EIP-55 checksummed Ethereum address. - `inputOverride` string — uint256 encoded as a base-10 string. - `outputOverrides` Amount[] - `cosignature` string - `fillBlock` number — Block in which the order was filled. Defined once the fill has been recorded. - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `quoteId` string, uuid — Defined when the order has a quote associated with it. - `requestId` string, uuid — Defined when the order has a quote request associated with it. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - `route` Route — Classic-route quote metadata associated with the order's quote. - `quote` string — uint256 encoded as a base-10 string. - `quoteGasAdjusted` string — uint256 encoded as a base-10 string. - `gasPriceWei` string — uint256 encoded as a base-10 string. - `gasUseEstimateQuote` string — uint256 encoded as a base-10 string. - `gasUseEstimate` string — uint256 encoded as a base-10 string. - `methodParameters` object - `calldata` string - `value` string - `to` string — EIP-55 checksummed Ethereum address. - PriorityOrderEntity — Priority orders: amounts scale with the transaction's priority fee. - `type` 'Priority', required - `encodedOrder` string, required — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string, required — EIP-712 signature over the order. - `nonce` string — Permit2 nonce, uint256 encoded as a base-10 string. - `orderHash` string, required - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds', required - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111, required — Chains supported by UniswapX. - `swapper` string, required — EIP-55 checksummed Ethereum address. - `auctionStartBlock` number - `baselinePriorityFeeWei` string — uint256 encoded as a base-10 string. - `input` object - `token` string, required — EIP-55 checksummed Ethereum address. - `amount` string, required — uint256 encoded as a base-10 string. - `mpsPerPriorityFeeWei` string, required — uint256 encoded as a base-10 string. - `outputs` object[] - `token` string, required — EIP-55 checksummed Ethereum address. - `amount` string, required — uint256 encoded as a base-10 string. - `mpsPerPriorityFeeWei` string, required — uint256 encoded as a base-10 string. - `recipient` string, required — EIP-55 checksummed Ethereum address. - `cosignerData` object - `auctionTargetBlock` number - `cosignature` string - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `quoteId` string, uuid — Defined when the order has a quote associated with it. - `requestId` string, uuid — Defined when the order has a quote request associated with it. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - `route` Route — Classic-route quote metadata associated with the order's quote. - `quote` string — uint256 encoded as a base-10 string. - `quoteGasAdjusted` string — uint256 encoded as a base-10 string. - `gasPriceWei` string — uint256 encoded as a base-10 string. - `gasUseEstimateQuote` string — uint256 encoded as a base-10 string. - `gasUseEstimate` string — uint256 encoded as a base-10 string. - `methodParameters` object - `calldata` string - `value` string - `to` string — EIP-55 checksummed Ethereum address. - HybridOrderEntity — Hybrid orders: support Dutch auction (price curve) or priority fee scaling mechanics, mutually exclusively. - `type` 'Hybrid', required - `encodedOrder` string, required — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string, required — EIP-712 signature over the order. - `nonce` string — Permit2 nonce, uint256 encoded as a base-10 string. - `orderHash` string, required - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds', required - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111, required — Chains supported by UniswapX. - `swapper` string, required — EIP-55 checksummed Ethereum address. - `auctionStartBlock` number - `baselinePriorityFee` string — uint256 encoded as a base-10 string. - `scalingFactor` string — uint256 encoded as a base-10 string. - `priceCurve` Amount[] — 1e18-denominated multipliers; all elements are on the same side of 1e18. Empty for priority-style hybrid orders. - `input` object - `token` string, required — EIP-55 checksummed Ethereum address. - `maxAmount` string, required — uint256 encoded as a base-10 string. - `outputs` object[] - `token` string, required — EIP-55 checksummed Ethereum address. - `minAmount` string, required — uint256 encoded as a base-10 string. - `recipient` string, required — EIP-55 checksummed Ethereum address. - `cosigner` string — EIP-55 checksummed Ethereum address. - `cosignerData` object - `auctionTargetBlock` number - `supplementalPriceCurve` Amount[] - `cosignature` string - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `quoteId` string, uuid — Defined when the order has a quote associated with it. - `requestId` string, uuid — Defined when the order has a quote request associated with it. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - `route` Route — Classic-route quote metadata associated with the order's quote. - `quote` string — uint256 encoded as a base-10 string. - `quoteGasAdjusted` string — uint256 encoded as a base-10 string. - `gasPriceWei` string — uint256 encoded as a base-10 string. - `gasUseEstimateQuote` string — uint256 encoded as a base-10 string. - `gasUseEstimate` string — uint256 encoded as a base-10 string. - `methodParameters` object - `calldata` string - `value` string - `to` string — EIP-55 checksummed Ethereum address. - RelayOrderEntity — Relay orders: gasless transaction relays paid via a decaying relay fee. - `type` 'Relay', required - `encodedOrder` string, required — ABI-encoded order struct. Decode with the uniswapx-sdk parser for the order's type. - `signature` string, required — EIP-712 signature over the order. - `orderHash` string, required - `orderStatus` 'open' | 'expired' | 'error' | 'cancelled' | 'filled' | 'insufficient-funds', required - `chainId` 1 | 10 | 56 | 130 | 137 | 143 | 196 | 480 | 1301 | 1868 | 4217 | 4663 | 5042 | 8453 | 42161 | 42220 | 43114 | 81457 | 7777777 | 11155111, required — Chains supported by UniswapX. - `swapper` string, required — EIP-55 checksummed Ethereum address. - `input` object - `token` string — EIP-55 checksummed Ethereum address. - `amount` string — uint256 encoded as a base-10 string. - `recipient` string — EIP-55 checksummed Ethereum address. - `relayFee` object - `token` string — EIP-55 checksummed Ethereum address. - `startAmount` string — uint256 encoded as a base-10 string. - `endAmount` string — uint256 encoded as a base-10 string. - `startTime` number - `endTime` number - `createdAt` number — Unix timestamp (seconds) at which the order was recorded. - `txHash` string — Transaction hash of the fill. Defined once the order has been filled. - `settledAmounts` SettledAmount[] - `tokenOut` string - `amountOut` string — uint256 encoded as a base-10 string. - `tokenIn` string - `amountIn` string — uint256 encoded as a base-10 string. - `cursor` string — Defined when the results are paginated. Pass back via the cursor query parameter to fetch the next page. ## Other responses - `400` — Invalid query parameters. - `429` — Rate limited. - `500` — Internal error. --- [API](https://skmtc.net/uniswap/apis/uniswapx.md) · [All operations](https://skmtc.net/uniswap/apis/uniswapx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uniswap/uniswapx/versions/779f0318f451/schema)