LLMs.txt: agent-readable Markdown index of this site at /llms.txt
POSTCreate a classic (V2) LP position

Create a classic (V2) LP position

Creates a full-range liquidity position in a Uniswap V2 pool. Specify the independent token and amount; the server computes the dependent token amount based on the current pool ratio. If simulateTransaction is set to true, the response will include the gas fee for the creation transaction.

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

Headers

x-agent-infostring

Optional attribution hint for AI-agent traffic; send it if an AI agent built or operates your integration. The value is a JSON object with up to three fields: decision_origin (required, exactly autonomous or human_mediated, case-sensitive), integration_name (optional string naming your integration, e.g. my-trading-bot), and version (optional string identifying your integration's version). Any other key is dropped, never rejected. The raw value must be at most 1024 bytes of printable US-ASCII (0x20-0x7E), so send non-ASCII text as JSON \u escapes; integration_name and version are each limited to 256 UTF-16 code units and may not contain control characters, U+2028, U+2029, or U+FFFD. Send the header once: repeated header lines are joined with , and the joined string is what gets parsed, so two complete objects fail as invalid JSON while a single object split across two lines still parses. The header is analytics-only and never affects the request: omitting it, sending it, or sending a value that fails these rules never changes the response status, body, or swap behavior. A value that fails to parse is dropped and reported by the x-agent-info-status response header. Never put a user ID, wallet address, email, session token, or API key in these fields.

Body

application/json
walletAddressstringrequired
slippageTolerancenumber

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

deadlineinteger

Transaction deadline in seconds.

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.

includeApprovalSimulationboolean

If true, the response will include approval simulation data.

Response

Create classic (V2) position successful.

requestIdstringrequired

A unique ID for the request.

independentTokenobjectrequired

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

dependentTokenobjectrequired

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

createobjectrequired
gasFeestring

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