Liquidity Planner

Optional but useful:

Step 2: Token Discovery & Resolution

A. DexScreener Token Search

# Search by keyword — returns pairs across all DEXes
Use single quotes for KEYWORD to prevent shell injection
KEYWORD='pancake'
CHAIN="bsc"   # DexScreener chainId: bsc, ethereum, arbitrum, base, zksync, linea, opbnb
curl -s -G "https://api.dexscreener.com/latest/dex/search" --data-urlencode "q=$KEYWORD" | \
  jq --arg chain "$CHAIN" '[
    .pairs[]
    | select(.chainId == $chain and .dexId == "pancakeswap")
    | {
        name: .baseToken.name,
        symbol: .baseToken.symbol,
        address: .baseToken.address,
        priceUsd: .priceUsd,
        liquidity: (.liquidity.usd // 0),
        volume24h: (.volume.h24 // 0),
        labels: (.labels // [])
      }
  ]
  | sort_by(-.liquidity)
  | .[0:5]'

Step 4: Discover Pools on PancakeSwap (DexScreener)

TOKEN_A="0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82"  # CAKE
TOKEN_B="BNB"
CHAIN_ID="bsc"
[[ "$TOKEN_A" =~ ^0x[0-9a-fA-F]{40}$ ]] || { echo "Invalid token A address"; exit 1; }
Find all PancakeSwap pairs for TOKEN_A (filter by quote token in jq)
curl -s "https://api.dexscreener.com/latest/dex/tokens/${TOKEN_A}" | \
  jq --arg dex "pancakeswap" --arg chain "$CHAIN_ID" '.pairs[]
    | select(.dexId == $dex and .chainId == $chain)
    | {
        pairAddress: .pairAddress,
        poolVersion: (if ((.labels // []) | any(. == "v3")) then "v3" elif ((.labels // []) | any(. == "v1")) then "v1" else "v2" end),
        labels: (.labels // []),
        liquidity: .liquidity.usd,
        volume24h: .volume.h24,
        priceUsd: .priceUsd,
        priceChange24h: .priceChange.h24
      }'

Key insights:

Step 5: Assess Pool Liquidity & Market Quality

After discovering pools, fetch depth metrics:

# For a specific pair on PancakeSwap
PAIR="0xA527819e89CA0145Fb2e9e03396e088f67Dc4bcc"  # CAKE-BNB example
curl -s "https://api.dexscreener.com/latest/dex/pairs/bsc/${PAIR}" | \
  jq '.pairs[0] | {
    liquidity: .liquidity.usd,
    volume24h: .volume.h24,
    priceUsd: .priceUsd,
    priceChange24h: .priceChange.h24,
    baseToken: .baseToken.symbol,
    quoteToken: .quoteToken.symbol,
    labels: (.labels // []),
    poolVersion: (if ((.labels // []) | any(. == "v3")) then "v3" elif ((.labels // []) | any(. == "v1")) then "v1" else "v2" end)
  }'

Liquidity assessment:

Step 6: Fetch APY & Reward Metrics (DefiLlama)

Fetch yield data to inform position recommendations:

# Projects: "pancakeswap-amm" (V2), "pancakeswap-amm-v3" (V3)
.symbol contains token names like "CAKE-WBNB". .pool is a UUID — do NOT filter on .pool.
Note: BSC pools may only appear under "pancakeswap-amm" — query both projects.
curl -s "https://yields.llama.fi/pools" | \
  jq '.data[]
    | select(.project == "pancakeswap-amm-v3" or .project == "pancakeswap-amm")
    | select(.chain == "BSC" or .chain == "Binance")
    | {
        pool: .symbol,
        chain: .chain,
        project: .project,
        apy: .apy,
        apyBase: .apyBase,
        apyReward: .apyReward,
        tvlUsd: .tvlUsd,
        underlyingTokens: .underlyingTokens
      }'

Yield tiers for PancakeSwap V3 positions:

| APY Range | Liquidity Quality | Risk Level | Recommendation | | --------------- | ----------------- | ---------- | ------------------------------- | | 50%+ APY | Thin/risky | Very High | Warn: IL likely > yield | | 20%–50% APY | Adequate | High | Concentrated positions only | | 5%–20% APY | Good | Moderate | Best for wide range positions | | 1%–5% APY | Excellent/deep | Low | Stablecoin pairs, large caps | | < 1% APY | Massive TVL | Very Low | Fee-based yield only (base APY) |

Step 7: Recommend Price Ranges & IL Assessment

Impermanent Loss Reference Table

| Price Range (from current) | IL at 2x move | IL at 5x move | | --------------------------- | ------------- | ------------- | | Full range (±∞) | 0% | 0% | | ±50% | 0.6% | 5.7% | | ±25% | 0.2% | 1.8% | | ±10% | 0.03% | 0.31% | | ±5% | 0.008% | 0.078% |

Recommendations by LP profile:

1. Conservative (Broad Range): ±50% around current price - Low IL risk, low APY, minimal rebalancing - Suitable for: Stable assets (USDT/USDC), large-cap pairs (ETH/BNB) - Estimated APY impact: −40% vs. full range

2. Balanced (Medium Range): ±25% around current price - Moderate IL, moderate APY, periodic rebalancing - Suitable for: Mid-cap tokens (CAKE), correlated pairs - Estimated APY impact: −20% vs. full range

3. Aggressive (Tight Range): ±10% around current price - High IL risk, high APY, frequent rebalancing required - Suitable for: High-volume pairs, experienced LPs - Estimated APY impact: +50%–100% vs. full range, but IL risk increases sharply

Price Range Formula (V3)

CURRENT_PRICE=2.5  # CAKE/BNB, for example
RANGE_PCT=0.25     # ±25%
LOWER_BOUND=$(echo "$CURRENT_PRICE * (1 - $RANGE_PCT)" | bc)
UPPER_BOUND=$(echo "$CURRENT_PRICE * (1 + $RANGE_PCT)" | bc)
echo "Recommended range: $LOWER_BOUND – $UPPER_BOUND"

Step 8: Fee Tier Selection Guide

V3 Fee Tiers — When to Use Each

| Fee Tier | Tick Spacing | Best For | Trading Volume | IL Risk | | -------- | ------------ | ------------------------------------------- | --------------- | ------- | | 0.01% | 1 | Stablecoin pairs (USDC/USDT, USDC/DAI) | Very high | Very low | | 0.05% | 10 | Correlated pairs (stablecoin + USDC bridge) | High | Low | | 0.25% | 50 | Large caps (CAKE, BNB, ETH), established | Moderate-high | Medium | | 1.0% | 200 | Small caps, emerging tokens, volatile pairs | Lower | Medium-high |

Decision tree:

Is this a stablecoin pair (USDT/USDC, USDT/BUSD)?
  YES → Use 0.01% (almost zero slippage for swappers, best LP capture)
Is this a large-cap, high-volume pair (CAKE/BNB, ETH/USDC)?
  YES → Use 0.25% (default, proven track record)
Is the second token volatile or new?
  YES → Use 1.0% (higher swap fees compensate for IL risk)
Is the pair correlated but not strictly stable (e.g., BNB/ETH)?
  YES → Use 0.05%–0.25% (balance precision with IL mitigation)

V2 (BSC Only)

StableSwap (BSC Only)

Step 9: Generate Deep Links

V3 Deep Link Format

https://pancakeswap.finance/add/{tokenA}/{tokenB}/{feeAmount}?chain={chainKey}

Parameters:

When to Recommend StableSwap

When NOT to Recommend StableSwap

StableSwap Deep Link

https://pancakeswap.finance/stable/add/0x55d398326f99059fF775485246999027B3197955/0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d?chain=bsc

PancakeSwap Farming & Rewards

Users can also earn CAKE farming rewards on their LP positions:

Mention these opportunities when discussing position management:

> For Infinity pools: "Your position will automatically start earning CAKE farming rewards as soon as you add liquidity — no extra staking step needed. Rewards are claimable every 8 hours." > > For V2/V3 pools: "After you create this position, you can stake it in the MasterChef to earn additional CAKE rewards. Check the farm page for current APY boosts."

Input Validation & Security

Before generating any deep link, confirm:

Output Format

Present the LP plan in this structure:

✅ Liquidity Plan
Chain:           BNB Smart Chain (BSC)
Pool Version:    PancakeSwap V3
Token A:         CAKE (0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82)
Token B:         BNB (native)
Fee Tier:        0.25% (2500 basis points)
Recommended Range: 2.0–3.0 CAKE/BNB (±25% from current 2.5)
Pool Metrics:
  Total Liquidity:  $45.2M
  24h Volume:       $12.5M
  Base APY:         6.2%
  Recommended APY:  7–9% with concentrated position in range
IL Assessment:
  Current Price:    2.5 CAKE/BNB
  Price move +2x:   −0.6% IL
  Price move +5x:   −5.7% IL
  → Acceptable for this high-volume pair
Deposit Recommendation:
  Token A (CAKE):   10 CAKE (~$25 USD)
  Token B (BNB):    4 BNB (~$1,000 USD)
  Total Value:      ~$1,250 USD
Farm Options:
  V2/V3: After creating the position, stake it in MasterChef for CAKE rewards (separate step)
  Infinity: Farming is automatic — no separate staking needed!
  Current farm APY: 12–15% (includes CAKE rewards)
⚠️  Warnings:
  • Monitor price within your range; if it moves > ±25%, rebalancing may be needed
  • Farm rewards are in CAKE; consider selling or restaking to compound
  • Fee captures only if 24h volume > $10M on this pair
🔗 Open in PancakeSwap:
https://pancakeswap.finance/add/0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82/BNB/2500?chain=bsc

Attempt to Open Browser

# macOS
open "https://pancakeswap.finance/add/..."
Linux
xdg-open "https://pancakeswap.finance/add/..."
Windows (Git Bash)
start "https://pancakeswap.finance/add/..."

If the open command fails, display the URL prominently so the user can copy it.

Safety Checklist

Before presenting a deep link to the user, confirm all of the following:

References