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.2.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.2.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.

DutchOutput
object
4 properties 4 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…
Err429
object
2 properties
OrderOutput
object
5 properties 1 required
Err401
object
2 properties
contractAddress
string
The address of a contract which will be used to facilitate the swap.
OrderInput
object
3 properties 1 required
deadline
number
The unix timestamp at which the order will be reverted if not filled.
Err500
object
2 properties
OrderTypeQuery
string
PriorityOutput
object
4 properties 4 required
DutchOutputV3
object
6 properties 6 required
RequestId
string
A unique ID for the request.
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).
additionalValidationContract
string
Unused and deprecated.
OrderIds
string
TransactionHash
string
The unique hash of the transaction.
SettledAmount
object
4 properties
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).
Address
string
OrderRequest
object
3 properties 2 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.
OrderType
string
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).
DutchOrderInfoV2
object
10 properties 13 required
Err404
object
2 properties
DutchOrderInfoV3
object
11 properties 13 required
additionalValidationData
string
Unused and deprecated.
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…
UniswapXOrder
object
15 properties 7 required
startAmount
string
The intended execution quantity of tokens resulting from this swap.
Err503
object
2 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…
OrderResponse
object
3 properties 3 required
PriorityInput
object
3 properties 3 required
receiverWalletAddress
string
The wallet address which will receive the token.
ChainId
number
The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
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…
quoteId
string
A unique ID for the quote.
SortKey
string
DutchQuoteV2
object
11 properties 3 required
Err400
object
2 properties
endAmount
string
The worst case quantity of tokens resulting from this swap.
DutchInputV3
object
5 properties 5 required
minAmount
string
The minimum portion of the swap, stated in the base unit of the token, which will be output to the recipient.
encodedOrder
string
An encoded copy of the order details which will be submitted to the filler network along with the signed permit.
Curve
object
2 properties 1 required
PriorityOrderInfo
object
12 properties 12 required
portionAmountReceiverAddress
string
The wallet address which will receive the fee.
CosignerData
object
5 properties
PriorityQuote
object
13 properties 3 required
Routing
string
The routing for the proposed transaction.
DutchQuoteV3
object
13 properties 3 required
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
GetOrdersResponse
object
3 properties 2 required
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…
nonce
string
A unique nonce for this order.
orderId
string
A unique ID for the order. Used to track the order's status.
ClassicGasUseEstimateUSD
string
The gas fee you would pay if you opted for a CLASSIC swap over a Uniswap X order in terms of USD.
DutchInput
object
3 properties 3 required
Err504
object
2 properties

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.