Skip to main content
POST
/
limit_order_quote
Get a limit order quote
curl --request POST \
  --url https://trade-api.gateway.uniswap.org/v1/limit_order_quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "swapper": "<string>",
  "limitPrice": "<string>",
  "amount": "<string>",
  "orderDeadline": 123,
  "type": "EXACT_INPUT",
  "tokenIn": "<string>",
  "tokenOut": "<string>",
  "tokenInChainId": 1,
  "tokenOutChainId": 1
}'
{
  "requestId": "<string>",
  "quote": {
    "encodedOrder": "<string>",
    "orderId": "<string>",
    "orderInfo": {
      "chainId": 1,
      "nonce": "<string>",
      "reactor": "<string>",
      "swapper": "<string>",
      "deadline": 123,
      "additionalValidationContract": "0x0000000000000000000000000000000000000000",
      "additionalValidationData": "0x",
      "decayStartTime": 123,
      "decayEndTime": 123,
      "exclusiveFiller": "<string>",
      "exclusivityOverrideBps": "<string>",
      "input": {
        "startAmount": "<string>",
        "endAmount": "<string>",
        "token": "<string>"
      },
      "outputs": [
        {
          "startAmount": "<string>",
          "endAmount": "<string>",
          "token": "<string>",
          "recipient": "<string>"
        }
      ]
    },
    "portionBips": 123,
    "portionAmount": "<string>",
    "portionRecipient": "<string>",
    "quoteId": "<string>",
    "slippageTolerance": 123,
    "classicGasUseEstimateUSD": "<string>",
    "aggregatedOutputs": [
      {
        "token": "<string>",
        "amount": "<string>",
        "recipient": "<string>",
        "bps": 123,
        "minAmount": "<string>"
      }
    ]
  },
  "routing": "LIMIT_ORDER",
  "permitData": {
    "domain": {},
    "values": {},
    "types": {}
  }
}

Authorizations

x-api-key
string
header
required

Body

application/json
swapper
string
required

The wallet address which will receive the token.

amount
string
required

The quantity of tokens denominated in the token's base units. (For example, for an ERC20 token one token is 1x10^18 base units. For one USDC token one token is 1x10^6 base units.) This value must be greater than 0.

type
enum<string>
required

The handling of the amount field. EXACT_INPUT means the requester will send the specified amount of input tokens and get a quote with a variable quantity of output tokens. EXACT_OUTPUT means the requester will receive the specified amount of output tokens and get a quote with a variable quantity of input tokens.

Available options:
EXACT_INPUT,
EXACT_OUTPUT
tokenIn
string
required

The token which will be sent, specified by its token address. For a list of supported tokens, see the FAQ.

tokenOut
string
required

The token which will be received, specified by its token address. For a list of supported tokens, see the FAQ.

tokenInChainId
enum<number>
required

The unique ID of the blockchain. For a list of supported chains see the FAQ.

Available options:
1,
10,
56,
130,
137,
324,
480,
1868,
8453,
10143,
42161,
42220,
43114,
81457,
7777777,
1301,
84532,
11155111
tokenOutChainId
enum<number>
required

The unique ID of the blockchain. For a list of supported chains see the FAQ.

Available options:
1,
10,
56,
130,
137,
324,
480,
1868,
8453,
10143,
42161,
42220,
43114,
81457,
7777777,
1301,
84532,
11155111
limitPrice
string
orderDeadline
number

Response

Limit Order Quote request successful.

requestId
string
required

A unique ID for the request.

quote
object
required
routing
enum<string>
required
Available options:
LIMIT_ORDER
permitData
object | null
required

the permit2 message object for the customer to sign to permit spending by the permit2 contract.

I