1 of 28

KoalaSwap Docs

Introduction

Overview

The KoalaSwap Protocol

Introduction

The KoalaSwap protocol is a peer-to-peer1 system designed for exchanging cryptocurrencies on the Unit Zero blockchain. The protocol is implemented as a set of persistent, non-upgradable smart contracts; designed to prioritize censorship resistance, security, self-custody, and to function without any trusted intermediaries who may selectively restrict access.

How does the KoalaSwap protocol compare to a typical market?

To understand how the KoalaSwap protocol differs from a traditional exchange, it is helpful to first look at two subjects: how the Automated Market Maker design deviates from traditional central limit order book-based exchanges, and how permissionless systems depart from conventional permissioned systems.

Order Book VS AMM

Most publicly accessible markets use a central limit order book style of exchange, where buyers and sellers create orders organized by price level that are progressively filled as demand shifts. Anyone who has traded stocks through brokerage firms will be familiar with an order book system.

The KoalaSwap protocol takes a different approach, using an Automated Market Maker (AMM), sometimes referred to as a Constant Function Market Maker, in place of an order book.

At a very high level, an AMM replaces the buy and sell orders in an order book market with a liquidity pool of two assets, both valued relative to each other. As one asset is traded for the other, the relative prices of the two assets shift, and a new market rate for both is determined. In this dynamic, a buyer or seller trades directly with the pool, rather than with specific orders left by other parties. The advantages and disadvantages of Automated Market Makers versus their traditional order book counterparts are under active research by a growing number of parties.

Permissionless Systems

The second departure from traditional markets is the permissionless and immutable design of the KoalaSwap protocol. These design decisions were inspired by Ethereum's core tenets, and our commitment to the ideals of permissionless access and immutability as indispensable components of a future in which anyone in the world can access financial services without fear of discrimination or counter-party risk.

Permissionless design means that the protocol's services are entirely open for public use, with no ability to selectively restrict who can or cannot use them. Anyone can swap, provide liquidity, or create new markets at will. This is a departure from traditional financial services, which typically restrict access based on geography, wealth status, and age.

The protocol is also immutable, in other words not upgradeable. No party is able to pause the contracts, reverse trade execution, or otherwise change the behavior of the protocol in any way.

Protocol Concepts

Overview

Swaps

Introduction

Swaps are the most common way to interact with the KoalaSwap protocol. For users, swapping is simple: you select an ERC-20 token you own and a token you’d like to trade it for. When you execute a swap, your tokens are sold for the desired tokens, minus a small fee that goes to liquidity providers. Swapping with KoalaSwap is permissionless, meaning anyone can do it without needing approval.

Note: Using web interfaces to swap via KoalaSwap may introduce additional permissions or differences in behavior compared to interacting directly with the protocol. Learn more in our [Introduction to KoalaSwap guide].

Unlike traditional order book trades, swaps on KoalaSwap don’t rely on a list of buy and sell orders. Instead, they use a pool of liquidity where providers earn fees based on their contribution.

Price Impact

In a traditional market, a large buy order might push the price up by filling multiple sell orders at different prices. With KoalaSwap, price impact works differently. During a swap, the relative price of tokens in the pool shifts as the trade happens, affecting the final price you get.

The amount of liquidity at different price levels affects price impact. More liquidity at a price means lower impact for your swap; less liquidity means higher impact. The KoalaSwap interface shows an estimated price impact in real-time, so you can decide before confirming your swap.

Slippage

Slippage refers to price changes that can happen while your swap is waiting to be processed. On Ethereum, transactions are prioritized based on the gas fee you offer—the higher the fee, the faster the swap. If your transaction takes time, other swaps might change the price environment.

To manage this, you can set a slippage tolerance (e.g., 1%). If the final price stays within this range, your swap goes through. If the price moves outside this range, the swap will fail to protect you from unexpected changes.

Safety Checks

KoalaSwap includes safety features to protect you from major price changes during a swap:

Expired: If your swap takes too long (past a set deadline), it will cancel to avoid unfavorable price shifts.
Insufficient Output Amount: If the amount of tokens you’d receive is less than expected (within your slippage tolerance), the swap cancels to protect you from sudden price drops.

Fees

Swap Fees

