Back to Home
DOCUMENTATION

PumpShell Documentation

Complete command reference and usage guide for PumpShell CLI. Master multi-wallet trading, token deployment, and automation.

Getting Started

Installation

$ npm install -g pumpshell
$ pumpshell --version

Quick Start

Launch the interactive terminal or use commands directly:

$ pumpshell
# Or run commands directly
$ pumpshell wallet:create --count 5

Wallet Management

wallet:create

Generate new Solana wallets with optional naming prefix.

Syntax:
wallet:create [--count N] [--prefix NAME]
Options:
  • --count - Number of wallets to create (default: 1)
  • --prefix - Name prefix for wallet identification
Examples:
$ wallet:create --count 10 --prefix sniper
$ wallet:create --count 5 --prefix main

wallet:import

Import existing wallets from private keys or seed phrases.

Syntax:
wallet:import --key PRIVATE_KEY [--name NAME]
Options:
  • --key - Private key or seed phrase
  • --name - Wallet identifier name

wallet:list

Display all stored wallets with balances and addresses.

Syntax:
wallet:list [--filter PATTERN]
Examples:
$ wallet:list
$ wallet:list --filter sniper*

wallet:fund

Distribute SOL from main wallet to multiple wallets automatically.

Syntax:
wallet:fund PATTERN --amount SOL [--from WALLET]
Options:
  • PATTERN - Wallet name pattern (supports wildcards)
  • --amount - SOL amount per wallet
  • --from - Source wallet (default: main)
Examples:
$ wallet:fund sniper* --amount 0.2
$ wallet:fund all --amount 0.1 --from main

Token Operations

token:deploy

Deploy new tokens on PumpFun with metadata and optional multi-wallet buy.

Syntax:
token:deploy --name NAME --symbol SYMBOL --supply N [OPTIONS]
Options:
  • --name - Token name
  • --symbol - Token ticker symbol
  • --supply - Total token supply
  • --description - Token description
  • --image - Image URL or local path
  • --multibuy - Auto-buy after deployment
  • --wallet-group - Wallets for multibuy
Examples:
$ token:deploy --name "Chad Coin" --symbol CHAD \
--supply 1000000000 --multibuy \
--wallet-group sniper*

token:airdrop

Distribute tokens to multiple addresses in one transaction.

Syntax:
token:airdrop --token MINT --wallets PATTERN --amount N
Examples:
$ token:airdrop --token MINT --wallets sniper* --amount 1000

token:metadata

Update token metadata including name, symbol, and image.

Syntax:
token:metadata --token MINT [--name NAME] [--image URL]

Trading Operations

trade:buy

Execute buy orders across single or multiple wallets simultaneously.

Syntax:
trade:buy --token MINT --wallets PATTERN --amount SOL [OPTIONS]
Options:
  • --token - Token mint address or symbol
  • --wallets - Wallet pattern (supports wildcards)
  • --amount - SOL amount per wallet
  • --slippage - Max slippage % (default: 5)
  • --priority - Priority fee level (low/med/high)
Examples:
$ trade:buy --token CHAD --wallets sniper* --amount 0.1
$ trade:buy --token MINT --wallets main --amount 1 --slippage 10

trade:sell

Sell tokens from multiple wallets with percentage or fixed amounts.

Syntax:
trade:sell --token MINT --wallets PATTERN [--percent N | --amount N]
Options:
  • --percent - Percentage of holdings to sell
  • --amount - Fixed token amount to sell
  • --all - Sell entire balance
Examples:
$ trade:sell --token CHAD --wallets sniper* --percent 50
$ trade:sell --token MINT --wallets all --all

trade:vamp

Execute coordinated buy/sell cycles to create volume and momentum (vamp attack).

Syntax:
trade:vamp --token MINT --wallets PATTERN --cycles N --amount SOL
Options:
  • --cycles - Number of buy/sell cycles
  • --amount - SOL amount per cycle
  • --delay - Delay between cycles (ms)
  • --random - Randomize timing
Examples:
$ trade:vamp --token CHAD --wallets sniper* \
--cycles 5 --amount 0.05 --random

Advanced Features

snipe

Auto-detect and instantly buy new token deployments with configurable parameters.

Syntax:
snipe [--token MINT] --amount SOL [--wallet NAME] [OPTIONS]
Options:
  • --token - Specific token to snipe (optional)
  • --amount - SOL amount to spend
  • --wallet - Wallet to use for sniping
  • --auto - Auto-snipe all new deployments
  • --jito - Use Jito for MEV protection
Examples:
$ snipe --token MINT --amount 0.5 --jito
$ snipe --auto --amount 0.2 --wallet sniper1

job:run

Execute predefined automation scripts with complex trading strategies.

Syntax:
job:run SCRIPT_NAME [--auto] [--params KEY=VALUE]
Options:
  • SCRIPT_NAME - Name of automation script
  • --auto - Run without confirmation
  • --params - Override script parameters
Examples:
$ job:run deploy-and-pump.yml --auto
$ job:run snipe-strategy.yml --params amount=1

Utility Commands

/help

Display all available commands and quick reference.

/clear

Clear the terminal screen.

/history

Show command history for current session.

/exit

Exit the PumpShell terminal.

Best Practices

Security

  • Always encrypt wallets with strong passwords
  • Store private keys securely and never share them
  • Use separate wallets for different strategies
  • Test with small amounts before scaling up

Performance

  • Use Jito for time-sensitive operations to avoid MEV
  • Set appropriate priority fees during high network congestion
  • Batch operations when possible to save on fees
  • Monitor wallet balances before executing large operations

Strategy

  • Start with wallet:create and wallet:fund to set up infrastructure
  • Use wallet patterns (wildcards) for efficient multi-wallet operations
  • Test automation scripts with --dry-run before live execution
  • Combine commands in job scripts for complex strategies

Need Help?

Try the interactive terminal to see commands in action, or join our community for support.