clodds 1.2.9 → 1.4.0

package/dist/skills/bundled/pump-swarm/SKILL.md

@@ -0,0 +1,309 @@
+---
+name: pump-swarm
+description: "Coordinated multi-wallet trading on Pump.fun"
+command: swarm
+emoji: "🐝"
+gates:
+  envs:
+    - SOLANA_PRIVATE_KEY
+---
+
+# Pump.fun Swarm Trading
+
+Coordinate up to **20 wallets** to execute synchronized trades on Pump.fun tokens.
+
+## Quick Start
+
+```bash
+# Set up wallets
+export SOLANA_PRIVATE_KEY="your-main-wallet-key"     # wallet_0
+export SOLANA_SWARM_KEY_1="second-wallet-key"        # wallet_1
+export SOLANA_SWARM_KEY_2="third-wallet-key"         # wallet_2
+# ... up to SOLANA_SWARM_KEY_20
+
+# Optional
+export SOLANA_RPC_URL="https://your-rpc.com"
+export PUMPPORTAL_API_KEY="your-api-key"
+```
+
+## Commands
+
+### Wallet Management
+
+```
+/swarm wallets              List all swarm wallets with addresses
+/swarm balances             Fetch SOL balances from chain
+/swarm enable <wallet_id>   Enable a wallet for trading
+/swarm disable <wallet_id>  Disable a wallet
+```
+
+### Trading
+
+```
+/swarm buy <mint> <sol> [options]      Buy with all enabled wallets
+/swarm sell <mint> <amount|%> [opts]   Sell from wallets with positions
+```
+
+### Position Management
+
+```
+/swarm position <mint>      Show cached token positions
+/swarm refresh <mint>       Fetch fresh positions from chain (required before sell)
+```
+
+## Execution Modes
+
+| Mode | Flag | Best For | Description |
+|------|------|----------|-------------|
+| **Parallel** | `--parallel` | Speed (>5 wallets) | All wallets execute simultaneously |
+| **Bundle** | `--bundle` | Atomicity (≤5) | Single Jito bundle, all-or-nothing |
+| **Multi-Bundle** | `--multi-bundle` | Atomicity (6-20) | Multiple Jito bundles in parallel |
+| **Sequential** | `--sequential` | Stealth | Staggered 200-400ms delays |
+
+### Auto Mode Selection (Default)
+- 1 wallet → Parallel (direct submit)
+- 2-5 wallets → Single Jito Bundle
+- 6-20 wallets → Multi-Bundle (chunks of 5)
+
+## Other Options
+
+| Option | Description |
+|--------|-------------|
+| `--preset <name>` | Apply a saved preset |
+| `--wallets <id1,id2>` | Use specific wallets only |
+| `--slippage <bps>` | Slippage tolerance (default: 500 = 5%) |
+| `--pool <pool>` | Pool: pump, raydium, auto (pumpfun only) |
+| `--dex <dex>` | DEX: pumpfun (default), bags, meteora |
+| `--pool-address <addr>` | Specific pool address (for Meteora) |
+
+## Examples
+
+```bash
+# Buy 0.1 SOL worth on each enabled wallet (auto mode)
+/swarm buy ABC123mint... 0.1
+
+# Buy with specific wallets only
+/swarm buy ABC123mint... 0.2 --wallets wallet_0,wallet_1
+
+# Buy with a preset
+/swarm buy ABC123mint... 0.1 --preset stealth
+
+# Sell 100% with multiple Jito bundles (for >5 wallets)
+/swarm sell ABC123mint... 100% --multi-bundle
+
+# Sell 50% with staggered timing (stealth mode)
+/swarm sell ABC123mint... 50% --sequential
+
+# Sell with preset
+/swarm sell ABC123mint... 100% --preset fast
+
+# Check positions before selling
+/swarm refresh ABC123mint...
+/swarm position ABC123mint...
+
+# Multi-DEX examples
+/swarm buy ABC123mint... 0.1 --dex bags          # Buy on Bags.fm
+/swarm buy ABC123mint... 0.1 --dex meteora       # Buy on Meteora DLMM
+/swarm sell ABC123mint... 100% --dex bags        # Sell on Bags.fm
+```
+
+## Execution Modes Deep Dive
+
+### Parallel (Default for >5 wallets)
+- **Speed:** All wallets submit simultaneously via `Promise.all`
+- **Risk:** No atomicity - some may succeed, others fail
+- **Use when:** Speed is priority, or bundles keep failing
+
+### Jito Bundle (Default for 2-5 wallets)
+- **Atomic:** All transactions succeed or all fail together
+- **MEV-protected:** No front-running between your own wallets
+- **Cost:** ~10,000 lamports tip per bundle
+- **Limit:** Max 5 transactions per bundle (Jito constraint)
+
+### Multi-Bundle (Recommended for 6-20 wallets)
+- **Chunked:** Splits wallets into groups of 5
+- **Parallel bundles:** All chunks submit simultaneously
+- **Partial atomicity:** Each chunk is atomic, but chunks are independent
+- **Example:** 12 wallets → 3 bundles of [5, 5, 2] wallets
+
+### Sequential (Stealth mode)
+- **Staggered:** 200-400ms random delay between wallets
+- **Amount variance:** ±5% to avoid detection patterns
+- **Rate limited:** 5 seconds minimum between trades per wallet
+- **Use when:** Want to avoid pattern detection
+
+## How It Works
+
+### Buy Flow
+1. Refreshes SOL balances from chain
+2. Filters wallets with sufficient balance (≥0.01 SOL + amount)
+3. Builds transaction for each wallet via PumpPortal API
+4. Signs all transactions locally
+5. Submits via selected execution mode
+6. Reports results per wallet
+
+### Sell Flow
+1. **Fetches actual token balances from chain** (critical!)
+2. Filters wallets with positions
+3. Calculates sell amount (% of position or exact)
+4. Builds and signs transactions
+5. Submits via selected execution mode
+6. Reports results per wallet
+
+## Safety Features
+
+- **Balance check:** Verifies sufficient SOL before buy
+- **Position check:** Fetches real token balances before sell
+- **Max amount:** Rejects buy amounts > 10 SOL per wallet
+- **Confirmation timeout:** 60 second timeout per transaction
+- **Error reporting:** Shows detailed errors per wallet
+- **Bundle fallback:** Failed bundles automatically retry as parallel
+
+## Configuration
+
+| Env Variable | Description |
+|--------------|-------------|
+| `SOLANA_PRIVATE_KEY` | Main wallet (wallet_0) |
+| `SOLANA_SWARM_KEY_1..20` | Additional swarm wallets |
+| `SOLANA_RPC_URL` | Custom RPC endpoint (faster = better) |
+| `PUMPPORTAL_API_KEY` | PumpPortal API key (optional, for pumpfun) |
+| `BAGS_API_KEY` | Bags.fm API key (required for bags DEX) |
+
+## Multi-DEX Support
+
+The swarm system supports trading across multiple DEXes:
+
+| DEX | Flag | Best For | Requires |
+|-----|------|----------|----------|
+| Pump.fun | `--dex pumpfun` (default) | Memecoins, new launches | `PUMPPORTAL_API_KEY` (optional) |
+| Bags.fm | `--dex bags` | Bags-launched tokens | `BAGS_API_KEY` |
+| Meteora | `--dex meteora` | DLMM pools, concentrated liquidity | - |
+
+### Multi-DEX Examples
+
+```bash
+# Buy on Pump.fun (default)
+/swarm buy ABC123... 0.1
+
+# Buy on Bags.fm
+/swarm buy ABC123... 0.1 --dex bags
+
+# Buy on Meteora with specific pool
+/swarm buy ABC123... 0.1 --dex meteora --pool-address <pool_address>
+
+# Sell on Bags.fm with stealth preset
+/swarm sell ABC123... 100% --dex bags --preset stealth
+```
+
+### Notes
+- Default DEX is `pumpfun` for backward compatibility
+- Bags requires `BAGS_API_KEY` - will error if missing
+- Meteora can auto-discover pools or use a specific `--pool-address`
+- All execution modes (parallel, bundle, sequential) work with all DEXes
+- Presets work with all DEXes
+
+## Agent Tools (12)
+
+| Tool | Description |
+|------|-------------|
+| `swarm_wallets` | List all swarm wallets |
+| `swarm_balances` | Refresh SOL balances from chain |
+| `swarm_buy` | Coordinated buy across wallets (supports `preset` param) |
+| `swarm_sell` | Coordinated sell across wallets (supports `preset` param) |
+| `swarm_position` | Get cached positions |
+| `swarm_refresh` | Fetch fresh positions from chain |
+| `swarm_enable` | Enable a wallet |
+| `swarm_disable` | Disable a wallet |
+| `swarm_preset_save` | Save a trading preset |
+| `swarm_preset_list` | List saved presets |
+| `swarm_preset_get` | Get preset details |
+| `swarm_preset_delete` | Delete a preset |
+
+## Scaling Notes
+
+- **Max wallets:** 20 (wallet_0 + SOLANA_SWARM_KEY_1..20)
+- **Jito bundle limit:** 5 txs per bundle (handled automatically)
+- **Multi-bundle parallel:** All bundles submit simultaneously
+- **RPC recommendation:** Use dedicated RPC for best performance
+- **Tip amount:** 10,000 lamports per bundle (~$0.002)
+
+## Presets
+
+Save and reuse trading configurations across tokens and strategies.
+
+### Preset Commands
+
+```bash
+/swarm preset save <name> [options]   Save a preset
+/swarm preset list [type]             List presets
+/swarm preset show <name>             Show preset details
+/swarm preset delete <name>           Delete a preset
+```
+
+### Preset Save Options
+
+| Option | Description |
+|--------|-------------|
+| `--type <type>` | Preset type: strategy, token, wallet_group |
+| `--desc "..."` | Preset description |
+| `--mint <addr>` | Token address (for token presets) |
+| `--amount <sol>` | Default SOL per wallet |
+| `--slippage <bps>` | Slippage in basis points |
+| `--pool <pool>` | Pool: pump, raydium, auto |
+| `--mode <mode>` | parallel, bundle, multi-bundle, sequential |
+| `--wallets <ids>` | Wallet IDs (for wallet_group presets) |
+
+### Built-in Presets
+
+| Name | Mode | Slippage | Pool | Use Case |
+|------|------|----------|------|----------|
+| `fast` | parallel | 5% | auto | Speed priority |
+| `atomic` | multi-bundle | 5% | auto | All-or-nothing execution |
+| `stealth` | sequential | 3% | auto | Pattern avoidance |
+| `aggressive` | parallel | 10% | pump | High volatility tokens |
+| `safe` | bundle | 2% | auto | Conservative trading |
+
+### Preset Examples
+
+```bash
+# Create a custom strategy preset
+/swarm preset save my_stealth --type strategy --mode sequential --slippage 300
+
+# Create a token preset for BONK
+/swarm preset save bonk_entry --type token --mint DezXAZ... --slippage 1000 --amount 0.1
+
+# Create a wallet group preset
+/swarm preset save top5 --type wallet_group --wallets wallet_0,wallet_1,wallet_2,wallet_3,wallet_4
+
+# List all presets
+/swarm preset list
+
+# List only strategy presets
+/swarm preset list strategy
+
+# Use preset in trade
+/swarm buy ABC... 0.1 --preset my_stealth
+/swarm sell ABC... 100% --preset fast
+
+# Delete a preset
+/swarm preset delete old_preset
+```
+
+### Preset Types
+
+| Type | Purpose |
+|------|---------|
+| `strategy` | Reusable trading settings (mode, slippage, pool) |
+| `token` | Token-specific settings with saved mint address |
+| `wallet_group` | Named wallet combinations for specific trades |
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Bundle keeps failing | Try `--parallel` or check network congestion |
+| Positions not showing | Run `/swarm refresh <mint>` first |
+| Insufficient balance | Check with `/swarm balances` |
+| Slow execution | Use dedicated RPC via `SOLANA_RPC_URL` |
+| Some wallets skipped | Wallet disabled or insufficient balance |
+| Preset not found | Check name with `/swarm preset list` |

