# 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.

***


---

# 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://docs.heyanon.ai/heyanon.ai/hey-anon/protocols-and-functions-supported/defi-protocols/v3-pools-integration.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.