LLMs.txt: agent-readable Markdown index of this site at /llms.txt
POSTCreate a V3 or V4 LP position

Create a V3 or V4 LP position

Creates a new LP position in a V3 or V4 pool (including full-range positions). You can create a position in an existing pool by providing existingPool parameters, or create a new pool by providing newPool parameters (fee, tick spacing, initial price, and optionally hooks for V4). The position's price range is specified via either priceBounds or tickBounds. The server computes the dependent token amount. If simulateTransaction is set to true, the response will include the gas fee.

npx skills add uniswap/uniswap-ai --skill liquidity-planner

Plan LP positions with deep links. Works with Claude Code, Cursor, and other AI coding tools.

Authorization

x-api-keystringrequiredheader
Playground key
You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.
Get your keys

Body

application/json
walletAddressstringrequired
chainIdenumrequireddefault:1
1105613013714319632448018684217432646635042845310143421614222043114570735914481457777777713018453211155111

The unique ID of the blockchain. For a list of supported chains see the FAQ.

protocolenumrequired
V2V3V4

The protocol of the pool.

slippageTolerancenumber

Slippage tolerance as a decimal (e.g., 0.5 for 0.5%).

deadlineinteger

Unix timestamp after which the transaction will revert.

simulateTransactionboolean

If true, the response will include the gas fee.

urgencyenum
NORMALFASTURGENT

The urgency level for gas price estimation. Higher urgency results in higher gas price and faster transaction inclusion. Defaults to URGENT if not provided.

signaturestring

The signed permit.

nativeTokenBalancestring

The wallet's native token balance, used for wrapping calculations when one of the tokens is the native token.

Response

Create V3/V4 position successful.

requestIdstringrequired

A unique ID for the request.

token0objectrequired

A token with its address and amount, used in LP operations.

token1objectrequired

A token with its address and amount, used in LP operations.

adjustedMinPricestringrequired

The actual minimum price after tick adjustment.

adjustedMaxPricestringrequired

The actual maximum price after tick adjustment.

tickLowerintegerrequired

The adjusted lower tick.

tickUpperintegerrequired

The adjusted upper tick.

createobjectrequired
gasFeestring

The total estimated gas cost of this transaction (eg. gasLimit multiplied by maxFeePerGas) in the base unit of the chain.