Swap fees on KoalaSwap are distributed to liquidity providers whose positions are active (in-range) at the time of the swap. If the current price moves out of a position’s range, that liquidity stops earning fees until the price moves back into the range.

Unlike some other protocols, swap fees on KoalaSwap are not automatically reinvested into the pool. Instead, they are collected separately, and liquidity providers must manually claim their fees when they’re ready.

Pool Fee Tiers

KoalaSwap allows multiple pools for each token pair, each with a different swap fee. Currently, you can create pools with three fee levels: 0.05%, 0.3%, and 1%. These tiers help cater to different types of assets and trading needs.

Thanks to concentrated liquidity, splitting pairs into multiple pools doesn’t hurt traders. It reduces price impact by letting liquidity providers focus their funds in specific price ranges, making swaps more efficient for everyone.

Finding the Right Pool Fee

Different assets tend to work better with specific fee tiers, depending on their volatility and trading frequency:

Low-volatility assets (like stablecoins) often use the lowest fee tier (0.05%), as the risk for liquidity providers is minimal, and traders want prices as close to 1:1 as possible.
High-volatility or exotic assets usually gravitate toward higher fees (like 1%), as liquidity providers need to offset the risk of holding these assets.

Protocol Fees

KoalaSwap includes a protocol fee mechanism that can be activated in the future through governance. This allows flexibility in deciding how much of the swap fees go to the protocol itself.

In-range liquidity refers to positions that cover the current price of the token pair.

Range Orders

Range Orders

Customizable liquidity positions and the ability to provide a single asset allow for a new trading approach on the KoalaSwap protocol: range orders.

In traditional order book markets, you can set a limit order to buy or sell an asset at a specific price, waiting for it to be filled later. With KoalaSwap, you can mimic this by providing liquidity with a single asset within a chosen price range. For example, you can set a range order expecting it to execute when the market price reaches that range, then withdraw the target asset afterward.

Unlike traditional limit orders, which might charge fees, range orders on KoalaSwap earn fees for you while they’re being filled, since they’re a form of liquidity provisioning.

Possibilities of Range Orders

The AMM design enables some limit order styles but not others. Here are four examples with their traditional counterparts:

Take-Profit Orders: The current USDT/ETH price is 1,500 USDT/ETH. You want to sell ETH for USDT when the price hits 1,600 USDT/ETH. This works—provide ETH at 1,600, and it swaps to USDT when the price crosses your range.
Buy Limit Orders: The current USDT/ETH price is 1,500 USDT/ETH. You expect ETH to drop to 1,000 and rebound, so you provide USDT at 1,000 USDT/ETH. When the price falls, it swaps to ETH.

In KoalaSwap, assets are split above and below the current price: the higher-priced asset is above, the lower-priced asset is below.

The following styles can’t be replicated due to this separation:

Buy Stop Orders: Price is 1,500 USDT/ETH. You want to buy ETH at 2,000 USDT/ETH after it hits 2,000. This isn’t possible, as the range above 1,500 is in ETH, not USDT.
Stop-Loss Orders: Price is 1,500 USDT/ETH. You want to sell ETH for USDT at 1,000. This isn’t possible, as the range below 1,500 is in USDT, not ETH.

Important Note: If the price crosses your range and then reverses before you withdraw, your order won’t be fully filled. You’ll still earn LP fees during this time, but to exit fully in the target asset, monitor your position or use a third-party manager to withdraw when filled.

Fees

Fees from your liquidity position are paid in both tokens of the pair (e.g., ETH and USDT). After your range order executes, you’ll receive a small amount of both as rewards.

You can choose how wide your range is. A wider range might earn more fees if the price moves within it, but it increases the risk of the order staying unfilled if the price reverses.

Concentrated Liquidity

Introduction

The core feature of the KoalaSwap protocol is concentrated liquidity—liquidity that you can allocate within a custom price range. In earlier models, liquidity was spread evenly across all possible prices (from 0 to infinity), but much of it often went unused.

Take stablecoin pairs where the price stays close to 1:1. In the old system, only about 0.50% of the total liquidity was active in the typical range ($0.99–$1.01), where most trading happens. With KoalaSwap, liquidity providers can focus their capital in smaller, high-traffic ranges—like 0.99–1.01 for stablecoins. This gives traders deeper liquidity at the current price and lets LPs earn more fees. We call each focused range a position, and LPs can create multiple positions per pool to match their preferences.

