> For the complete documentation index, see [llms.txt](https://docs.heyanon.ai/heyanon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heyanon.ai/heyanon.ai/hey-anon/protocols-and-functions-supported/defi-protocols/v3-pools-integration.md).

# V3 Pools Integration

## 🧠 Overview

**V3 Pools** is a protocol for managing **concentrated liquidity**—allowing liquidity providers and traders to operate with greater control, capital efficiency, and customizable strategies.

It enables:

* Precision liquidity management through custom price ranges
* Single-asset provision
* Fee earnings from trades within specified ranges
* Advanced pool analytics and real-time price tracking

***

## 🌐 Supported Networks & Protocols

V3 Pools is deployed across multiple EVM-compatible chains, each integrated with one of the following protocols:

| Network       | Protocol |
| ------------- | -------- |
| **KAVA**      | Wagmi    |
| **METIS**     | Wagmi    |
| **SONIC**     | Wagmi    |
| **IOTA EVM**  | Wagmi    |
| **BSC**       | Pancake  |
| **ETHEREUM**  | Uniswap  |
| **ARBITRUM**  | Uniswap  |
| **BASE**      | Uniswap  |
| **OPTIMISM**  | Uniswap  |
| **POLYGON**   | Uniswap  |
| **AVALANCHE** | Uniswap  |
| **ZKSYNC**    | Uniswap  |

> **Note**: Commands and behavior may vary slightly depending on the underlying protocol used on each network.

***

## ✨ Main Features

* ✅ Create concentrated liquidity pools
* 💧 Add and manage liquidity positions
* 🧩 Single-sided liquidity provision
* 🔄 Adjust liquidity in existing positions
* 💸 Collect earned fees from trades
* 🎯 Manage price ranges for liquidity
* 📈 Monitor real-time and historical pool prices
* 📊 Access detailed position and pool analytics

***

## ⚙️ Core Operations

### 1. Pool Creation

* Create new pools with token pairs
* Define initial price (depends on token order)
* Choose fee tiers

```bash
# USDT as token0, KAVA as token1
create pool usdt/kava 0.3% with initial price 2.48 @v3pools on kava chain

# KAVA as token0, USDT as token1
create pool kava/usdt 0.3% with initial price 0.4 @v3pools on kava chain
```

***

### 2. Position Management

#### 🔧 Create Positions

```bash
create position usdt/kava 0.15% fee with 2 usdt and 10.14 kava with price range 0.61917 - 4.3385 @v3pools
```

#### 🧩 Single-Sided Liquidity

```bash
create single side position usdt/kava 0.15% fee with 2 usdt with price range 3.5806 - 3.8134 @v3pools
```

#### ➕ Increase Liquidity

```bash
increase liquidity of position 5907 with 2 usdt and 19.7903 kava @v3pools
```

#### ➖ Decrease Liquidity

```bash
decrease liquidity of position 5907 for 10% @v3pools
```

***

### 3. Fee Collection

```bash
collect fees from positions 5907, 5908, 5909 @v3pools
```

***

### 4. Price Range Management

Set and manage price ranges with full control:

* Custom ranges
* Predefined modes: `risky (1%)`, `wide (5%)`, `safe (10%)`

```bash
show me safe price range for wkava/usdt fee pool @v3pools
```

***

### 5. Pool Price Monitoring

```bash
get current price of the pool wkava/usdt 0.15% fee @v3pools
```

***

### 6. Position Analytics

#### 📋 Get All Position IDs

```bash
get all positions ids @v3pools on kava chain
```

#### 📑 Get Detailed Info

```bash
get detailed info about position 5907 @v3pools on kava chain
```

***

## 📐 Estimations and Calculations

### Estimate for Position Creation

```bash
estimate amounts for position creation usdt/kava 0.15% fee with 2 usdt with price range 0.61917 - 4.3385 @v3pools
```

### Estimate for Liquidity Increase

```bash
estimate amounts for increase liquidity of position 5907 with 100 kava @v3pools
```

***

## 🧠 Advanced Features

### 🔎 Price Range Optimization

* **Risky** – tight range for high capital efficiency
* **Wide** – moderate balance of safety and fees
* **Safe** – large range to stay active longer

### 📊 Analytics & Tracking

* View pool and position history
* Live price feed
* Price impact analysis

***

## 🧪 Example Operations

### 🔗 Get Supported Chains

```bash
get supported chains @v3pools
```

### ➕ Create Position (Default Pool)

```bash
create position usdt/kava with 2 usdt and 10.14 kava with price range 0.61917 - 4.3385 @v3pools
```

### 💰 Single Price Point

```bash
create single side position usdt/kava 0.15% fee with 2 usdt with price 3.5806 @v3pools
```

***

## 🧭 Tips

* **Token Order Matters**: Always specify the correct order when creating pools or positions.
* **Use Estimations**: Use `estimate amounts` before providing or increasing liquidity to get optimal inputs.
* **Monitor Actively**: Keep an eye on your price ranges and update them based on market changes.
* **Diversify**: Try using multiple predefined price strategies across different pools.

***