Uniswap Quote API is one of 14 APIs that Uniswap publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 6 JSON Schema definitions.
Tagged areas include Quotes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.
This API exposes
1 operation
across 1 path,
and defines 101 schemas.
It is described by OpenAPI 3.0.0, at version 1.0.0.
Requests are made against a single base URL, https://trade-api.gateway.uniswap.org/v1.
The identity and technical contract details declared by the specification.
PriorityInput
object
3 properties
3 required
DutchQuote
object
10 properties
3 required
TruncatedPlanStep
object
A truncated representation of a plan step containing only routing information.
6 properties
1 required
ClassicInput
object
2 properties
RequestId
string
A unique ID for the request.
gasFee
string
The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) in the base unit of the chain.
AggregatedOutput
object
An array of all outputs of the proposed transaction. This includes the swap as well as any fees collected by the API integrator. This does not include pool fee…
5 properties
portionBips
number
The portion of the swap that will be taken as a fee stated in basis points. Fractional basis points are supported with up to two decimal places (e.g. 87.5 for…
PriorityOutput
object
4 properties
4 required
Routing
string
The routing for the proposed transaction.
WalletExecutionContext
object
Wallet execution context based on CAIP-25 Standard. Provides information about wallet capabilities and scopes.
2 properties
1 required
sqrtRatioX96
string
The square root of the ratio of the token0 and token1 in the pool, as a Q64.64 number. For more information see the [Uniswap V3 Whitepaper](https://app.uniswap…
tokenSymbol
string
The symbol of the token.
nonce
string
A unique nonce for this order.
receiverWalletAddress
string
The wallet address which will receive the token.
Err401
object
2 properties
contractAddress
string
The address of a contract which will be used to facilitate the swap.
WrapUnwrapQuote
object
12 properties
quoteId
string
A unique ID for the quote.
outputToken
string
The token which will be received, specified by its token address. For a list of supported tokens, see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
cosignerAddress
string
The address of a cosigner who will run the auction and ensure the best executable price within the given parameters. Currently the cosigner is always Uniswap L…
maxPriorityFeePerGas
string
The maximum tip to the block builder. Adjusted based upon the urgency specified in the request.
ClientContext
object
Uni client-specific context describing how this wallet integrates with the application.
2 properties
tokenAmount
string
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…
NullablePermit
object
the permit2 message object for the customer to sign to permit spending by the permit2 contract.
3 properties
orderId
string
A unique ID for the order. Used to track the order's status.
deadline
number
The unix timestamp at which the order will be reverted if not filled.
bps
number
The portion of the swap stated in basis points. Fractional basis points are supported with up to two decimal places (e.g. 12.5).
generatePermitAsTransaction
boolean
Indicates whether you want to receive a permit2 transaction to sign and submit onchain, or a permit message to sign. When set to true, the quote response retur…
Err500
object
2 properties
ProtocolItems
string
The protocol to use for the swap/order.
liquidity
string
The amount of liquidity in the pool at a given tick. For more information see the [Uniswap V3 Whitepaper](https://app.uniswap.org/whitepaper-v3.pdf).
inputToken
string
The token which will be sent, specified by its token address. For a list of supported tokens, see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
Err404
object
2 properties
V4PoolInRoute
object
12 properties
10 required
DutchQuoteV2
object
11 properties
3 required
TradeType
string
The handling of the amount field. EXACTINPUT means the requester will send the specified amount of input tokens and get a quote with a variable quantity of out…
ClassicQuote
object
23 properties
TransactionFailureReason
string
WalletInfo
object
Information about the wallet.
3 properties
portionAmount
string
The portion of the swap that will be taken as a fee in the base units of the token. The fee will be taken from the output token.
RoutingPreference
string
The routingPreference specifies the preferred strategy to determine the quote. If the routingPreference is BESTPRICE, then the quote will propose a route throu…
gasFeeUSD
string
The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) denominated in USDC.
minAmount
string
The minimum portion of the swap, stated in the base unit of the token, which will be output to the recipient.
ClassicGasUseEstimateUSD
string
The gas fee you would pay if you opted for a CLASSIC swap over a Uniswap X order in terms of USD.
Err429
object
2 properties
DutchOutputV3
object
6 properties
6 required
bpsFee
string
A fee charged by the token specified in basis points. Field is not present if the token does not charge a fee.
DutchOutput
object
4 properties
4 required
additionalValidationData
string
Unused and deprecated.
tickCurrent
string
The current tick of the pool. For more information see the [Uniswap V3 Whitepaper](https://app.uniswap.org/whitepaper-v3.pdf).
PriorityQuote
object
13 properties
3 required
encodedOrder
string
An encoded copy of the order details which will be submitted to the filler network along with the signed permit.
tickSpacing
number
The width of ticks in this pool (e.g. the price range between two ticks) specified in basis points. For more information see the [Uniswap V3 Whitepaper](https:…
ChainId
number
The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
IntegratorFee
object
A fee configuration specifying the fee amount in basis points and the recipient address.
2 properties
2 required
AutoSlippage
string
The auto slippage strategy to employ. For Uniswap Protocols (v2, v3, v4) the auto slippage will be automatically calculated when this field is set to DEFAULT.…
Curve
object
2 properties
1 required
gasFeeInCurrency
string
The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) in the quoted currency (e.g. output token) in the base units of the…
TokenInRoute
object
6 properties
QuoteRequest
object
18 properties
7 required
BridgeQuote
object
21 properties
DutchOrderInfoV3
object
11 properties
13 required
V2PoolInRoute
object
8 properties
WalletProperties
object
Properties describing the wallet.
1 property
Err400
object
2 properties
DutchInput
object
3 properties
3 required
SpreadOptimization
string
For UniswapX swaps, when set to EXECUTION, quotes optimize for looser spreads at higher fill rates. When set to PRICE, quotes optimize for tighter spreads at l…
endAmount
string
The worst case quantity of tokens resulting from this swap.
GasStrategy
object
Gas strategy configuration for transaction fee estimation.
9 properties
3 required
gasPrice
string
The cost per unit of gas.
V3PoolInRoute
object
10 properties
QuoteResponse
object
7 properties
4 required
PermitAmount
string
For Uniswap Protocols (v2, v3, v4) swaps, specify the input token spend allowance (e.g. quantity) to be set in the permit. FULL can be used to specify an unlim…
Protocols
array
The protocols to use for the swap/order. If the protocols field is defined, then you can only set the routingPreference to BESTPRICE. Note that the value UNISW…
V2Reserve
object
The remaining reserve of this token in the pool.
2 properties
ClassicOutput
object
3 properties
HooksOptions
string
The hook options to use for V4 pool quotes. V4HOOKSINCLUSIVE will get quotes for V4 pools with or without hooks. V4HOOKSONLY will only get quotes for V4 pools…
senderWalletAddress
string
The wallet address which will be used to send the token.
DutchInputV3
object
5 properties
5 required
poolFee
string
The fee of the pool in basis points.
PriorityOrderInfo
object
12 properties
12 required
Err504
object
2 properties
ScopeData
object
Data defining a wallet scope including accounts, methods, capabilities, chains, and client context.
5 properties
2 required
PlanStepType
string
The type of step in a plan, including swap types and approval types.
TransactionRequest
object
9 properties
5 required
DutchQuoteV3
object
13 properties
3 required
slippageTolerance
number
The slippage tolerance as a percentage up to a maximum of two decimal places. For Uniswap Protocols (v2, v3, v4), the slippage tolerance is the maximum amount…
UniversalRouterVersion
string
additionalValidationContract
string
Unused and deprecated.
maxFeePerGas
string
The sum of the base fee and priority fee. Subtracting maxPriorityFeePerGas from this value will yield the base fee to be paid for this transaction.
gasLimit
string
The maximum units of gas that will be consumed by this transaction.
DutchOrderInfoV2
object
10 properties
13 required
SponsorSummary
object
Display information about the sponsor covering gas fees for the swap.
2 properties
SponsorshipInfo
object
Gas sponsorship information for the quoted swap. When sponsored is true, gas fees for executing this swap will be covered by the sponsor. When sponsored is fal…
3 properties
startAmount
string
The intended execution quantity of tokens resulting from this swap.
Urgency
string
The urgency impacts the estimated gas price of the transaction. The higher the urgency, the higher the gas price, and the faster the transaction is likely to b…
DutchOrderInfo
object
13 properties
13 required
ChainedQuote
object
A quote for a chained transaction flow that spans multiple steps, potentially across multiple chains.
22 properties
8 required
portionAmountReceiverAddress
string
The wallet address which will receive the fee.
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Uniswap publishes across the network.
