Uniswap Liquidity 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 Liquidity. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.
This API exposes
7 operations
across 7 paths,
and defines 53 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.
7 operations7 paths53 schemas7 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 Liquidity 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 7
Across 7 paths, the API surfaces 7 operations — 7 POST. Each is listed below with its method, path, parameters, and response codes.
The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are PoolInformation (17 properties), CreatePositionRequest (16 properties), IncreasePositionRequest (13 properties), DecreasePositionRequest (12 properties). Each schema is shown below with its type and property counts.
PoolReferenceByProtocol
object
3 properties3 required
CreateToken
object
A token address and amount used in position creation.
2 properties2 required
GasUrgency
string
The urgency level for gas price estimation. Higher urgency results in higher gas price and faster transaction inclusion. Defaults to URGENT if not provided.
gasPrice
string
The cost per unit of gas.
CreatePositionResponse
object
9 properties8 required
V2PoolParameters
object
Parameters identifying a V2 pool.
3 properties3 required
lpTickCurrent
number
The current tick of the pool. For more information see the [Uniswap V3 Whitepaper](https://app.uniswap.org/whitepaper-v3.pdf).
DecreasePositionResponse
object
5 properties4 required
NullablePermit
objectnull
the permit2 message object for the customer to sign to permit spending by the permit2 contract.
3 properties
ClaimFeesResponse
object
5 properties4 required
LPAction
string
The LP operation that the approval is needed for.
Err429
object
2 properties
PoolInformation
object
17 properties
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…
ClaimFeesRequest
object
6 properties4 required
receiverWalletAddress
string
The wallet address which will receive the token.
CreatePoolParameters
object
Parameters for creating a new pool along with a position.
6 properties5 required
PositionTickBounds
object
Tick bounds for a concentrated liquidity position.
2 properties2 required
ChainId
number
The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
Err401
object
2 properties
Address
string
maxPriorityFeePerGas
string
The maximum tip to the block builder. Adjusted based upon the urgency specified in the request.
PoolInfoResponse
object
4 properties
senderWalletAddress
string
The wallet address which will be used to send the token.
LPToken
object
A token with its address and amount, used in LP operations.
2 properties2 required
gasFee
string
The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) in the base unit of the chain.
DecreasePositionRequest
object
12 properties6 required
LPApprovalResponse
object
4 properties1 required
ApprovalTransactionRequest
object
An approval transaction with metadata about whether it is a cancellation and which LP action it supports.
4 properties3 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…
Err400
object
2 properties
PoolInfoRequest
object
6 properties1 required
LPApprovalRequest
object
10 properties5 required
CreatePositionExistingPoolParameters
object
Parameters for creating a position in an existing pool.
3 properties3 required
ProtocolItems
string
The protocol to use for the swap/order.
poolFee
string
The fee of the pool in basis points.
gasLimit
string
The maximum units of gas that will be consumed by this transaction.
IncreasePositionRequest
object
13 properties6 required
PositionPriceBounds
object
Price bounds for a concentrated liquidity position.
2 properties2 required
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…
Err500
object
2 properties
CreatePositionRequest
object
16 properties4 required
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).
CreateClassicPositionRequest
object
Request to create a full-range V2 liquidity position.
9 properties3 required
CreateClassicPositionResponse
object
5 properties4 required
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:…
TransactionRequest
object
9 properties5 required
RequestId
string
A unique ID for the request.
Err404
object
2 properties
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.
PoolParameters
object
5 properties
IncreasePositionResponse
object
5 properties4 required
Err504
object
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Uniswap Liquidity 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.
