How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Uniswap Order API

The Order API from Uniswap — 2 operation(s) for order.

Uniswap Order 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 Order. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 61 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.

2 operations 2 paths 61 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Server
https://trade-api.gateway.uniswap.org/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Uniswap Order API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (apiKey). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Order 2
POST
/order
Create a gasless order
post_order 1 param body → 201400401429500503504
GET
/orders
Get gasless orders
get_order 10 params → 200400404429500503504

Schemas 61

The contract defines 61 schemas that model the data the API accepts and returns. The most detailed are UniswapXOrder (15 properties), PriorityQuote (13 properties), DutchQuoteV3 (13 properties), PriorityOrderInfo (12 properties). Each schema is shown below with its type and property counts.

PriorityInput
object
3 properties 3 required
RequestId
string
A unique ID for the request.
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.
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.
SortKey
string
quoteId
string
A unique ID for the quote.
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…
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).
SettledAmount
object
4 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…
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).
Err500
object
2 properties
OrderInput
object
3 properties 1 required
OrderOutput
object
5 properties 1 required
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
DutchQuoteV2
object
11 properties 3 required
UniswapXOrder
object
15 properties 7 required
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.
OrderRequest
object
3 properties 2 required
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
OrderResponse
object
3 properties 3 required
DutchOutputV3
object
6 properties 6 required
DutchOutput
object
4 properties 4 required
additionalValidationData
string
Unused and deprecated.
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.
OrderType
string
OrderTypeQuery
string
ChainId
number
The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
portionAmountReceiverAddress
string
The wallet address which will receive the fee.
Curve
object
2 properties 1 required
DutchOrderInfoV3
object
11 properties 13 required
GetOrdersResponse
object
3 properties 2 required
Err400
object
2 properties
DutchInput
object
3 properties 3 required
endAmount
string
The worst case quantity of tokens resulting from this swap.
CosignerData
object
5 properties
OrderStatus
string
The status of the order. Note that all of these are final states with the exception of Open, meaning that no further state changes will occur. Open - order is…
TransactionHash
string
The unique hash of the transaction.
Err503
object
2 properties
OrderIds
string
Address
string
PriorityOrderInfo
object
12 properties 12 required
Err504
object
2 properties
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…
additionalValidationContract
string
Unused and deprecated.
DutchOrderInfoV2
object
10 properties 13 required
startAmount
string
The intended execution quantity of tokens resulting from this swap.
DutchInputV3
object
5 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

uniswap-order-api-openapi.yml Raw ↑

Other APIs Uniswap publishes across the network.

Uniswap Subgraph API
UniswapX API
Uniswap Approval API
Uniswap LimitOrderQuote API
Uniswap Liquidity API
Uniswap Plan API
Uniswap Quote API
Uniswap Send API
Uniswap Swap API
Uniswap SwappableTokens API
Uniswap Wallet API
Uniswap WalletCheckDelegation API
Where this information came from

This is an independent, third-party profile of Uniswap Order API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.