Feature guide

Liquidity pools & search

The /pools page lists indexed pools per network with TVL, volume, fees and estimated APR. Use search to find a token pair, a pool address or a Uniswap v4 pool ID. Pools that are not indexed can still be opened by address (Pool Studio).

• Pool Studio: price, active-liquidity distribution around the price, TVL/fee/volume charts, and opening positions with your chosen range.
• Compare up to 5 pools at once at /pools/compare over the same observation window.
• APR is an estimate from observed fees, not a promised return.

Pool security

Every pool gets a security grade (A–F) from automated checks: token contract (tax, blacklist, mint, proxy), Uniswap v4 hooks, holder concentration and removable liquidity. Grade history and changes are recorded, and you can subscribe to browser notifications for a specific pool.

Solana pools now have the same panel: official pool program, active-liquidity ownership & concentration (rug-pull risk), pool price vs market, activity vs TVL, pool age & fee, plus checks of both tokens (on-chain buy & sell simulation, GoPlus, mint/freeze, creator, organic volume). Tokens graded F are blacklisted and flagged as scam tokens.

Automated checks are not an audit and not a safety guarantee. Rug pulls remain possible.

Swap

The /swap page finds the best route (direct or via a bridge token, up to 2 hops in one transaction) across registered Uniswap v2/v3/v4 pools. Cross-network routes use the Across bridge.

• Default slippage is 1%; slippage above 5% requires Expert Mode.
• Token approvals are always for the transaction amount (never unlimited).
• Details before signing: minimum received, price impact, gas cost and platform fee.

Liquidity positions

Your positions (and any wallet you look up) appear on the wallet profile. For Uniswap v3/v4 and Aerodrome positions you can: add liquidity, withdraw part or all, claim fees, compound (add fees back into the position) and rebalance (move to a new range around the price).

• Manual mode: you deposit both tokens at the pool ratio.
• In/out-of-range status and unclaimed fees are read directly from the position contract.
• Closed positions: tick "Show closed positions" on the profile for a separate table (10 per page, « ‹ › » buttons and a page-number box) with the token amounts & fees withdrawn at close, total, fee APR (only positions active ≥ 1 day), range, age and close date. The total uses the price at close for pairs with a USD stablecoin, otherwise the current price.
• Closed-position history is stored on the server: closed Uniswap v3/v4 positions are not re-read from the blockchain on every profile visit (their summary is computed once in the background). Solana positions are recorded while still open; older Solana positions are filled in gradually from the wallet transaction history (up to the last 5,000 transactions, without the price range).
• The ↻ button next to ⚙ in the position dialogs and the Add liquidity panel searches the route/quote again and reloads balances; the icon only spins for searches you click (automatic updates keep running in the background).

Create new pool

At /pools/create you can create a Uniswap v2/v3/v4 pool that does not exist yet and add its first liquidity in a single transaction to the official Uniswap contracts on 9 EVM networks: Ethereum, Base, Arbitrum, OP, BNB Chain, Polygon, Avalanche, Robinhood Chain and Arc. Pick the network first at the top of the page.

• Paste both token addresses: the network & protocol are detected automatically, together with existing pools per fee. Choose the fee (a preset, or a custom 0.0001%–10% on Uniswap v4). If a pool with that fee already exists you are pointed to it.
• The initial price ("1 A = x B") is suggested from the BaniPool market price (USD price, or the rate of other existing pools when the token has no price yet). A deviation above 2% must be confirmed; above 20% only with Expert Mode — a wrong initial price is immediately taken by arbitrage.
• v3/v4: initial price + range (full range recommended), resulting in an NFT position. v2: the initial price = the ratio of the two token amounts, resulting in LP tokens.
• Zap In (default): pay with a single token — Token A, Token B, or ETH. BaniPool computes the part to swap through other existing pools so it matches the initial price & range, runs the swaps one by one, then creates the pool with the actual swap output. It needs a swap route (another pool) to the paired token; if there is none, use Manual mode with both tokens.
• The one-transaction Zap (BaniZapCreate contract) is available on 9 networks, temporarily limited to max $500 per transaction. On Arc (no wrapped native) Zap is paid with an ERC-20 token (e.g. USDC), not the native asset. When the route goes through a hooked v4 pool (only hooks reviewed by BaniPool), the hook name and its cut are shown before signing.
• The create-pool platform fee (when active, max 1%) is taken from the token you pay with in the one-transaction Zap and is shown before you sign ("Platform fee x% (≈ $y)" or "Free"). Manual mode has no platform fee.
• Uniswap v4 only without hooks. Unverified tokens require ticking the risk acknowledgement.
• Solana (Orca Whirlpools & Raydium CLMM): choose the "Solana" network, log in with a Solana wallet, search any coin (including pump.fun), then create a pool or add liquidity with Zap (one transaction for an existing pool) or Manual. The fee tier is picked automatically by the Fee Advisor and every token is security-checked. Full details on the Solana page.

