Liquidity Pools

Instant trading via Meteora dynamic AMM.

Overview

Etch automatically creates a Meteora liquidity pool when you launch a token. This provides:

Immediate trading capability
Price discovery
Fee generation for you and LPs

How It Works

Reserve allocation — Part of your reserve goes to liquidity
SOL pairing — Tokens are paired with SOL (you provide initial SOL)
Pool creation — Meteora pool is created on-chain
LP tokens — You receive LP tokens representing your position

Configuration


{
  "name": "MyToken",
  "ticker": "MTK",
  "totalSupply": 1000000000,
  "reservePercent": 20,
  "liquidityConfig": {
    "percent": 50,        // 50% of reserve goes to liquidity
    "initialSolAmount": 10 // 10 SOL paired with tokens
  }
}

Supply Distribution Example

With 1B total supply and 20% reserve:


Total Supply:        1,000,000,000 MTK
├── Circulating:       800,000,000 MTK (80%)
└── Reserve:           200,000,000 MTK (20%)
    ├── Liquidity:     100,000,000 MTK (50% of reserve)
    │   └── Paired with 10 SOL
    └── Vesting:       100,000,000 MTK (50% of reserve)

Initial price = 10 SOL / 100,000,000 MTK = 0.0000001 SOL per MTK

Pool Information

After launch, get pool details:


curl https://etch.film.fun/api/pool/POOL123... \
  -H "Authorization: Bearer TOKEN"

Response:


{
  "pool": "POOL123...",
  "lpMint": "LP456...",
  "tokenA": {
    "mint": "MTK789...",
    "symbol": "MTK",
    "amount": 100000000
  },
  "tokenB": {
    "mint": "So11111111111111111111111111111111111111112",
    "symbol": "SOL",
    "amount": 10000000000
  },
  "lpSupply": 31622776601,
  "yourLpBalance": 31622776601,
  "fees": {
    "tradeFee": "0.25%",
    "protocolFee": "0.05%"
  },
  "tvl": {
    "usd": 1500.00,
    "sol": 10.0
  },
  "volume24h": {
    "usd": 5000.00
  }
}

Claiming LP Fees

As a liquidity provider, you earn a portion of trading fees:


curl -X POST https://etch.film.fun/api/fees/MTK789.../claim \
  -H "Authorization: Bearer TOKEN"

Response:


{
  "claimed": {
    "MTK": 50000,
    "SOL": 0.05
  },
  "signature": "5abc..."
}

Pool Management

Adding Liquidity

Add more liquidity after launch:


curl -X POST https://etch.film.fun/api/pool/POOL123.../add \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amountA": 10000000,
    "amountB": 1000000000,
    "slippage": 0.5
  }'

Removing Liquidity

Withdraw your LP position:


curl -X POST https://etch.film.fun/api/pool/POOL123.../remove \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lpAmount": 1000000000,
    "minAmountA": 9500000,
    "minAmountB": 950000000
  }'

Trading via Meteora

Your token is tradeable on:

Meteora app: meteora.ag
Jupiter aggregator: jup.ag
Any Solana DEX that aggregates Meteora pools

Fee Structure

Fee	Rate	Recipient
Trade fee	0.25%	LP holders
Protocol fee	0.05%	Meteora

Example: On a 100 SOL trade:

0.25 SOL goes to LP holders
0.05 SOL goes to Meteora
99.70 SOL is swapped

Best Practices

Sufficient initial liquidity — At least 5-10 SOL recommended
Consider price impact — Low liquidity = high slippage
Monitor your position — Track IL (impermanent loss)
Claim fees regularly — Don’t let fees accumulate too long
Lock liquidity — Consider locking LP tokens for trust

Liquidity Locking

To prove commitment, lock your LP tokens:


curl -X POST https://etch.film.fun/api/pool/POOL123.../lock \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lpAmount": 1000000000,
    "unlockTime": "2027-02-15T00:00:00Z"
  }'

Locked liquidity is displayed publicly and cannot be removed until unlockTime.