Liquidity
Liquidity
This guide explains how to create, add, remove, and manage concentrated liquidity positions on Solana using the Toolther interface at https://toolther.app/liquidity. It covers the Statistics hub, Create Pool, Add Liquidity, Remove Liquidity, and Position pages. Supported DEXes: Orca Whirlpools, Raydium CLMM, and Meteora.
1. Prerequisites
Connected wallet: Phantom, Solflare, Backpack, or Ledger (via Solflare).
Network selected: Devnet or Mainnet. Ensure the wallet network matches the app network.
Sufficient SOL for transaction fees and rent-exempt account creation.
For Create: You need both tokens of the pair and a clear idea of fee tier and initial price.
For Add/Remove: You need an existing pool (Create) or position (Add) to work with.
2. Page Layout Reference
Liquidity Hub (Statistics) — https://toolther.app/liquidity
Header: Connect Wallet, Settings, navigation.
Title: "Liquidity" with gradient styling.
Tabs: Stat, Create, Add, Remove, Position, How to use?
Liquidity Pools Map: Animated map of all created pools by DEX and pair.
Liquidity Actions: Cards linking to Create, Add, Remove, Position.
Liquidity guide by page: Short descriptions and links for each route.
Create — https://toolther.app/liquidity/create
DEX selector, token pair (base + quote), fee tier, initial price.
Token amounts and range mode (full range or custom).
Preview Step 1 / Step 2 transactions, risk checkbox, confirm.
Add — https://toolther.app/liquidity/add
Pool search: by pair symbol, pool address, or load from wallet positions.
Deposit amounts and range parameters.
Preview, estimates, slippage, confirm.
Remove — https://toolther.app/liquidity/remove
Load wallet positions, select target position.
Remove size: percent or token amount.
Preview, expected post-withdraw values, confirm.
Position — https://toolther.app/liquidity/positions
Filter by symbol, pool address, or position mint.
List of positions with balance, range, DEX.
Quick actions: Add More, Remove, Harvest, Pool View.
Manage — https://toolther.app/liquidity/manage
Wallet pool search.
Table of managed pools with TVL, volume, links.
3. Step-by-Step: Create Pool
Connect your wallet and ensure the correct network.
Go to Create tab.
Select DEX (Orca, Raydium, or Meteora) and token pair (base + quote).
Set fee tier and initial price for the pool.
Enter token amounts and choose range mode (full range or custom range).
Open preview. Review Step 1 (initialize pool) and Step 2 (add initial liquidity) transactions.
Confirm the risk checkbox.
Execute Step 1, wait for confirmation, then execute Step 2.
Record the pool address and transaction signatures.
4. Step-by-Step: Add Liquidity
Connect your wallet.
Go to Add tab.
Find a pool: search by pair symbol, paste pool address, or load from your wallet positions.
Define deposit amounts for both tokens and range parameters (lower/upper price or full range).
Open preview. Verify estimates, slippage, and expected position.
Confirm the transaction in your wallet.
Wait for confirmation. The new position will appear in Position tab.
5. Step-by-Step: Remove Liquidity
Connect your wallet.
Go to Remove tab.
Load your positions. Click refresh if needed.
Select the target position by pair or position mint.
Set remove size: percentage (e.g. 50%) or token amount.
Review expected amounts you will receive and post-withdraw values.
Confirm the transaction in your wallet.
Verify the signature in the explorer.
6. Step-by-Step: Position Management
Connect your wallet.
Go to Position tab.
Filter positions by symbol, pool address, or position mint.
For each position, review: balance composition, range status (in/out of range), DEX metadata.
Use quick actions:
Add More — go to Add flow for this pool.
Remove — go to Remove flow for this position.
Harvest — collect accrued fees.
Pool View — open pool details page.
7. Field Details and Validation
Token pair: Base and quote tokens. Must have valid mints and decimals.
Fee tier: Determines tick spacing and fee rate. Choose based on pair volatility.
Initial price: Sets the starting price of the pool. Use current market price for new pools.
Range: Full range covers all prices; custom range concentrates liquidity in a band.
Amounts: Must be positive. The app converts to base units using token decimals.
Remove percent: 1–100. Removes that fraction of your position.
8. Warnings and Safety
Out of range: If price moves outside your position's range, you stop earning fees. Consider rebalancing or removing.
Impermanent loss: Providing liquidity can result in less value than holding. Understand the risk before adding.
Slippage: Set appropriate slippage for add/remove. Large orders may need higher values.
Pool not found: Verify pool address and network. Ensure the pool exists on the selected DEX.
9. Troubleshooting
No tokens found / No positions: Click refresh. Ensure wallet is connected and on the correct network.
Pool not found: Check pool address format. Confirm the pool exists on the chosen DEX and network.
Transaction failed: Open the tx in the explorer. Common causes: slippage, insufficient SOL, or pool/position state changed.
Disabled buttons: App may be initializing or wallet not connected. Wait a few seconds and retry.
Create Step 2 pending: If Step 1 succeeded but Step 2 was not completed, use the Manage or Add flow to add liquidity to the new pool.
10. Related Topics
Swap: Trade tokens at https://toolther.app/app/swap.
Jupiter: Used for price feeds in liquidity views.
Orca Whirlpools / Raydium CLMM: Concentrated liquidity protocols powering the pools.
11. Best Practices Checklist
Verify you are on the correct network (Devnet vs Mainnet).
Double-check token pair, amounts, and range before confirming.
Record pool address and transaction signatures for audit.
Monitor positions for "out of range" and rebalance when needed.
Use the How to use? tab for step-by-step guidance on each page.
Last updated