Active Liquidity

As the price of an asset moves, it may leave the range you’ve set for a position. When this happens, your liquidity becomes inactive and stops earning fees. As traders swap, you’ll end up with more of one asset until your position holds only that asset. If the price returns to your range, the liquidity activates again, and you start earning fees.

LPs are free to create as many positions as they want, each with its own range. This lets the market naturally decide the best liquidity distribution, as rational LPs will focus their funds where they stay active.

Ticks

Concentrated liquidity works by dividing the price range into discrete steps called ticks. Each tick represents a small price change—about 0.01%—and acts as a boundary for your positions. When you create a position, you pick the lower and upper ticks to define its range.

As the price changes during a swap, the pool contract uses the liquidity within the current tick range, switching to the next tick when needed. This activates any dormant liquidity tied to that tick. The spacing between ticks depends on the pool’s fee level: lower fees allow tighter ticks, while higher fees have wider spacing.

Tighter tick spacing (common in stablecoin pools) improves capital efficiency, reduces price impact, and offers better swap prices. Crossing an active tick increases the transaction cost slightly, as it activates new liquidity.

Token Integration Issues

Fee-on-transfer Tokens

Fee-on-transfer tokens (tokens that automatically deduct a fee during transfers) are not supported by KoalaSwap router contracts. As a workaround, token creators can develop a token wrapper to disable the fee mechanism or create a custom router. Currently, KoalaSwap does not plan to add support for these tokens.

Rebasing Tokens

Rebasing tokens (tokens that automatically adjust their balances, like Ampleforth) can be used to create pools and perform swaps on KoalaSwap. However, liquidity providers (LPs) will bear losses from a negative rebase when their position is active, with no way to recover those losses. Be cautious when providing liquidity with rebasing tokens.

Guides

Get Started

How to Connect Wallet

🐨 KoalaSwap — How to Connect Wallet via MetaMask (If Not Installed) 1. Let's go to the Koalaswap website.

2. Then, click on the button “Connect” or “Connect wallet”.

3. In the modal window that opens, select “MetaMask”.

4. Next we are transferred to the MetaMask installation page. Click "install".

5. Next, you need to create a wallet in MetaMask or import an existing wallet. If you have any difficulties creating one, read the instructions on the website https://support.metamask.io/ru/start/getting-started-with-metamask/

6. After installing MetaMask, go to the KoalaSwap website, close the modal window.

And reload the page.

7. Again click on “Connect” or “Connect wallet”

The wallet will automatically connect to the site and add Unit Zero Mainnet network.

In case the network was not added automatically, it can be added manually via https://chainlist.org/chain/88811 (ChainID 88811).

8. After successful connection, the wallet address will be displayed in the upper right part of the screen

How to Swap Tokens

🐨 How to Swap Tokens on KoalaSwap

Token swapping is the process of exchanging one cryptocurrency for another through a decentralized liquidity pool — all without an intermediary.

1) Make sure you are connected to your wallet. 2) Select Tokens

In the Sell field, choose the token you want to swap (e.g., UNIT0)
In the Buy field, click "Choose a token" and select the token you want to receive (e.g., USDT, USDC, etc.)

Enter Amount

Enter how much you want to sell
The system will calculate how much you’ll get in return
And Click "Review"

3) Final Step At the bottom:

Check the box: “You confirm that you are performing the operation at your own risk.”
Then click Swap to complete the transaction.

Confirm the transaction in your wallet (MetaMask, etc.)
Wait for the swap to finalize. Your new tokens will appear in your wallet.

How to Provide Liquidity

🐨 KoalaSwap — Liquidity Provision Guide

How to add liquidity from all available pages & flows

✅ Case 1: Adding liquidity to a pool (no existing position) via https://koalaswap.app/explore/pools

🔹 Scenario: You don’t have an existing position and want to join an existing pool.

📍 Steps:

Go to the Pools page
Locate your desired pair (e.g., WBTC / WUNIT0)

3. Click the pool row to open the overview modal 4. Click “+ Add Liquidity”

5. Set: Price range (or choose "Full Range") Token amounts

6. Confirm in your wallet

🐨 You’ll create a brand new position in this pool, tailored to your parameters.

✅ Case 2: Adding liquidity to an existing position via /positions

🔹 Scenario: You already have a position and want to increase liquidity in it.

