Swapping Endpoints

Quote

Requests a quote according to the specified swap parameters. This endpoint may be used to get a quote for a swap, a bridge, or a wrap/unwrap. The resulting response includes a quote for the swap and the proposed route by which the quote was achieved. The response will also include estimated gas fees for the proposed quote route. If the proposed route is via a Uniswap Protocol pool, the response may include a permit2 message for the swapper to sign prior to making a /swap request. The proposed route will also be simulated. If the simulation fails, the response will include an error message or txFailureReason.

Certain routing options may be whitelisted by the requestor through the use of the protocols field. Further, the requestor may ask for the best price route or for the fastest price route through the ‘routingPreference’ field. Note that the fastest price route refers to the speed with which a quote is returned, not the number of transactions that may be required to get from the input token and chain to the output token and chain. Further note that all routingPreference values except for FASTEST and BEST_PRICE are deprecated. For more information on the protocols and routingPreference fields, see the Token Trading Workflow explanation of Swap Routing.

API integrators using this API for the benefit of customer end users may request a service fee be taken from the output token and deposited to a fee collection address. To request this, please reach out to your Uniswap Labs contact. This optional fee is associated to the API key and is always taken from the output token. Note if there is a fee and the type is EXACT_INPUT, the output amount quoted will not include the fee subtraction. If there is a fee and the type is EXACT_OUTPUT, the input amount quoted will not include the fee addition. Instead, in both cases, the fee will be recorded in the portionBips and portionAmount fields.

POST

quote

Get a quote

curl --request POST \
  --url https://trade-api.gateway.uniswap.org/v1/quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "type": "EXACT_INPUT",
  "amount": "<string>",
  "tokenInChainId": 1,
  "tokenOutChainId": 1,
  "tokenIn": "<string>",
  "tokenOut": "<string>",
  "generatePermitAsTransaction": false,
  "swapper": "<string>",
  "slippageTolerance": 123,
  "autoSlippage": "DEFAULT",
  "routingPreference": "BEST_PRICE",
  "protocols": [
    "V2"
  ],
  "hooksOptions": "V4_HOOKS_INCLUSIVE",
  "spreadOptimization": "EXECUTION",
  "urgency": "urgent",
  "permitAmount": "FULL"
}'

{
  "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": "DUTCH_LIMIT",
  "permitTransaction": {
    "to": "<string>",
    "from": "<string>",
    "data": "<string>",
    "value": "<string>",
    "gasLimit": "<string>",
    "chainId": 1,
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>",
    "gasPrice": "<string>"
  },
  "permitData": {
    "domain": {},
    "values": {},
    "types": {}
  },
  "permitGasFee": "<string>"
}

Authorizations

x-api-key

string

header

required

Headers

x-universal-router-version

enum<string>

default:2.0

Available options:

1.2,

2.0

Body

application/json

type

enum<string>

required

Available options:

EXACT_INPUT,

EXACT_OUTPUT

amount

string

required

tokenInChainId

enum<number>

required

Available options:

1,

10,

56,

130,

137,

324,

480,

1868,

8453,

10143,

42161,

42220,

43114,

81457,

7777777,

1301,

84532,

11155111,

143

tokenOutChainId

enum<number>

required

Available options:

1,

10,

56,

130,

137,

324,

480,

1868,

8453,

10143,

42161,

42220,

43114,

81457,

7777777,

1301,

84532,

11155111,

143

tokenIn

string

required

tokenOut

string

required

swapper

string

required

generatePermitAsTransaction

boolean

default:false

slippageTolerance

number

autoSlippage

enum<string>

default:DEFAULT

Available options:

DEFAULT

routingPreference

enum<string>

default:BEST_PRICE

Available options:

BEST_PRICE,

FASTEST,

CLASSIC,

UNISWAPX,

BEST_PRICE_V2,

UNISWAPX_V2,

V3_ONLY,

V2_ONLY

protocols

enum<string>[]

Show child attributes

hooksOptions

enum<string>

Available options:

V4_HOOKS_INCLUSIVE,

V4_HOOKS_ONLY,

V4_NO_HOOKS

spreadOptimization

enum<string>

default:EXECUTION

Available options:

EXECUTION,

PRICE

urgency

enum<string>

default:urgent

Available options:

normal,

fast,

urgent

permitAmount

enum<string>

default:FULL

Available options:

FULL,

EXACT

Response

requestId

string

required

quote

object

required

Option 1
Classic Quote
Wrap/Unwrap Quote
UniswapX V2 Quote
UniswapX V3 Quote
Bridge Quote
UniswapX Priority Quote
Chained Quote

Show child attributes

routing

enum<string>

required

Available options:

DUTCH_LIMIT,

CLASSIC,

DUTCH_V2,

DUTCH_V3,

BRIDGE,

LIMIT_ORDER,

PRIORITY,

WRAP,

UNWRAP,

CHAINED

permitData

object | null

required

Show child attributes

permitTransaction

object

Show child attributes

permitGasFee

string

Limit QuoteGet a quote for a limit order according to the provided configuration.

⌘I

Get a quote

curl --request POST \
  --url https://trade-api.gateway.uniswap.org/v1/quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "type": "EXACT_INPUT",
  "amount": "<string>",
  "tokenInChainId": 1,
  "tokenOutChainId": 1,
  "tokenIn": "<string>",
  "tokenOut": "<string>",
  "generatePermitAsTransaction": false,
  "swapper": "<string>",
  "slippageTolerance": 123,
  "autoSlippage": "DEFAULT",
  "routingPreference": "BEST_PRICE",
  "protocols": [
    "V2"
  ],
  "hooksOptions": "V4_HOOKS_INCLUSIVE",
  "spreadOptimization": "EXECUTION",
  "urgency": "urgent",
  "permitAmount": "FULL"
}'

{
  "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": "DUTCH_LIMIT",
  "permitTransaction": {
    "to": "<string>",
    "from": "<string>",
    "data": "<string>",
    "value": "<string>",
    "gasLimit": "<string>",
    "chainId": 1,
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>",
    "gasPrice": "<string>"
  },
  "permitData": {
    "domain": {},
    "values": {},
    "types": {}
  },
  "permitGasFee": "<string>"
}

Swapping Endpoints

Liquidity Provisioning Endpoints

Reference Data Endpoints

Utility Endpoints

Quote

Authorizations

Headers

Body

Response