Web3 Multi-Token Live LP Strategy

Risk warning: This strategy sends real on-chain transactions and spends gas. LP fees may not offset token price moves, impermanent loss, swap slippage, gas, or smart-contract risk. Pool depth, historical fees, and projected returns are decision aids, not a forecast. Start with a small amount and verify the exchange, chain, pool, and wallet permissions.

Strategy Concept

This is a live tool for managing LP positions in multiple target tokens on one chain. Each token has its own budget, pool, range, positions, and accounting. Several tokens can be held at the same time, while the status panel shows portfolio P&L, individual positions, and wallet balances. Building, manual fee collection, reducing, and closing are initiated from the status panel. Optional automatic fee collection is off by default.

Positioning: an LP tool where the user decides and the program executes, records, and guards. Pool choice, range width, and exit timing are the user's decisions; the strategy executes against on-chain data, reconciles positions, records P&L, and sends alerts when the price leaves the range, with optional auto-close below the floor. It does not rebalance automatically and does not guarantee profit. Use at least 100 funding units per token, or gas and swap costs take too large a share; on first use, run one full build → collect → close cycle with a small amount.

The strategy uses the FMZ DEX exchange functions lp.pools, lp.plan, lp.add, lp.positions, lp.collect, and lp.remove. Budgets are entered in the chain's funding stablecoin. The strategy uses assets already in the wallet and swaps only the shortfall.

            text
            
            
Detect chain and funding currency → enter token contract addresses and budgets
        ↓
Scan pools per token → exclude empty and shallow pools → select a pool
        ↓
Choose settlement, liquidity shape, price range, and layers
        ↓
Read-only lp.plan → review assets, price, slippage, and risk
        ↓
Manual build: fund assets → lp.add per layer → verify with lp.positions
        ↓
Collect fees manually or by threshold → reduce / close → settle as selected
        ↓
Price leaves the range → push alert; below the floor with auto-close on, close all positions into the quote currency

Supported Venues and Live Checks

Only combinations that passed the full live LP cycle (build, collect, reduce, close, restart recovery) are supported; anything else is rejected at startup with the reason:

The startup check reports each item: exchange / DEX / chain, wallet address, swap slippage, balance read, LP position read, gas price source, gas balance, and funding balance. If any of the first five fails, the strategy stops without trading. Low gas or funds keep monitoring and closing available but shut the build gate. The checks repeat every 10 minutes.

Before every build the gate requires: passed live checks, gas at or above the reserve, current investment across tokens plus this budget within the total cap, combined realized and open P&L above the loss limit, and no pending funding or external-close records. Otherwise no transaction is sent.

Basic pools (Uniswap v2; Aerodrome / Velodrome volatile and stable) are full-range and merge positions per pool, so layers and ranges do not apply; they are excluded from the scan. After closing or collecting, the strategy checks the wallet increase of the base token (including WETH / WBNB) and sells any residue left by sell=true, without touching pre-existing holdings and keeping the gas reserve.

Multiple Tokens and Position Records

Enter each token's contract address on the current chain and its LP budget in the status panel. The strategy resolves the token symbol automatically; a symbol alone or a “symbol,address” pair is rejected. Each token has separate pool selection, planning, settlement, positions, and P&L; one token session manages one current pool. The strategy manages only positions it built: it records position IDs after building, and on restart reconciles them with the chain (V4 / Infinity positions are registered with lp.track first). If a recorded position is closed elsewhere, it asks for manual reconciliation of the proceeds. LP positions in the wallet that the strategy did not build are not adopted, counted, or touched.

The strategy has fresh, independent state and does not read local paper or live records from older strategies. Avoid letting another robot operate the same LP position.

Pool Selection, Planning, and Building

The pool scan shows available quote currencies, fee tiers, prices, TVL, volume, and fees. By default, pools with TVL below 20 times the intended investment are excluded; pools without valid depth data are not candidates. Historical fee rates and estimated daily returns are indicative only.

After selecting a pool, choose a uniform, center-weighted, or edge-weighted liquidity shape, a price range relative to the current price, the number of layers, and a settlement mode. lp.plan calculates per-layer assets and scenarios without sending a transaction. When live building is requested, the strategy replans and checks the pool price, wallet funds, gas reserve, and existing on-chain positions. It then swaps only missing assets and calls lp.add layer by layer. If the pool price moves beyond the configured drift limit, it stops further building and handles positions already created.

Market-swap slippage and LP-building slippage are separate settings. If the exchange cannot confirm the market-swap slippage setting at startup, the strategy stops before trading.

Two Settlement Modes

Each pool can use its own mode:

In quote-retention mode, P&L is still displayed in funding-currency terms, although no final stablecoin conversion took place. Later quote-currency price changes and external wallet transactions are outside strategy P&L. The retention record is not the current wallet balance.

Fees, Closing, and RPC Failures

Manual collection, reduction, and closing can target all positions or one layer. Automatic fee collection is disabled by default. When enabled, it requires fresh on-chain data, enough gas balance, and estimated uncollected fees above the threshold after estimated gas and any required conversion cost. Estimated net return is a pre-trade gate, not guaranteed realized profit.

On temporary lp.positions failures such as HTTP 503 or connection refusal, the strategy retries with backoff. If all attempts fail, it keeps the last successful reading for display and marks it stale. Stale data is excluded from position reconciliation, P&L updates, and automatic collection. Building, collecting, and closing pause if current positions cannot be confirmed. If an order outcome is uncertain and an on-chain check also fails, automatic resubmission stops to avoid duplicate transactions. Reading resumes when the RPC recovers; persistent failures require checking the exchange's RPC endpoint.

Range Guard

Range alerts: the range floor and ceiling are the lowest and highest prices across all layers. The first time the pool price falls below the floor (the position is entirely in the base token, earns no fees, and carries the downside) or rises above the ceiling (the position has been fully sold into the quote currency and earns no fees), the strategy sends one push notification for that direction (enable message push in your FMZ account). Each direction alerts only once per holding round, so a price hovering around a bound does not trigger repeated alerts; counting restarts with the next round after closing.

A ceiling break only alerts and takes no automatic action; the user decides whether to collect and close, or rebuild around the new price.

Auto-close below the floor: the guard table under the position table shows the range bounds, the current pool price, and the distance to each bound, with an “enable auto-close” button. Its default comes from the “auto-close below floor (default)” parameter (off unless set), and each token can be switched individually. When enabled, auto-close requires the pool price to stay below the floor for 3 consecutive fresh on-chain readings, restarting the count if the price returns to the range, which filters out brief wicks. It then closes all of that token's positions and stops in the pool's quote currency without the final stablecoin swap; layers not closed at once are retried, and the original settlement mode is restored after the round. Auto-close sends real transactions and spends gas, so keep the gas balance above the reserve.

Laddered positions are judged only by the overall floor: as the price falls, upper layers are crossed one by one and turn into the base token, which is the intended staged accumulation of a ladder. Alerts and auto-close fire only when the whole ladder has been crossed.

Live Parameters

Pool depth, both slippage limits, build price drift, and the gas-reserve multiplier are required. The total cap, loss limit, auto-close default, and four automatic-collection parameters are optional; a blank value uses the default shown above.

The status panel shows portfolio P&L in funding-currency terms, closed-round P&L, open-position P&L, LP value, uncollected fees, positions by token, the range guard, and risk notices. P&L updates pause when required position or price data is missing or stale, so an RPC failure is not shown as a loss.