Pump.fun Swarm Trading

Coordinate up to 20 wallets to execute synchronized trades on Pump.fun tokens.

Quick Start

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

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

• Refreshes SOL balances from chain

• Filters wallets with sufficient balance (≥0.01 SOL + amount)

• Builds transaction for each wallet via PumpPortal API

• Signs all transactions locally

• Submits via selected execution mode

• Reports results per wallet

Sell Flow

• Fetches actual token balances from chain (critical!)

• Filters wallets with positions

• Calculates sell amount (% of position or exact)

• Builds and signs transactions

• Submits via selected execution mode

• 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

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

/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

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