{"id":"5e9af006-a0b8-43b0-9657-25d2a790ee04","shortId":"5QmYkh","kind":"skill","title":"pumpclaw","tagline":"Execute pump.fun token trades via pumpfun-cli. Handles buy/sell with smart routing (bonding curve vs PumpSwap AMM), slippage control, priority fees, compute units, and dry-run simulation. Also covers token launch, migration, wallet management, and token discovery. Use when the us","description":"# PumpClaw — pump.fun Trading Skill\n\nYou are a pump.fun trading assistant operating through the `pumpfun` CLI.\n\n## Installing pumpfun-cli\n\nRequires [uv](https://docs.astral.sh/uv/getting-started/installation/) (handles Python automatically — no separate Python install needed).\n\n```bash\n# From GitHub (recommended)\nuv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git\n\n# Upgrade\nuv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git\n```\n\nThis installs `pumpfun` globally — available from any directory.\n\n## Pre-Trade Checklist\n\nBefore any trade, verify:\n\n1. **Wallet exists**: `pumpfun wallet show` — confirms keystore is set up\n2. **RPC configured**: `pumpfun config set rpc <url>`, or `PUMPFUN_RPC` env var, or `--rpc` flag\n3. **Balance sufficient**: `pumpfun wallet balance` — check SOL balance covers trade + fees\n4. **Token status**: `pumpfun info <mint>` — check if token is on bonding curve or graduated to PumpSwap AMM\n\n## Smart Routing\n\nThe CLI automatically routes trades based on token status:\n\n- **On bonding curve** → uses pump.fun bonding curve instructions\n- **Graduated to AMM** → uses PumpSwap AMM instructions\n- **Force AMM** → `--force-amm` flag bypasses bonding curve check\n\nAlways run `pumpfun info <mint>` first to understand the token's current state.\n\n## Core Trading Commands\n\n### Buy tokens\n```bash\npumpfun buy <mint> <sol_amount> [--slippage 15] [--force-amm] [--confirm] [--dry-run]\n```\n- `mint`: token mint address\n- `sol_amount`: SOL to spend (float)\n- `--slippage`: tolerance percent (default: 15)\n- `--dry-run`: simulate without sending — **always use this first for new tokens**\n\n### Sell tokens\n```bash\npumpfun sell <mint> <amount|all> [--slippage 15] [--force-amm] [--confirm] [--dry-run]\n```\n- `amount`: token amount or `all` to sell entire balance\n- `--dry-run`: simulate without sending\n\n### Token info\n```bash\npumpfun info <mint> [--timeout 30]\n```\nShows price, bonding curve progress, reserves, graduation status.\n\n## Safety Guardrails\n\n1. **Always dry-run first**: Use `--dry-run` on buy/sell before committing real SOL\n2. **Check slippage**: Default 15% is generous — tighten for large trades\n3. **Priority fees**: Use `--priority-fee` global option for faster confirmation in congested periods\n4. **Compute units**: Use `--compute-units` global option to override default CU limit\n5. **Confirm flag**: Add `--confirm` to wait for on-chain confirmation before returning\n\n## Common Workflows\n\n### \"Buy X SOL of token Y\"\n```bash\npumpfun info <mint>                           # Check status & price\npumpfun buy <mint> <X> --dry-run              # Simulate\npumpfun buy <mint> <X> --confirm              # Execute\n```\n\n### \"Sell all of token Z\"\n```bash\npumpfun wallet tokens                         # Verify holding\npumpfun sell <mint> all --dry-run             # Simulate\npumpfun sell <mint> all --confirm             # Execute\n```\n\n### \"Snipe a graduating token\"\n```bash\npumpfun tokens graduating                     # Find tokens near graduation\npumpfun info <mint>                           # Check specific token\npumpfun buy <mint> <amount> --confirm         # Buy before graduation\n```\n\n### \"Check and collect fees\"\n```bash\npumpfun collect-creator-fee --confirm         # Collect from pump.fun + PumpSwap\npumpfun claim-cashback --confirm              # Claim volume-based rewards\n```\n\n## Global Options\n\nThese apply to ALL commands:\n- `--json` — output as JSON (auto-detected when piping)\n- `--rpc <url>` — override RPC endpoint\n- `--keyfile <path>` — override wallet keystore path\n- `--priority-fee <micro_lamports>` — priority fee override\n- `--compute-units <limit>` — compute unit limit override\n\n## Error Handling\n\n| Error | Cause | Fix |\n|---|---|---|\n| Wrong password | Wallet decryption failed | Re-enter correct password or set `PUMPFUN_PASSWORD` |\n| Insufficient balance | Not enough SOL | Check `pumpfun wallet balance`, fund wallet |\n| Slippage exceeded | Price moved beyond tolerance | Increase `--slippage` or retry |\n| RPC error | Network/endpoint issue | Check `PUMPFUN_RPC`, try different endpoint |\n| Token not found | Invalid mint address | Verify mint via `pumpfun info` or `pumpfun tokens search` |\n\n## Full Command Reference\n\nSee [references/OPERATIONS.md](references/OPERATIONS.md) for complete details on all commands.\nSee [references/SAFETY.md](references/SAFETY.md) for trading safety guidelines.\nSee [assets/token-lifecycle.md](assets/token-lifecycle.md) for the bonding curve → graduation → AMM flow.","tags":["pumpclaw","chainstacklabs","agent-skills","openclaw","pumpdotfun","solana","trading"],"capabilities":["skill","source-chainstacklabs","skill-pumpclaw","topic-agent-skills","topic-openclaw","topic-pumpdotfun","topic-solana","topic-trading"],"categories":["pumpclaw"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/chainstacklabs/pumpclaw","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add chainstacklabs/pumpclaw","source_repo":"https://github.com/chainstacklabs/pumpclaw","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (4,512 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:11.454Z","embedding":null,"createdAt":"2026-05-18T13:21:51.025Z","updatedAt":"2026-05-18T19:14:11.454Z","lastSeenAt":"2026-05-18T19:14:11.454Z","tsv":"'/chainstacklabs/pumpfun-cli.git':87,96 '/uv/getting-started/installation/)':68 '1':113,309 '15':225,247,269,329 '2':124,325 '3':139,336 '30':298 '4':151,351 '5':365 'add':368 'address':236,567 'also':31 'alway':204,254,310 'amm':19,167,189,192,195,198,228,272,604 'amount':238,266,277,279 'appli':477 'assets/token-lifecycle.md':597,598 'assist':54 'auto':486 'auto-detect':485 'automat':71,172 'avail':101 'balanc':140,144,147,285,532,539 'base':175,472 'bash':77,221,263,294,387,408,430,453 'beyond':546 'bond':15,161,180,184,201,301,601 'buy':219,223,381,394,400,444,446 'buy/sell':11,320 'bypass':200 'cashback':467 'caus':515 'chain':375 'check':145,156,203,326,390,440,449,536,556 'checklist':108 'claim':466,469 'claim-cashback':465 'cli':9,59,63,171 'collect':451,456,460 'collect-creator-fe':455 'command':218,480,578,588 'commit':322 'common':379 'complet':584 'comput':24,352,356,506,508 'compute-unit':355,505 'config':128 'configur':126 'confirm':119,229,273,347,366,369,376,401,424,445,459,468 'congest':349 'control':21 'core':216 'correct':525 'cover':32,148 'creator':457 'cu':363 'current':214 'curv':16,162,181,185,202,302,602 'decrypt':520 'default':246,328,362 'detail':585 'detect':487 'differ':560 'directori':104 'discoveri':40 'docs.astral.sh':67 'docs.astral.sh/uv/getting-started/installation/)':66 'dri':28,231,249,275,287,312,317,396,418 'dry-run':27,230,248,274,286,311,316,395,417 'endpoint':493,561 'enough':534 'enter':524 'entir':284 'env':134 'error':512,514,553 'exceed':543 'execut':2,402,425 'exist':115 'fail':521 'faster':346 'fee':23,150,338,342,452,458,501,503 'find':434 'first':208,257,314 'fix':516 'flag':138,199,367 'float':242 'flow':605 'forc':92,194,197,227,271 'force-amm':196,226,270 'found':564 'full':577 'fund':540 'generous':331 'git':84,93 'github':79 'github.com':86,95 'github.com/chainstacklabs/pumpfun-cli.git':85,94 'global':100,343,358,474 'graduat':164,187,305,428,433,437,448,603 'guardrail':308 'guidelin':595 'handl':10,69,513 'hold':413 'increas':548 'info':155,207,293,296,389,439,572 'instal':60,75,83,91,98 'instruct':186,193 'insuffici':531 'invalid':565 'issu':555 'json':481,484 'keyfil':494 'keystor':120,497 'larg':334 'launch':34 'limit':364,510 'manag':37 'migrat':35 'mint':233,235,566,569 'move':545 'near':436 'need':76 'network/endpoint':554 'new':259 'on-chain':373 'oper':55 'option':344,359,475 'output':482 'overrid':361,491,495,504,511 'password':518,526,530 'path':498 'percent':245 'period':350 'pipe':489 'pre':106 'pre-trad':105 'price':300,392,544 'prioriti':22,337,341,500,502 'priority-fe':340,499 'progress':303 'pump.fun':3,46,52,183,462 'pumpclaw':1,45 'pumpfun':8,58,62,99,116,127,132,142,154,206,222,264,295,388,393,399,409,414,421,431,438,443,454,464,529,537,557,571,574 'pumpfun-c':7,61 'pumpswap':18,166,191,463 'python':70,74 're':523 're-ent':522 'real':323 'recommend':80 'refer':579 'references/operations.md':581,582 'references/safety.md':590,591 'requir':64 'reserv':304 'retri':551 'return':378 'reward':473 'rout':14,169,173 'rpc':125,130,133,137,490,492,552,558 'run':29,205,232,250,276,288,313,318,397,419 'safeti':307,594 'search':576 'see':580,589,596 'sell':261,265,283,403,415,422 'send':253,291 'separ':73 'set':122,129,528 'show':118,299 'simul':30,251,289,398,420 'skill':48 'skill-pumpclaw' 'slippag':20,224,243,268,327,542,549 'smart':13,168 'snipe':426 'sol':146,237,239,324,383,535 'source-chainstacklabs' 'specif':441 'spend':241 'state':215 'status':153,178,306,391 'suffici':141 'tighten':332 'timeout':297 'token':4,33,39,152,158,177,212,220,234,260,262,278,292,385,406,411,429,432,435,442,562,575 'toler':244,547 'tool':82,90 'topic-agent-skills' 'topic-openclaw' 'topic-pumpdotfun' 'topic-solana' 'topic-trading' 'trade':5,47,53,107,111,149,174,217,335,593 'tri':559 'understand':210 'unit':25,353,357,507,509 'upgrad':88 'us':44 'use':41,182,190,255,315,339,354 'uv':65,81,89 'var':135 'verifi':112,412,568 'via':6,570 'volum':471 'volume-bas':470 'vs':17 'wait':371 'wallet':36,114,117,143,410,496,519,538,541 'without':252,290 'workflow':380 'wrong':517 'x':382 'y':386 'z':407","prices":[{"id":"c3de2f24-be2a-4cc9-82d9-76c0223a1d3d","listingId":"5e9af006-a0b8-43b0-9657-25d2a790ee04","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"chainstacklabs","category":"pumpclaw","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:51.025Z"}],"sources":[{"listingId":"5e9af006-a0b8-43b0-9657-25d2a790ee04","source":"github","sourceId":"chainstacklabs/pumpclaw","sourceUrl":"https://github.com/chainstacklabs/pumpclaw","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:51.025Z","lastSeenAt":"2026-05-18T19:14:11.454Z"}],"details":{"listingId":"5e9af006-a0b8-43b0-9657-25d2a790ee04","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"chainstacklabs","slug":"pumpclaw","github":{"repo":"chainstacklabs/pumpclaw","stars":7,"topics":["agent-skills","openclaw","pumpdotfun","solana","trading"],"license":"apache-2.0","html_url":"https://github.com/chainstacklabs/pumpclaw","pushed_at":"2026-03-20T18:45:40Z","description":"pump.fun trading skill for OpenClaw - launch and browse tokens, execute trades, manage wallets","skill_md_sha":"e9b502a775b28566fbcc6b92babd8805955f304c","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/chainstacklabs/pumpclaw"},"layout":"root","source":"github","category":"pumpclaw","frontmatter":{"name":"pumpclaw","description":"Execute pump.fun token trades via pumpfun-cli. Handles buy/sell with smart routing (bonding curve vs PumpSwap AMM), slippage control, priority fees, compute units, and dry-run simulation. Also covers token launch, migration, wallet management, and token discovery. Use when the user wants to trade, swap, buy, sell, launch, or manage pump.fun tokens.","compatibility":"Requires uv and pumpfun-cli (install via uv from github.com/chainstacklabs/pumpfun-cli)"},"skills_sh_url":"https://skills.sh/chainstacklabs/pumpclaw"},"updatedAt":"2026-05-18T19:14:11.454Z"}}