Plan a new pool on LoomDesk's hooks, with the creator's choices
plan_open_poolPlans a new Uniswap v4 pool for a token on LoomDesk's open hook, where LoomDesk's share is a tenth of the base fee, taken in the quote, a royalty or burn the creator sets (blocks) comes out of the fee too, and the liquidity keeps the rest. Use when ladder_pools shows no pool of the token against the quote wanted, or none that pays liquidity; when a position is wanted in it right away, prefer plan_build, which opens the pool and builds in one transaction. Returns: transactions[] (to, data, value in wei, gas), check (simulated, ok, failedStep, reason, ethNeeded, ethHeld), sendWithin, ifItReverts, slippagePct, the pool's key and opening price, then (the key and price for plan_ladder with newPool). The pool opens at the price of the token's existing market and holds nothing until liquidity is added; one-off cost about a dollar. Behavior: read-only on our side; nothing is signed or sent. The plan is laid out from the chain at this block and simulated from the owner; send it within check.sendWithin, and plan again rather than resend one that reverted. Costs quota units (agent_quota). Errors: refused when the pair already has a pool on the hook, the quote has no exit (under 2,000 USDG of liquidity on the chain), or the token has no market to price from.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"token": "<token>",
"quote": "<quote>",
"owner": "<owner>"
},
"name": "plan_open_pool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hook | No | Which hook the pool goes on and with what, when it has to be opened. Left out: the plain ranges pool at feePct; the answer then lists the presets under options. A full-range pool, a launch fee or the volatility fee are opened by the hook's own call in a transaction before the build (plan_build returns both, in order). | |
| owner | Yes | The wallet that signs, sends, and pays the opening cost. | |
| quote | Yes | What the token trades against: ETH, USDG, or a quote token's address (a tokenized stock, LOOM, any token with a real exit). | |
| token | Yes | The token's address. | |
| feePct | No | The pool's swap fee in percent: 0.1 (rungs from 0.01% wide), 0.5 (from 0.1%), or 1 to 5 (from 2%); a full-range pool takes 1 to 5. Left out: the preset's, else 1. | |
| startPriceUsd | No | For a token that has never traded: the price the pool opens at, in dollars per token, instead of startMarketCapUsd. | |
| startMarketCapUsd | No | For a token that has never traded (not in the index): the market cap the pool opens at, in dollars; the price is it over the token's supply. Ignored for a token with a market. |