Go to the Positions page
Find the position you want to add to
Click the ⋮ icon
Select “Add Liquidity”
Input token amounts → Confirm

💡 Quick and efficient for experienced users.

🔸 Option B: From the detailed position page

Go to the Positions page
Click on the position row to open its detail view
Click “+ Add Liquidity”

4. Set token amounts and confirm

🧠 Ideal if you want to review the price range, earned fees, and other details first.

✅ Case 3: Step 1: Open the Pool Page

Go to the Pool Page and click "Add Liquidity".

Step 2: 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 3: 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

Volatile or exotic token pairs

Step 4: Click "Continue"

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

Step 5: 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 6: 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:

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.
Once entered: The “Review” button will become active.

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

🐨 KoalaSwap — Guide: How to Collect Fees

📍 When to use?

You have an active position that has earned fees
The Uncollected fees section shows non-zero values

🔸 Option 1: From the Positions List (via ⋯ Menu)

Visit https://koalaswap.app/positions
Find your active position
Click the ⋯ (three dots) at the end of the row
Choose Collect fees from the menu
Confirm the transaction
✅ Fees successfully collected

🔸 Option 1: From the Position Details Page

Go to the Positions page https://koalaswap.app/positions
Click on your position This will open the details view for that LP position.
Check the “Uncollected fees” section It displays how much fee you’ve earned in each token.
Click the "Collect fees" button
Confirm the transaction in your wallet Sign and pay gas fees to receive the rewards.
✅ Done! The tokens will be transferred to your wallet.

🐨 KoalaSwap — Guide: How to Remove Liquidity

📍 When to use?

You want to partially or fully withdraw your tokens from a position
You're closing or rebalancing your liquidity

🔹 Two Ways to Remove Liquidity

🔸 Option 1: From the Positions List (via ⋯ Menu)

Visit https://koalaswap.app/positions
Locate your position in the list
Click the ⋯ (three dots) on the right side of the row
Select Remove liquidity from the dropdown
Follow the steps to set the amount and confirm
✅ Liquidity successfully removed

🔸 Option 2: From the Position Details Page

Go to the Positions page https://koalaswap.app/positions
Select the position you want to edit Click on the pair to open its details.
Click the “Remove liquidity” button It’s in the top right corner of the position page.
Choose how much liquidity to remove You can select a percentage (e.g., 25%, 50%, 100%) or enter a custom amount.
Confirm the action Click Confirm and approve the transaction in your wallet.
✅ Done! The withdrawn tokens will appear in your wallet, and your position will be updated.

Pools Page

🐨 KoalaSwap — Pools Page

The Pools page on displays a list of available liquidity pools. These pools are the foundation of token swaps on the decentralized exchange. Users can provide liquidity to earn fees from trades that occur within the pool.

• Pool Displays the token pair in the liquidity pool. Example: USDT / WUNIT0 — this means the pool contains both tokens, and users can trade between them. Token icons and names make identification easier.

• Protocol Shows the version of the liquidity protocol used by the pool. Currently, KoalaSwap uses the KoalaSwap V3 protocol

• Pool Price The current exchange rate between the two tokens in the pool. Example: 1 USDT = 6.612 WUNIT0 — means that for each USDT, a user will receive ~6.612 WUNIT0.

• Fee The fee charged per swap in this specific pool. Example: 0.3% — indicates that 0.3% of each transaction is taken as a fee and distributed to liquidity providers based on their contribution.

• TVL (Total Value Locked) The total dollar value of tokens held in the pool. This metric reflects the overall liquidity depth. Higher TVL means lower slippage, more stable prices, and greater trader confidence.

Pool Detail Page

🐨 KoalaSwap — Guide to the Pool Details Page

📍 Example: USDT / WUNIT0 (0.3%) 🔗 This page appears when you click on a specific pool

🔎 What’s shown on the Pool Details page?

📊 Pool Activity Chart

Displays the distribution of liquidity or trading volume by day.

X-axis — Dates
Y-axis — Values (e.g., volume traded)

🔁 Action Buttons

Located in the top right corner:

Swap — Swap tokens directly in this pool
Add liquidity — Add liquidity to this pool

📈 Stats Section