Zap In & Zap Out

Zap In lets you enter a position with a single token: the server computes the balancing swap and the BaniZap contract swaps and adds liquidity in one transaction. Zap Out is the reverse: withdraw the position and swap everything into one token of your choice.

• Quotes refresh in real time (via the network WebSocket or polling) and are always simulated before sending.
• The contract checks a whitelist of router commands and ensures no funds are left behind in the router.
• The route is chosen from all candidates (direct or via one intermediate token, including other v4 pools) with the largest final output. When a pool is too thin to swap all tokens, the simulation stops with a clear message — use Manual or another target token.
• Tokens with a built-in unlimited Permit2 allowance (some newer ERC-20 tokens) cannot use one-transaction Zap In; BaniPool automatically switches to a step-by-step plan (swap, then add liquidity), with the platform swap fee charged at each swap step.
• The position NFT approval to the Zap contract can be revoked at any time from the position page.

Find coins by name (EVM)

The token picker in EVM Swap and Create pool searches coins outside the BaniPool list by name or symbol across every network shown. DexScreener results are merged per token with total liquidity; symbol & decimals are read directly from the token contract.

Tokens outside the list are not verified by BaniPool. Many tokens share the same name — match the contract address with an official source and check its security card.

EVM Fee Advisor

In step 3 of EVM Create pool, the "Fee analysis" card ranks every fee tier: fee APR, impermanent-loss (LVR) cost and net APR for your planned capital & range. The recommendation is selected automatically until you pick a fee yourself.

• Data: every pool of the pair on every DEX of that network (DexScreener); Uniswap/Pancake v3 fees read on-chain, v2 from DEX convention; volatility from 24 hours of 5-minute candles (GeckoTerminal); the network block time for the arbitrage factor.
• Joining an existing pool is valued at least at your pro-rata share of that pool’s own fees.

Automation (keeper)

At /automation you create rules for a position: compound when fees accrue, rebalance when out of range, exit, or simply notify. There are three modes:

Live mode needs two on-chain permissions: the keeper policy (allowed actions, interval, daily limit, expiry, maximum slippage) and the position NFT approval to the keeper contract. The contract only rebalances/exits when the position is out of range, computes the minimum swap output itself, and always sends results to your wallet. Revoke at any time.

Bridge

The /bridge page moves ETH, WETH or stablecoins between networks via Across Protocol. A relayer fills the destination with the amount locked at quote time; if not filled before the deadline, funds are refunded on the source network. Transfer status only advances with on-chain evidence on both networks.

Vault

Official ERC-4626 vaults (Spark spUSDG on Robinhood, sUSDC on Base, and Spark vaults on Ethereum/Arbitrum/Optimism/Avalanche) can be deposited into and withdrawn from at /vaults. Deposits go through BaniVaultRouter with a limited approval and a minimum shares output.

Wallet profile, portfolio & watchlist

• /dashboard and /account: token balances and positions of any wallet across all active networks (read-only).
• /portfolio: your wallet combined with up to 20 watch-only accounts.
• /watchlist: save pools, tokens or accounts (up to 200 items) to monitor.
• /transactions: history of transactions you made through BaniPool with their status (submitted, confirmed, finalized, failed).

Notifications

Connect Web Push (browser) or the Telegram bot at /settings to receive automation rule notifications and pool security alerts. The Telegram link code is valid for 15 minutes.

Automatic position alerts

If your wallet has linked notifications (browser push, Telegram or email), BaniPool checks your active EVM & Solana positions every 15 minutes without you having to create a rule:

• Position out of range — at most once a day per position; turn it off in Settings → "Position out of range". Positions that already have an /automation rule do not get duplicate alerts.
• Scam token in your position — one of the position tokens was added to the BaniPool blacklist; always sent because it concerns the safety of your funds.
• /automation rules now also accept Raydium CLMM positions (notify & paper modes).

WebSocket (WSS) settings

Real-time Zap quotes use the network public WebSocket RPC. For a more stable connection you can set your own WSS URL at /settings → Real-time WebSocket, for example from Alchemy, QuickNode or the network official RPC.

wss://base-mainnet.g.alchemy.com/v2/<KUNCI_ALCHEMY_ANDA>
wss://robinhood.drpc.org

• The WSS URL is stored encrypted only in your browser and is never sent to the BaniPool server.
• The Test button checks that the URL really connects to the right network (chain ID) before it is used.
• Polling mode (every 0.5–30 seconds) is available when WebSocket cannot be used.

Service status

The /status page shows the health of the API, the database and every data source per network (RPC, index) with the last success time. If a network has problems, transactions on it may be paused for safety.