# 3. Liquidity Management

### Overview

Liquidity management on SwapMOS enables users to supply assets to liquidity pools, facilitate decentralized trading, and earn a proportional share of swap fees.

Liquidity providers (LPs) deposit token pairs into AMM-based smart contract pools and receive LP tokens representing their proportional ownership of the pool.

All liquidity operations are executed fully on-chain on the ClubMOS Blockchain and remain non-custodial at all times.

***

## Providing Liquidity

### Step 1: Access the Pools Interface

Navigate to the **Pools** section within the SwapMOS platform.

This dashboard displays:

* Available liquidity pools
* Total Value Locked (TVL)
* Trading volume metrics
* Your active liquidity positions (if connected)

***

### Step 2: Connect Your Wallet

Click **Connect Wallet** and link your ClubMOS-compatible wallet.

Once connected, you can:

* Add liquidity
* View LP positions
* Remove liquidity at any time

SwapMOS never has access to your private keys.

***

### Step 3: Select a Token Pair

Choose the two assets you want to provide liquidity for.

Example:

`CMX / TIA`

Liquidity can be added to any supported token pair with an existing pool or by initializing a new pool.

***

### Step 4: Enter Deposit Amounts

Enter the amount of one token.

If the pool already exists, SwapMOS automatically:

* Calculates the required amount of the second token
* Maintains the current reserve ratio
* Ensures equal-value deposits

This preserves the AMM pricing invariant and prevents price distortion.

Example:

If depositing 40 TIA, the platform calculates the corresponding CMX amount automatically based on current pool reserves.

If creating a new pool, the initial liquidity provider defines the starting price ratio.

***

### Step 5: Token Approval

Before adding liquidity, both tokens must be approved for smart contract interaction.

Approval is:

* A one-time on-chain transaction per token
* Required to authorize token transfers into the pool
* Fully controlled by the user

***

### Step 6: Confirm & Add Liquidity

Review all parameters:

* Token deposit amounts
* Pool share percentage
* Estimated position value
* Transaction fee

Click **Confirm**.

Upon execution:

* Tokens are deposited into the liquidity pool
* LP tokens are minted to your wallet
* Your liquidity position becomes active
* Fee accrual begins immediately

***

## Monitoring Liquidity Positions

From the Pools dashboard, you can monitor:

* Pool share percentage
* Accrued trading fees
* Current pool value
* Position performance
* Historical transactions

All metrics are derived directly from on-chain data.

***

## Removing Liquidity

Liquidity may be withdrawn partially or fully at any time.

***

### Step 1: Connect Wallet

Ensure your wallet is connected.

***

### Step 2: Select Liquidity Pool

Choose the pool you want to withdraw from.

Example:

`CMX / TIA`

***

### Step 3: Choose Withdrawal Amount

Click **Remove Liquidity** and select the percentage of your LP position to redeem.

Example:

Withdraw 50% of your position.

***

### Step 4: Approve LP Tokens

Approve your LP tokens to authorize redemption.

This allows the smart contract to burn LP tokens and release underlying assets.

***

### Step 5: Confirm & Remove Liquidity

Review:

* Tokens to be received
* Earned fees included
* Updated balances
* Network fee

Click **Confirm**.

Upon completion:

* LP tokens are burned
* Underlying assets are returned to your wallet
* Earned fees are distributed proportionally
* The transaction is finalized on-chain

***

### Risk Considerations

Liquidity provision involves:

#### Impermanent Loss

Occurs when the price ratio between CMX and TIA changes relative to holding assets independently.

#### Market Volatility

High volatility may impact pool value and returns.

#### Variable Yield

Earnings depend on trading volume and total pool liquidity.

***

## Summary

SwapMOS liquidity management enables users to:

* Provide capital to decentralized markets
* Earn proportional trading fees
* Maintain full asset control
* Enter and exit liquidity positions freely

Built on the AMM framework of the ClubMOS Blockchain, SwapMOS delivers transparent, flexible, and fully on-chain liquidity participation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://clubmos.gitbook.io/swapmos/3.-liquidity-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
