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

# 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

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

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

โž• Increase Liquidity

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

โž– Decrease Liquidity

decrease liquidity of position 5907 for 10% @v3pools

3. Fee Collection

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%)

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

5. Pool Price Monitoring

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

6. Position Analytics

๐Ÿ“‹ Get All Position IDs

get all positions ids @v3pools on kava chain

๐Ÿ“‘ Get Detailed Info

get detailed info about position 5907 @v3pools on kava chain

๐Ÿ“ Estimations and Calculations

Estimate for Position Creation

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

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

get supported chains @v3pools

โž• Create Position (Default Pool)

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

๐Ÿ’ฐ Single Price Point

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.