Pool balance — current token amounts in the pool:
- 12,474.46 USDT
- 91,522.43 WUNIT0
TVL (Total Value Locked) — total pool value in USD (e.g., 19.41K)
24H Volume — trading volume over the last 24 hours
24H Fees — fees collected in the last 24 hours

🔗 Links (Contract Addresses)

Pool contract: USDT/WUNIT0
Token contracts: USDT and WUNIT0

You can copy these addresses to explore in a block explorer (e.g., Etherscan).

💱 Transactions (Transaction History)

Each entry includes:

Transaction hash (clickable link)
Timestamp
Action type
Amount in USD and tokens
Wallet

🧠 Tips

Use the Add liquidity button if you want to deposit tokens directly into this specific pool
Check TVL and volume to understand how active the pool is
Transaction history helps you see which types of activity (swaps, adds, removals) happen most often
Always double-check token and pool contract addresses before interacting

Transactions Page

🐨 KoalaSwap – Transactions Page The Transactions page on displays a list of the most recent token swap transactions made through the decentralized exchange. Users can see which tokens were swapped, the amounts, and other essential details.

📊 Table Columns Explained • Hash The transaction hash — a unique identifier for the transaction on the blockchain. Clicking it usually opens a blockchain explorer where you can view full transaction details.

• Time The time elapsed since the transaction was completed. For example, "11m 27s" means the transaction occurred 11 minutes and 27 seconds ago.

• Type The type of operation. This field always shows Swap, indicating that a token-to-token exchange was performed.

• USD The approximate value of the transaction in US dollars at the time of the swap. This value is calculated based on the exchange rate at the moment of execution.

• Token amount (1) The amount of tokens sent in the transaction. For example: 9.65 USDT.

• Token amount (2) The amount of tokens received in return. For example: 63.80 WUNIT0.

• Wallet The wallet address that initiated the transaction. This address is shown in a shortened format, displaying only the first and last characters (e.g. 0x7e0...82e2) for readability.

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

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:

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.
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: USDC / WUNIT0 (0.30%) Position

🔍 What’s Shown on This Page?

💧 Liquidity (Your deposited tokens)

Displays the amount of each token currently in the position:

USDC: 8.574461
WUNIT0: 5.4058671 This is your active liquidity in the pool.

💰 Uncollected Fees

Shows how much fee income you've earned but haven't claimed yet:

USDC: 0.00
WUNIT0: 0.00231883 👉 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: ∞
Current price: 0.63046144 WUNIT0 per USDC ⚠️ 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

Tokens Page

🐨 KoalaSwap — Tokens Page The Tokens on KoalaSwap page displays all tokens available within the KoalaSwap ecosystem. It provides a detailed view of each token’s performance and key metrics, helping users make informed decisions about trading, liquidity provision, or research. 📋 What’s on the Tokens Page? Each row in the table represents a token, along with useful trading and liquidity data.

🔘 Navigation Tabs

At the top, you’ll see three navigation options:

POOLS — View liquidity pools. TRANSACTIONS — Review recent activity/swaps. TOKENS — The current view, showing a list of tokens and statistics.

🔍 Search Bar

Enter token name — Allows you to filter tokens by name or symbol 📊 Token Table Each row in the table represents a single token. The following columns are included:

• Token name The name and logo of the token (e.g., Wrapped UNIT0, Test USDC).

• Price Current market price of the token (e.g., $1.00, $0.66).

• TVL (Total Value Locked) Total value locked in liquidity pools containing this token — an indicator of ecosystem trust and usage.

• Volume Trading volume over a recent period — shows activity and demand.

• FDV (Fully Diluted Valuation) The projected market cap assuming all tokens are in circulation — a measure of full potential valuation (e.g., $661.95B).

Token Detail Page

🐨 KoalaSwap — Token Detail Page

The Token Page is your central hub for everything related to a specific asset. Here, you can analyze price charts, view liquidity pools, track trading volume, and quickly execute swaps. Example: WUNIT0 (Wrapped UNIT0) 📈 Price Chart

Displays the token’s price trend over recent days.

🐨 Vertical axis — Price
📆 Horizontal axis — Date

🔄 Swap Box

Located on the right side of the page — enables instant buy/sell operations:

🐨 Sell / Buy — Input fields for amount
🔁 Direction Switcher — Flips token pair direction
🧮 Review — Previews the transaction before confirmation

📊 Token Stats