package/dist/skills/bundled/pumpfun/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: pumpfun
+description: "Pump.fun - Complete Solana memecoin launchpad. Discovery, trending, gainers, losers, token data all work without a key. Trading requires SOLANA_PRIVATE_KEY."
+command: pump
+emoji: "🚀"
+---
+
+# Pump.fun - Complete API Coverage (32 Tools)
+
+Pump.fun is the leading Solana memecoin launchpad with bonding curve trading.
+
+## Trading
+
+```
+/pump buy <mint> <amount> [options]     Buy tokens (amount in SOL)
+/pump sell <mint> <amount|%> [options]  Sell tokens (amount or percentage)
+/pump quote <mint> <amount> <action>    Get swap quote
+```
+
+**Options:**
+- `--pool <pool>` - Pool: pump, raydium, pump-amm, launchlab, bonk, auto
+- `--slippage <bps>` - Slippage in basis points (default: 500 = 5%)
+- `--priority <lamports>` - Priority fee for faster execution
+
+**Examples:**
+```
+/pump buy ABC123... 0.1
+/pump buy ABC123... 0.5 --pool auto --slippage 1000
+/pump sell ABC123... 100%
+/pump sell ABC123... 50% --pool raydium
+```
+
+## Discovery
+
+```
+/pump trending               Top tokens by 24h volume (DexScreener enriched)
+/pump gainers                Top 24h price gainers
+/pump losers                 Top 24h price losers
+/pump hot                    Most active right now (1h transactions)
+/pump new-hot                Hottest new tokens by volume
+/pump new                    Recently created tokens
+/pump live                   Currently trading tokens
+/pump graduated              Tokens migrated to Raydium
+/pump search <query>         Search tokens by name/symbol
+/pump volatile               High volatility tokens
+/pump koth                   King of the Hill (30-35K mcap)
+/pump for-you                Personalized recommendations
+/pump metas                  Trending narratives/keywords
+```
+
+## Token Data
+
+```
+/pump token <mint>                      Full token info
+/pump stats <mint>                      Volume, txns, liquidity, price change (DexScreener)
+/pump price <mint>                      Current price + 24h stats
+/pump holders <mint>                    Top holders list
+/pump trades <mint> [--limit N]         Recent trades for token
+/pump chart <mint> [--interval X]       OHLCV price chart
+/pump similar <mint>                    Find similar tokens
+```
+
+**Intervals:** 1m, 5m, 15m, 1h, 4h, 1d
+
+## Creator Tools
+
+```
+/pump user-coins <address>              Tokens created by wallet
+/pump create <name> <symbol> <desc>     Launch new token
+/pump claim <mint>                      Claim creator fees
+/pump ipfs-upload <name> <symbol> <desc>  Upload metadata to IPFS
+```
+
+**Create Options:**
+- `--image <url>` - Token image URL
+- `--twitter <url>` - Twitter link
+- `--telegram <url>` - Telegram link
+- `--website <url>` - Website link
+- `--initial <SOL>` - Initial buy amount
+
+## Platform Data
+
+```
+/pump latest-trades [--limit N]         Latest trades platform-wide
+/pump sol-price                         Current SOL price
+```
+
+## Monitoring (WebSocket)
+
+```
+/pump watch <mint>           Watch token for real-time trades
+/pump snipe <symbol>         Wait for token with symbol to launch
+```
+
+## Configuration
+
+```bash
+export SOLANA_PRIVATE_KEY="your-private-key"
+export PUMPPORTAL_API_KEY="your-api-key"     # Optional, for trading API
+export SOLANA_RPC_URL="your-rpc-url"         # Optional, custom RPC
+```
+
+## Pool Options
+
+| Pool | Description |
+|------|-------------|
+| `pump` | Pump.fun bonding curve (default) |
+| `raydium` | Raydium AMM (graduated tokens) |
+| `pump-amm` | Pump.fun native AMM |
+| `launchlab` | LaunchLab pools |
+| `raydium-cpmm` | Raydium CPMM pools |
+| `bonk` | Bonk pools |
+| `auto` | Automatic best route |
+
+## API Sources
+
+- **Trading:** PumpPortal (pumpportal.fun) - 0.5% fee
+- **Data:** Pump.fun Frontend API v3 (frontend-api-v3.pump.fun)
+- **Analytics:** Advanced API v2 (advanced-api-v2.pump.fun)
+- **Volatility:** Volatility API v2 (volatility-api-v2.pump.fun)
+- **WebSocket:** wss://pumpportal.fun/api/data
+
+## Complete Tool List (32 Tools)
+
+| Category | Tools |
+|----------|-------|
+| **Trading** | trade (buy/sell), quote |
+| **Discovery** | trending, gainers, losers, hot, new-hot, new, live, graduated, search, volatile, koth, for-you, metas |
+| **Token Data** | token, stats, price, holders, trades, chart, similar |
+| **Creator** | user-coins, create, claim, ipfs-upload |
+| **Platform** | latest-trades, sol-price |
+
+## Features
+
+- Bonding curve trading with automatic graduation
+- Multi-pool routing (Pump, Raydium, CPMM, etc.)
+- Token creation with IPFS metadata upload
+- Creator fee claiming
+- Real-time trade streaming via WebSocket
+- Token sniping support
+- OHLCV charts and analytics
+- Holder analysis
+- Trending metas/narratives discovery
+- Similar token recommendations
+- Platform-wide trade feed

