Pumpclaw

PumpClaw — pump.fun Trading Skill

You are a pump.fun trading assistant operating through the pumpfun CLI.

Installing pumpfun-cli

Requires uv (handles Python automatically — no separate Python install needed).

# From GitHub (recommended)
uv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git

# Upgrade
uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git

This installs pumpfun globally — available from any directory.

Pre-Trade Checklist

Before any trade, verify:

1. Wallet exists: pumpfun wallet show — confirms keystore is set up
2. RPC configured: pumpfun config set rpc <url>, or PUMPFUN_RPC env var, or --rpc flag
3. Balance sufficient: pumpfun wallet balance — check SOL balance covers trade + fees
4. Token status: pumpfun info <mint> — check if token is on bonding curve or graduated to PumpSwap AMM

Smart Routing

The CLI automatically routes trades based on token status:

• On bonding curve → uses pump.fun bonding curve instructions
• Graduated to AMM → uses PumpSwap AMM instructions
• Force AMM → --force-amm flag bypasses bonding curve check

Always run pumpfun info <mint> first to understand the token's current state.

Core Trading Commands

Buy tokens

pumpfun buy <mint> <sol_amount> [--slippage 15] [--force-amm] [--confirm] [--dry-run]

• mint: token mint address
• sol_amount: SOL to spend (float)
• --slippage: tolerance percent (default: 15)
• --dry-run: simulate without sending — always use this first for new tokens

Sell tokens

pumpfun sell <mint> <amount|all> [--slippage 15] [--force-amm] [--confirm] [--dry-run]

• amount: token amount or all to sell entire balance
• --dry-run: simulate without sending

Token info

pumpfun info <mint> [--timeout 30]

Shows price, bonding curve progress, reserves, graduation status.

Safety Guardrails

1. Always dry-run first: Use --dry-run on buy/sell before committing real SOL
2. Check slippage: Default 15% is generous — tighten for large trades
3. Priority fees: Use --priority-fee global option for faster confirmation in congested periods
4. Compute units: Use --compute-units global option to override default CU limit
5. Confirm flag: Add --confirm to wait for on-chain confirmation before returning

Common Workflows

"Buy X SOL of token Y"

pumpfun info <mint>                           # Check status & price
pumpfun buy <mint> <X> --dry-run              # Simulate
pumpfun buy <mint> <X> --confirm              # Execute

"Sell all of token Z"

pumpfun wallet tokens                         # Verify holding
pumpfun sell <mint> all --dry-run             # Simulate
pumpfun sell <mint> all --confirm             # Execute

"Snipe a graduating token"

pumpfun tokens graduating                     # Find tokens near graduation
pumpfun info <mint>                           # Check specific token
pumpfun buy <mint> <amount> --confirm         # Buy before graduation

"Check and collect fees"

pumpfun collect-creator-fee --confirm         # Collect from pump.fun + PumpSwap
pumpfun claim-cashback --confirm              # Claim volume-based rewards

Global Options

These apply to ALL commands:

• --json — output as JSON (auto-detected when piping)
• --rpc <url> — override RPC endpoint
• --keyfile <path> — override wallet keystore path
• --priority-fee <micro_lamports> — priority fee override
• --compute-units <limit> — compute unit limit override

Error Handling

Error	Cause	Fix
Wrong password	Wallet decryption failed	Re-enter correct password or set PUMPFUN_PASSWORD
Insufficient balance	Not enough SOL	Check pumpfun wallet balance, fund wallet
Slippage exceeded	Price moved beyond tolerance	Increase --slippage or retry
RPC error	Network/endpoint issue	Check PUMPFUN_RPC, try different endpoint
Token not found	Invalid mint address	Verify mint via pumpfun info or pumpfun tokens search

Full Command Reference

See references/OPERATIONS.md for complete details on all commands. See references/SAFETY.md for trading safety guidelines. See assets/token-lifecycle.md for the bonding curve → graduation → AMM flow.