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 , 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 — 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 first to understand the token's current state.

Core Trading Commands

Buy tokens

pumpfun buy   [--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   [--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  [--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                            # Check status & price
pumpfun buy   --dry-run              # Simulate
pumpfun buy   --confirm              # Execute

"Sell all of token Z"

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

"Snipe a graduating token"

pumpfun tokens graduating                     # Find tokens near graduation
pumpfun info                            # Check specific token
pumpfun buy   --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 — override RPC endpoint
• --keyfile — override wallet keystore path
• --priority-fee — priority fee override
• --compute-units — 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](references/OPERATIONS.md) for complete details on all commands. See [references/SAFETY.md](references/SAFETY.md) for trading safety guidelines. See [assets/token-lifecycle.md](assets/token-lifecycle.md) for the bonding curve → graduation → AMM flow.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: chainstacklabs
• Source: chainstacklabs/pumpclaw
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.