Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 3 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

An agent skill for trading on **pump.fun** and on **letsbonk.fun**, **StonkFun** and every other launchpad on Raydium LaunchLab, through [pumpfun-cli](https://github.com/chainstacklabs/pumpfun-cli). It gives your AI agent what it needs to buy and sell on the bonding curve and in PumpSwap and Raydium CPMM pools, launch pump.fun coins, and manage a wallet, with dry runs and safety checks before real funds move.

Works with any agent that supports the [Agent Skills](https://agentskills.io/home) standard: [OpenClaw](https://github.com/openclaw/openclaw), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.com), [Codex](https://openai.com/index/codex/) and others.
Works with any agent that supports the [Agent Skills](https://agentskills.io/home) standard: [OpenClaw](https://github.com/openclaw/openclaw), [Claude Code](https://code.claude.com/docs), [Cursor](https://cursor.com), [Codex](https://openai.com/index/codex/) and others.

> **Also by Chainstack**
> - [**pumpfun-cli**](https://github.com/chainstacklabs/pumpfun-cli) — the command-line tool this skill drives; usable on its own by humans and scripts.
Expand All @@ -33,7 +33,7 @@ Works with any agent that supports the [Agent Skills](https://agentskills.io/hom
### 1. Prerequisites

- [uv](https://docs.astral.sh/uv/getting-started/installation/) — it handles Python, no separate install needed
- pumpfun-cli **0.3 or later**:
- pumpfun-cli **0.3.1 or later**:

```bash
uv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git
Expand Down Expand Up @@ -71,12 +71,11 @@ Set `PUMPFUN_PASSWORD` in the agent's environment so it can trade without a pass
| Trading | Buy and sell on pump.fun and LaunchLab curves, and in PumpSwap and Raydium CPMM pools once a coin graduates; the CLI routes each trade and reports the `venue` |
| Quote assets | Coins priced in SOL, USDC, tokenized stocks and other tokens, with Token-2022 transfer fees counted |
| Launch | Launch a pump.fun coin from a hosted metadata URI, with an opening buy in the same transaction |
| Discovery | Browse pump.fun's trending, new and graduating coins, and search by name or ticker |
| Fees and rewards | Collect creator fees, claim cashback, trigger a pump.fun migration |
| Wallet | Create, import, export, balances, transfers, closing empty token accounts |
| Safety | Dry runs first, slippage and priority-fee guidance, the CLI's error messages and what to do about each |

Token discovery (`pumpfun tokens`) uses pump.fun's frontend API, which currently refuses non-browser clients ([pumpfun-cli#33](https://github.com/chainstacklabs/pumpfun-cli/issues/33)); until that is fixed, the agent asks for the mint.

## Structure

```
Expand Down
10 changes: 5 additions & 5 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ description: >
covers pump.fun token launch, migration, wallet management, and token
discovery. Use when the user wants to trade, swap, buy, sell, launch, or
manage pump.fun, letsbonk.fun or StonkFun tokens.
compatibility: "Requires uv and pumpfun-cli 0.3 or later (install via uv from github.com/chainstacklabs/pumpfun-cli)"
compatibility: "Requires uv and pumpfun-cli 0.3.1 or later (install via uv from github.com/chainstacklabs/pumpfun-cli)"
metadata:
author: chainstacklabs
version: "0.3"
version: "0.3.1"
category: crypto-trading
requires:
bins: ["uv", "pumpfun"]
Expand All @@ -35,15 +35,15 @@ uv tool install git+https://github.com/chainstacklabs/pumpfun-cli.git
uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git
```

This installs `pumpfun` globally — available from any directory. `pumpfun --version` should report 0.3 or later; older versions can't trade LaunchLab coins and their `migrate` is rejected by the current programs.
This installs `pumpfun` globally — available from any directory. `pumpfun --version` should report 0.3.1 or later; with 0.3.0 pump.fun refuses the `tokens` listings, and older versions can't trade LaunchLab coins and their `migrate` is rejected by the current programs.

## 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` — SOL for fees, plus the coin's quote asset for the spend
3. **Balance sufficient**: `pumpfun wallet balance` shows SOL, needed for fees and for the spend on a SOL coin; for a coin priced in another asset, `pumpfun wallet tokens` shows that asset's balance
4. **Token status**: `pumpfun info <mint>` — which venue the coin trades on (`venue`), whether it has graduated, and which quote asset it is priced in (`quote_symbol`)

## Smart Routing
Expand Down Expand Up @@ -184,7 +184,7 @@ These apply to ALL commands:
| "CPMM pool is not open yet" | The LaunchLab curve is complete, Raydium hasn't opened the pool | Wait and retry |
| "graduated to Raydium AMM v4" | The LaunchLab coin migrated somewhere this CLI can't trade | Don't trade it with this CLI |
| "getProgramAccounts" | The RPC won't search LaunchLab pools for a coin priced in something other than SOL | Use an RPC that serves `getProgramAccounts` |
| "pump.fun API returned HTTP 403" from `tokens` | pump.fun's listing API is refusing non-browser clients | Listings are unavailable; ask the user for the mint |
| "pump.fun API returned HTTP 403" from `tokens` | pump.fun's listing API refused the request; it is unofficial and changes without notice | Upgrade the CLI if `pumpfun --version` is below 0.3.1; otherwise listings are unavailable, ask the user for the mint |

## Full Command Reference

Expand Down
2 changes: 1 addition & 1 deletion references/SAFETY.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

1. **Dry-run first** — always simulate with `--dry-run` before committing funds
2. **Check token info** — run `pumpfun info <mint>` to understand current price, reserves, and graduation status
3. **Verify balance** — `pumpfun wallet balance` to confirm you can cover the trade (in the coin's quote asset) + transaction fees in SOL
3. **Verify balance** — confirm you can cover the trade in the coin's quote asset plus transaction fees in SOL: `pumpfun wallet balance` shows SOL, `pumpfun wallet tokens` shows any other quote asset
4. **Know the routing** — bonding curve tokens and graduated AMM tokens behave differently, and `venue` says which one a trade used

## Slippage Management
Expand Down
4 changes: 2 additions & 2 deletions scripts/check-prereqs.sh
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ if ! command -v pumpfun &>/dev/null && ! uv run pumpfun --version &>/dev/null 2>
errors=$((errors + 1))
else
version=$( (pumpfun --version 2>/dev/null || uv run pumpfun --version 2>/dev/null) | awk '{print $NF}')
if [ "$(printf '%s\n' 0.3.0 "$version" | sort -V | head -1)" = "0.3.0" ]; then
if [ "$(printf '%s\n' 0.3.1 "$version" | sort -V | head -1)" = "0.3.1" ]; then
echo "OK: pumpfun CLI $version available"
else
echo "ERROR: pumpfun CLI $version is older than 0.3. Upgrade: uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git"
echo "ERROR: pumpfun CLI $version is older than 0.3.1. Upgrade: uv tool install --force git+https://github.com/chainstacklabs/pumpfun-cli.git"
errors=$((errors + 1))
fi
fi
Expand Down
Loading