package/dist/skills/bundled/pumpfun/index.js

@@ -151,12 +151,28 @@ function formatPrice(price) {
     return price.toFixed(4);
 }
 function formatMarketCap(mcap) {
+    if (mcap >= 1_000_000_000)
+        return `$${(mcap / 1_000_000_000).toFixed(2)}B`;
     if (mcap >= 1_000_000)
         return `$${(mcap / 1_000_000).toFixed(2)}M`;
     if (mcap >= 1_000)
         return `$${(mcap / 1_000).toFixed(1)}K`;
     return `$${mcap.toFixed(0)}`;
 }
+function formatPriceUsd(priceStr) {
+    if (!priceStr || priceStr === '0')
+        return 'N/A';
+    const p = parseFloat(priceStr);
+    if (isNaN(p) || p === 0)
+        return 'N/A';
+    if (p < 0.000001)
+        return `$${p.toExponential(2)}`;
+    if (p < 0.01)
+        return `$${p.toFixed(8)}`;
+    if (p < 1)
+        return `$${p.toFixed(6)}`;
+    return `$${p.toFixed(4)}`;
+}
 // ============================================================================
 // Trading Handlers
 // ============================================================================
@@ -376,7 +392,15 @@ async function enrichWithDexScreener(mints) {
     if (!mints.length)
         return result;
     try {
-        const resp = await fetch(`https://api.dexscreener.com/tokens/v1/solana/${mints.join(',')}`);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 10_000);
+        let resp;
+        try {
+            resp = await fetch(`https://api.dexscreener.com/tokens/v1/solana/${mints.join(',')}`, { signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
         if (!resp.ok)
             return result;
         const pairs = await resp.json();
@@ -413,9 +437,27 @@ async function enrichWithDexScreener(mints) {
     catch { /* best-effort */ }
     return result;
 }
-async function getTopPumpTokenMints(limit = 20) {
-    const tokens = await pumpFrontendRequest(`/coins?limit=${limit}&offset=0&sort=market_cap&order=DESC&includeNsfw=false&complete=true`);
-    return tokens?.map(t => t.mint) || [];
+async function getTopPumpTokenMints(limit = 20, includeActive = true) {
+    if (!includeActive) {
+        // Graduated only
+        const tokens = await pumpFrontendRequest(`/coins?limit=${limit}&offset=0&sort=market_cap&order=DESC&includeNsfw=false&complete=true`);
+        return tokens?.map(t => t.mint) || [];
+    }
+    // Fetch both graduated (by mcap) and active bonding curve tokens for broader coverage
+    const [graduated, active] = await Promise.allSettled([
+        pumpFrontendRequest(`/coins?limit=${Math.ceil(limit * 0.6)}&offset=0&sort=market_cap&order=DESC&includeNsfw=false&complete=true`),
+        pumpFrontendRequest(`/coins?limit=${Math.ceil(limit * 0.6)}&offset=0&sort=market_cap&order=DESC&includeNsfw=false&complete=false`),
+    ]);
+    const mints = new Set();
+    if (graduated.status === 'fulfilled') {
+        for (const t of graduated.value || [])
+            mints.add(t.mint);
+    }
+    if (active.status === 'fulfilled') {
+        for (const t of active.value || [])
+            mints.add(t.mint);
+    }
+    return [...mints].slice(0, limit);
 }
 // ============================================================================
 // Discovery Handlers
@@ -460,7 +502,7 @@ async function handleGainers() {
             const arrow = t.change24h >= 0 ? '📈' : '📉';
             output += `${i + 1}. ${arrow} **${t.symbol}** ${t.change24h >= 0 ? '+' : ''}${t.change24h.toFixed(1)}%\n`;
             output += `   MCap: ${formatMarketCap(t.marketCap)} | Vol: ${formatMarketCap(t.vol24h)}`;
-            output += ` | $${parseFloat(t.priceUsd).toFixed(6)}\n`;
+            output += ` | ${formatPriceUsd(t.priceUsd)}\n`;
             output += `   \`${t.mint.slice(0, 20)}...\`\n\n`;
         }
         return output;
@@ -481,9 +523,10 @@ async function handleLosers() {
         let output = '**Top Losers on Pump.fun (24h)**\n\n';
         for (let i = 0; i < tokens.length; i++) {
             const t = tokens[i];
-            output += `${i + 1}. 📉 **${t.symbol}** ${t.change24h.toFixed(1)}%\n`;
+            const arrow = t.change24h < 0 ? '📉' : '📈';
+            output += `${i + 1}. ${arrow} **${t.symbol}** ${t.change24h >= 0 ? '+' : ''}${t.change24h.toFixed(1)}%\n`;
             output += `   MCap: ${formatMarketCap(t.marketCap)} | Vol: ${formatMarketCap(t.vol24h)}`;
-            output += ` | $${parseFloat(t.priceUsd).toFixed(6)}\n`;
+            output += ` | ${formatPriceUsd(t.priceUsd)}\n`;
             output += `   \`${t.mint.slice(0, 20)}...\`\n\n`;
         }
         return output;
@@ -559,7 +602,7 @@ async function handleStats(mint) {
             return `No market data found for \`${mint.slice(0, 20)}...\``;
         return `**${t.symbol} - Market Stats**
 
-Price: $${parseFloat(t.priceUsd).toFixed(8)}
+Price: ${formatPriceUsd(t.priceUsd)}
 Market Cap: ${formatMarketCap(t.marketCap)}
 Liquidity: ${formatMarketCap(t.liquidity)}
 DEX: ${t.dex}
@@ -582,6 +625,33 @@ DEX: ${t.dex}
         return `Error: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
+async function handleGraduating() {
+    try {
+        // Fetch active bonding curve tokens sorted by market cap (highest = closest to graduating)
+        const tokens = await pumpFrontendRequest('/coins?limit=50&offset=0&sort=market_cap&order=DESC&includeNsfw=false&complete=false');
+        if (!tokens?.length)
+            return 'No active tokens found.';
+        // Filter for tokens with high bonding curve progress (>60%)
+        const nearGrad = tokens.filter(t => t.bondingCurveProgress !== undefined && t.bondingCurveProgress > 0.6);
+        if (!nearGrad.length)
+            return 'No tokens near graduation found (>60% bonding curve).';
+        // Sort by progress descending
+        nearGrad.sort((a, b) => (b.bondingCurveProgress || 0) - (a.bondingCurveProgress || 0));
+        let output = '**Near Graduation (Bonding Curve >60%)**\n\n';
+        for (const t of nearGrad.slice(0, 15)) {
+            const pct = ((t.bondingCurveProgress || 0) * 100).toFixed(1);
+            output += `**${t.symbol}** - ${t.name}\n`;
+            output += `  Progress: **${pct}%** | MCap: ${formatMarketCap(t.marketCap || 0)}`;
+            if (t.holders)
+                output += ` | Holders: ${t.holders}`;
+            output += `\n  \`${t.mint.slice(0, 20)}...\`\n\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
 async function handleNew() {
     try {
         const tokens = await pumpFrontendRequest('/coins/currently-live?limit=20&offset=0&includeNsfw=false&order=DESC');
@@ -1483,6 +1553,9 @@ async function execute(args) {
             return handleVolatile();
         case 'koth':
             return handleKOTH();
+        case 'graduating':
+        case 'near-grad':
+            return handleGraduating();
         case 'gainers':
             return handleGainers();
         case 'losers':
@@ -1558,6 +1631,7 @@ async function execute(args) {
   /pump new                         Recently created
   /pump live                        Currently trading
   /pump graduated                   Migrated to Raydium
+  /pump graduating                  Near graduation (>60% bonding)
   /pump search <query>              Search tokens
   /pump volatile                    High volatility
   /pump koth                        King of the Hill (30-35K)