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.0.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.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 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.
CreatePoolParameters
object
Parameters for creating a new pool along with a position.
6 properties5 required
CreatePositionResponse
object
9 properties8 required
lpTickCurrent
number
The current tick of the pool. For more information see the [Uniswap V3 Whitepaper](https://app.uniswap.org/whitepaper-v3.pdf).
PoolInformation
object
17 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…
CreateClassicPositionRequest
object
Request to create a full-range V2 liquidity position.
9 properties3 required
NullablePermit
object
the permit2 message object for the customer to sign to permit spending by the permit2 contract.
3 properties
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…
CreatePositionRequest
object
16 properties4 required
DecreasePositionRequest
object
12 properties6 required
PoolReferenceByProtocol
object
3 properties3 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:…
ChainId
number
The unique ID of the blockchain. For a list of supported chains see the [FAQ](https://api-docs.uniswap.org/guides/faqs).
LPApprovalRequest
object
10 properties5 required
PositionPriceBounds
object
Price bounds for a concentrated liquidity position.
2 properties2 required
LPToken
object
A token with its address and amount, used in LP operations.
2 properties2 required
Err500
object
2 properties
ClaimFeesRequest
object
6 properties4 required
LPAction
string
The LP operation that the approval is needed for.
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).
senderWalletAddress
string
The wallet address which will be used to send the token.
ApprovalTransactionRequest
object
An approval transaction with metadata about whether it is a cancellation and which LP action it supports.
4 properties3 required
RequestId
string
A unique ID for the request.
Err404
object
2 properties
CreateClassicPositionResponse
object
5 properties4 required
poolFee
string
The fee of the pool in basis points.
Address
string
CreatePositionExistingPoolParameters
object
Parameters for creating a position in an existing pool.
3 properties3 required
Err504
object
2 properties
DecreasePositionResponse
object
5 properties4 required
gasFee
string
The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) in the base unit of the chain.
PoolInfoResponse
object
4 properties
V2PoolParameters
object
Parameters identifying a V2 pool.
3 properties3 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.
TransactionRequest
object
9 properties5 required
ClaimFeesResponse
object
5 properties4 required
PoolParameters
object
5 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…
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.
Err400
object
2 properties
gasLimit
string
The maximum units of gas that will be consumed by this transaction.
IncreasePositionRequest
object
13 properties6 required
PositionTickBounds
object
Tick bounds for a concentrated liquidity position.
2 properties2 required
receiverWalletAddress
string
The wallet address which will receive the token.
LPApprovalResponse
object
4 properties1 required
Err401
object
2 properties
gasPrice
string
The cost per unit of gas.
IncreasePositionResponse
object
5 properties4 required
PoolInfoRequest
object
6 properties1 required
Err429
object
2 properties
CreateToken
object
A token address and amount used in position creation.
2 properties2 required
maxPriorityFeePerGas
string
The maximum tip to the block builder. Adjusted based upon the urgency specified in the request.
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.