💧 TVL (Total Value Locked) — Total liquidity in USD → Higher TVL = safer trading and less slippage
🧮 FDV (Fully Diluted Valuation) — Market cap if all tokens were in circulation → Useful for assessing the project’s full scale
🔄 1 Day Volume — Trading volume over the last 24 hours → Helps evaluate market activity

🧠 Info Block

🧾 Token address — With a convenient copy button
🔍 Explore — Opens the token in a blockchain explorer
🛡️ Use this to verify contract authenticity

🧪 Pools

Below you’ll see a list of all active pools that include this token.

Field

Description

Pool

Name of the pool (e.g., USDT/WUNIT0)

Protocol

Protocol version (e.g., v3)

Pool price

Exchange rate in this pool

Fee

Pool fee (e.g., 0.30%)

TVL

Liquidity in the pool (in USD)

Click the pool name to go to its detailed view. TRANSACTIONS Tab

Shows the latest trades involving the token. Use it to monitor activity and detect large movements.

Developers

Contracts

Name

Address

Factory

0xcF3Ee60d29531B668Ae89FD3577E210082Da220b

SwapRouter

0x7A2044296804EDec53beAAA8fe9D802E5be19e0a

NFTDescriptor

0x799B69cEBFD0B61eecc6871d4781A20eeEe6765E

TokenDescriptor

0x6518BC0414a91636809bBeb5aF55d1Da5e68D8b0

NonfungiblePositionManager

0xa759C5ccF40acdf101BC6623f5b65363186a293b

Multicall

0x6c3d2c90d39A172Fa8aF1D975908cd0b83D230F0

Quoter

0x340dC35d8caA8F696df4BB79d3b9743e6D964E96

QuoterV2

0xA02C6705e8B54a27113aCc0283Fd3882582433dc

Deployer Address

0xc717Fb4e49258a0A6eD52c26Aee73E08E2B4e19D

Change Log

July, 2025

KoalaSwap Website Redesign Is Live - .

June, 2025

Official launch of KoalaSwap on the Unit Zero mainnet - .

Resources

Official links

Official website:
X account:
Telegram channel:
Telegram chat:

Support

You can reach out to us with any questions via:

Email: [email protected]
Telegram chat:

Glossary

Automated Market Maker

An automated market maker is a smart contract on Ethereum that holds liquidity reserves. Users can trade against these reserves at prices determined by a fixed formula. Anyone may contribute liquidity to these smart contracts, earning pro-rata trading fees in return.

Asset

While a digital asset can take many forms, the Koalswap Protocol supports ERC-20 token pairs, and represents a position in the form of an NFT (ERC-721).

Concentrated Liquidity

Liquidity that is allocated within a determined price range.

Core

Smart contracts that are considered foundational, and are essential for KoalaSwap to exist. Upgrading to a new version of core would require deploying an entirely new set of smart contracts on Ethereum and would be considered a new version of the KoalaSwap Protocol.

Factory

A smart contract that deploys a unique smart contract for any ERC20/ERC20 trading pair.

Flash Swap

A trade that uses the tokens purchased before paying for them.

Invariant

The “k” value in the constant product formula X*Y=K

Liquidity Provider / "LP"

A liquidity provider is someone who deposits ERC20 tokens into a given liquidity pool. Liquidity providers take on price risk and are compensated with trading fees.

Liquidity

Digital assets that are stored in a KoalaSwap pool contract, and are able to be traded against by traders.

Mid Price

The price between the available buy and sell prices. Observation

An instance of historical price and liquidity data of a given pair.

Periphery

External smart contracts that are useful, but not required for KoalaSwap to exist. New periphery contracts can always be deployed without migrating liquidity.

Pool

A contract deployed by the V3 factory that pairs two ERC-20 assets. Different pools may have different fees despite containing the same token pair. Pools were previously called Pairs before the introduction of multiple fee options.

Position

An instance of liquidity defined by upper and lower tick. And the amount of liquidity contained therein.

Price Impact

The difference between the mid-price and the execution price of a trade.

Protocol Fees

Fees that are rewarded to the protocol itself, rather than to liquidity providers.

Range

Any interval between two ticks of any distance.

Range Order

An approximation of a limit order, in which a single asset is provided as liquidity across a specified range, and is continuously swapped to the destination address as the spot price crosses the range.