Positions Page

🐨 KoalaSwap — Positions Page 📌 Who is this page for?

  • Users who have already added liquidity

  • Those who want to create their first position

  • Anyone looking to manage (increase, withdraw, or monitor) their LP positions

📍 If You Have No Positions Yet

You’ll see this screen:

Click the "Create" button Opens the form to create a new LP position. You'll choose a token pair, set the price range, amount, and provide liquidity.

A modal will open where you:

Step 1: Select a Token Pair

  • On the left side, choose the first token (e.g., UNIT0).

  • On the right side, click "Choose a token" and select the second token from the list. 💡 You can use any tokens available on your connected network. Make sure you have enough balance for both.

Step 2: Choose a Fee Tier

Select one of the available options:

Fee Tier

Best For

0.01%

Very stable pairs (e.g., stablecoins)

0.05%

Mostly stable pairs

0.3%

Default choice for most pairs

1%

Volatile or exotic token pairs

Step 3: Click "Continue"

Once you’ve selected the tokens and fee tier, the "Continue" button will become active. Click it to proceed.

Step 4: Full Range Covers the entire price spectrum — from 0 to ∞. ✅ Your liquidity is always active, regardless of price movement. Min Price = 0, Max Price = ∞ — cannot be changed.

Custom Range Define the specific price window where your liquidity will be active. You set: Min Price: The lowest price at which your liquidity is active Max Price: The highest price at which your liquidity is active

Continue Button Once you’ve selected a range click "Continue" to move on to the next step: entering token amounts and confirming the transaction.

Step 5: In this step, you’ll specify the token amount to deposit and confirm the transaction via your wallet. Deposit Tokens Section This is where you specify how much liquidity you want to provide.

What to do:

  1. Enter the desired amount of tokens. For example: 5 Or click "Max" (next to your available balance, e.g. 14.90) to use the full amount.

  2. Once entered: The “Review” button will become active.

Step 6: In the next modal window click the Create button

Done

📍 If You Already Have Positions

Use this flow if:

  • You’ve already created one or more liquidity positions

  • You want to manage existing positions — add or remove liquidity, or adjust the price range

  • You prefer to monitor and control all your positions in one place via the Positions dashboard

🔘 Token Pair & Fee Tier

  • Example: USDT / WUNIT0 0.30%

  • This shows the pair of tokens in the position and the selected fee tier.

  • The fee tier indicates the percentage of trading fees earned from swaps in this pool (e.g. 0.30%).

🟢 Status: In Range / Out of Range

  • In Range (green dot): Your liquidity is currently being used in the pool. You're earning fees.

  • Out of Range (red/gray dot, not shown here): The market price has moved outside your defined price range, and your liquidity is inactive (no fees earned).

🆔 Position ID

  • A unique identifier (e.g. ID 19) for each liquidity position.

  • Useful for referencing or removing positions.

💧 Liquidity

  • Shows how much of each token you currently have in the position.

  • Example:

  • 0.00 USDT

  • 4.9999999 WUNIT0

  • Liquidity may not be equally split — it depends on your price range and market price.

📈 Current Price

  • Displays the current on-chain exchange rate for the token pair.

  • Example: 0.99999736 USDT/WUNIT0

🔢 Price Range

This is the range of prices where your liquidity is active:

  • Min: Lowest price at which liquidity is still used.

  • Max: Highest price within the range.

  • If listed as “Full range”, your liquidity is available at any price, but this strategy may have a lower yield and higher impermanent loss.

🐨 KoalaSwap — Guide to the Position Details Page

📍 Example: USDT /USDC (0.30%) Position

🔍 What’s Shown on This Page?

💧 Liquidity (Your deposited tokens)

Displays the amount of each token currently in the position. This is your active liquidity in the pool.

💰 Uncollected Fees

Shows how much fee income you've earned but haven't claimed yet 👉 Click Collect fees to claim these tokens to your wallet.


💵 Price Range

Shows the price range in which your position is active:

  • Min price: 0.00

  • Max price: ∞ ⚠️ The label “In range” means your position is currently earning fees.


⚙️ Action Buttons

  • Add liquidity — Add more tokens to this position

  • Remove liquidity — Withdraw part or all of your liquidity

  • Collect fees — Claim any earned but uncollected fees

🧠 Tips

  • Make sure your position is “In range” to earn fees

  • Use Collect fees regularly to claim rewards

  • To change the price range, you need to remove this position and create a new one

  • You can add or remove liquidity partially — it's flexible

Last updated