Agent skill

Pumpfun Mechanics

by agiprolabs in agiprolabs/claude-trading-skills

PumpFun bonding curve math, graduation mechanics, instruction parsing, and PumpSwap migration

MITAuto-check passed

Install Pumpfun Mechanics

skills CLI
$ npx skills add agiprolabs/claude-trading-skills --skill pumpfun-mechanics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agiprolabs/claude-trading-skills pumpfun-mechanics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agiprolabs/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pumpfun-mechanics .claude/skills/pumpfun-mechanics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pumpfun-mechanics
GitHub stars
410
Token cost
~2.2k tokens
SKILL.md length
461 words
Files
6 (incl. scripts, references)
Skills in repo
68
Repo updated
First seen
Licence
MIT

At a glance

PumpFun bonding curve math, graduation mechanics, instruction parsing, and PumpSwap migration

  • Works in 5 steps: complete flag set to true on bonding… → CompleteEvent emitted (discriminator… → Bonding curve stops accepting trades → …
  • SKILL.md covers Bonding Curve Math, Graduation, Program IDs & Addresses and Event Parsing, plus 3 more sections
  • Runs Python scripts from its folder

What it does

Pumpfun Mechanics is an agent skill from agiprolabs/claude-trading-skills. PumpFun bonding curve math, graduation mechanics, instruction parsing, and PumpSwap migration

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/bonding_curve_math.md`, `references/graduation_process.md` and `references/instruction_reference.md`).

The repository describes itself as: 68 trading, DeFi, and quantitative finance Agent Skills. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ other tools. The licence is MIT.

Example prompts

  • “/pumpfun-mechanics”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. complete flag set to true on bonding curve account
  2. CompleteEvent emitted (discriminator 5f72619cd42e9808)
  3. Bonding curve stops accepting trades
  4. ~$12K liquidity deposited to the destination DEX
  5. Token becomes tradeable on PumpSwap (or Raydium for older tokens)

What it can do on your machine

Read from SKILL.md and the folder at commit 981e1d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pumpfun Mechanics loads about 2.2k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 28 tokens; SKILL.md has 461 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from agiprolabs/claude-trading-skills at commit 981e1d7, republished under its MIT licence (© agiprolabs). 461 words, ~2,160 tokens.

Download SKILL.mdSave it as .claude/skills/pumpfun-mechanics/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
pumpfun-mechanics
description
PumpFun bonding curve math, graduation mechanics, instruction parsing, and PumpSwap migration

PumpFun Mechanics — Bonding Curves, Graduation & Instruction Parsing

PumpFun is the dominant Solana token launchpad. Understanding its bonding curve math, graduation process, and instruction formats is essential for analyzing new token launches, building trading strategies around graduation events, and parsing on-chain PumpFun activity.

Bonding Curve Math

PumpFun uses a virtual constant-product (CPMM) bonding curve:

k = virtualSolReserves × virtualTokenReserves
Initial Parameters
ParameterValue
Initial Virtual SOL30 SOL (30,000,000,000 lamports)
Initial Virtual Tokens~1.073B tokens (1,073,000,000,000,000 raw, 6 decimals)
Token Total Supply1B tokens (1,000,000,000,000,000 raw)
Real Token Reserves~793M tokens (793,000,000,000,000 raw)
Real SOL Reserves0 (no real SOL at launch)
Fee1% (applied externally by the program)

Virtual vs Real: Virtual reserves define the curve shape. Real reserves track actual withdrawable funds. The difference (1.073B - 793M = 280M virtual tokens) shapes the initial price but can never be withdrawn.

Spot Price
python
price_sol_per_token = virtual_sol_reserves / virtual_token_reserves

# In human-readable units:
price = (virtual_sol / 1e9) / (virtual_token / 1e6)

# At genesis: 30 / 1,073,000,000 ≈ 2.796e-8 SOL/token
# At graduation: ~4.1e-7 SOL/token (~14.7x from launch)
Buy Tokens (SOL → Tokens)
python
def buy_tokens(v_sol: int, v_tok: int, real_tok: int, sol_in: int) -> int:
    """Calculate tokens received for a given SOL input.

    Args:
        v_sol: Virtual SOL reserves (lamports).
        v_tok: Virtual token reserves (raw).
        real_tok: Real token reserves (raw).
        sol_in: SOL to spend (lamports, BEFORE 1% fee).

    Returns:
        Tokens received (raw units).
    """
    k = v_sol * v_tok
    new_v_sol = v_sol + sol_in
    new_v_tok = k // new_v_sol + 1  # +1 matches on-chain rounding
    tokens_out = v_tok - new_v_tok
    return min(tokens_out, real_tok)
Sell Tokens (Tokens → SOL)
python
def sell_tokens(v_sol: int, v_tok: int, real_sol: int, tokens_in: int) -> int:
    """Calculate SOL received for selling tokens.

    Args:
        v_sol: Virtual SOL reserves (lamports).
        v_tok: Virtual token reserves (raw).
        real_sol: Real SOL reserves (lamports).
        tokens_in: Tokens to sell (raw units).

    Returns:
        SOL received (lamports, BEFORE 1% fee).
    """
    k = v_sol * v_tok
    new_v_tok = v_tok + tokens_in
    new_v_sol = k // new_v_tok
    sol_out = v_sol - new_v_sol - 1  # -1 matches on-chain floor rounding
    return min(sol_out, real_sol)
Buy Cost (Exact token amount → SOL needed)
python
def buy_cost(v_sol: int, v_tok: int, tokens_wanted: int) -> int:
    """Calculate SOL needed to buy exact token amount.

    Returns:
        SOL cost in lamports (before fee). Returns max int if impossible.
    """
    if tokens_wanted >= v_tok:
        return 2**64 - 1  # impossible
    k = v_sol * v_tok
    new_v_tok = v_tok - tokens_wanted
    new_v_sol = k // new_v_tok + 1
    return new_v_sol - v_sol
Fee Handling

The 1% fee is not part of the curve math. It's applied externally:

python
# Buying: fee deducted from SOL input before curve
actual_sol_to_curve = sol_input * 0.99

# Selling: fee deducted from SOL output after curve
actual_sol_received = sol_from_curve * 0.99

# Roundtrip minimum cost: ~2% from fees alone, plus price impact
Market Cap
python
market_cap_sol = (token_total_supply * virtual_sol_reserves) / virtual_token_reserves

Graduation

Graduation occurs when realSolReserves reaches ~85 SOL (~$12K-14K depending on SOL price). Only ~1.4% of PumpFun tokens ever graduate.

What Happens
  1. complete flag set to true on bonding curve account
  2. CompleteEvent emitted (discriminator 5f72619cd42e9808)
  3. Bonding curve stops accepting trades
  4. ~$12K liquidity deposited to the destination DEX
  5. Token becomes tradeable on PumpSwap (or Raydium for older tokens)
Fill Percentage
python
GRADUATION_THRESHOLD = 85_000_000_000  # 85 SOL in lamports

fill_pct = (real_sol_reserves / GRADUATION_THRESHOLD) * 100.0
Migration Targets
  • March 2025+: PumpSwap (pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA) — native AMM, no migration fee
  • Before March 2025: Raydium V4 (675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8) — 6 SOL fee
PumpSwap Post-Graduation

PumpSwap is a constant-product AMM with 1% fee (same as bonding curve). Key differences:

  • Base asset is always WSOL, quote is token
  • Instruction semantics are inverted: "buy" instruction sells tokens, "sell" instruction buys tokens
  • Supports creator revenue sharing (0.05% of volume to original creator)
Show full SKILL.md (163 more words)Show less

Program IDs & Addresses

Program/AccountAddress
PumpFun Program6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P
PumpSwap ProgrampAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA
Fee ProgrampfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ
Global Account4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf
Fee Recipient62qc2CNXwrYqQScmEdiZFFAnJR262PxWEuNQtxfafNgV
Event AuthorityCe6TQqeHC9p8KetsN6JsjHK7UTZk7nasjjnr7XxXp9F1

Event Parsing

Events are Anchor-style: sha256("event:<EventName>")[0..8]

EventDiscriminator (hex)
CreateEvent1b72a94ddeeb6376
TradeEventbddb7fd34ee661ee
CompleteEvent5f72619cd42e9808
TradeEvent Layout (after 8-byte discriminator)
mint:                  pubkey   32 bytes
solAmount:             u64       8 bytes
tokenAmount:           u64       8 bytes
isBuy:                 bool      1 byte
user:                  pubkey   32 bytes
timestamp:             i64       8 bytes
virtualSolReserves:    u64       8 bytes
virtualTokenReserves:  u64       8 bytes
realSolReserves:       u64       8 bytes
realTokenReserves:     u64       8 bytes

Critical: Events are in CPI inner instructions. Search for discriminators anywhere in instruction data, not just at offset 0.

Bonding Curve Account Layout
Offset 0:   discriminator          8 bytes
Offset 8:   virtualTokenReserves   u64
Offset 16:  virtualSolReserves     u64
Offset 24:  realTokenReserves      u64
Offset 32:  realSolReserves        u64
Offset 40:  tokenTotalSupply       u64
Offset 48:  complete               bool (1 byte)
Offset 49:  creator                pubkey (32 bytes)
PDA Derivation
PDASeeds
Bonding Curve["bonding-curve", mint]
Bonding Curve V2["bonding-curve-v2", mint]
Creator Vault["creator-vault", creator]

Instruction Discriminators

InstructionHexNotes
buy_exact_sol_in (V2)38fc74089edfcd5fCurrent production buy
sell (V2)33e685a4017f83adCurrent production sell
buy (V1/legacy)66063d1201daebeaLegacy, still seen occasionally
create181ec828051c0777Token creation
Buy Instruction Data (24 bytes)
[0..8]:   discriminator
[8..16]:  spendable_sol_in    u64 LE (total SOL budget, fees deducted internally)
[16..24]: min_tokens_out      u64 LE (slippage floor)
Sell Instruction Data (24 bytes)
[0..8]:   discriminator
[8..16]:  amount_tokens       u64 LE (tokens to sell, raw)
[16..24]: min_sol_output      u64 LE (minimum SOL out, lamports)

Price Impact & Sizing

python
def price_impact(v_sol: int, v_tok: int, sol_in: int) -> float:
    """Calculate price impact for a buy as a percentage."""
    spot = v_sol / v_tok
    tokens = buy_tokens(v_sol, v_tok, v_tok, sol_in)
    if tokens == 0:
        return float('inf')
    exec_price = sol_in / tokens
    return (exec_price / spot - 1) * 100

# Example: 1 SOL buy at genesis
# impact = price_impact(30_000_000_000, 1_073_000_000_000_000, 1_000_000_000)
# ≈ 3.3% price impact

Files

References
  • references/bonding_curve_math.md — Complete mathematical derivations with worked examples
  • references/graduation_process.md — Graduation threshold, migration, PumpSwap mechanics
  • references/instruction_reference.md — Full instruction and event layouts for parsing
Scripts
  • scripts/curve_calculator.py — Interactive bonding curve calculator: price, impact, fill %
  • scripts/parse_events.py — Parse PumpFun events from transaction data

© agiprolabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/pumpfun-mechanics of agiprolabs/claude-trading-skills.

  • SKILL.md
  • references/bonding_curve_math.md
  • references/graduation_process.md
  • references/instruction_reference.md
  • scripts/curve_calculator.py
  • scripts/parse_events.py

Open the folder on GitHubat commit 981e1d7

Compare with similar skills

Pumpfun Mechanics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pumpfun Mechanics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pumpfun Mechanics this skillagiprolabs/claude-trading-skills410—~2.2kAutomated safety check: PassMIT
Mathparcadei/Continuous-Claude-v33.9k2 repos~1.6kAutomated safety check: NotesMIT
Acreadiness Generate Instructionsgithub/awesome-copilot40k1 repos~2.1kAutomated safety check: PassMIT
A-Share Convertible Bond AnalysisHKUDS/Vibe-Trading35k—~1.1kAutomated safety check: PassMIT
Math Computationtradecatlabs/vibe-coding-cn17k—~881Automated safety check: PassMIT
Sensory Instructionsthedaviddias/Front-End-Checklist74k—~533Automated safety check: PassMIT

Similar skills

  • Math

    parcadei/Continuous-Claude-v3

    Unified math capabilities - computation, solving, and explanation.

    3.9k GitHub starsUsed in 2 repos~1.6k tokens
    Research & ScienceAuto-check: notes
  • Acreadiness Generate Instructions

    github/awesome-copilot

    Official

    Generate tailored AI agent instruction files via AgentRC instructions command.

    40k GitHub starsUsed in 1 repo~2.1k tokens
    DevelopmentAuto-check passed
  • Analyzes Chinese A-share convertible bonds with a three-part valuation, clause game analysis, the double-low strategy and a rotation framework for choosing bonds; instructions are in Chinese.

    35k GitHub stars~1.1k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Math Computation

    tradecatlabs/vibe-coding-cn

    Runs reproducible math computations and counterexample searches with SymPy, NumPy and mpmath, logging evidence without presenting results as proofs.

    17k GitHub stars~881 tokensUpdated today
    Research & ScienceAuto-check passed
  • Sensory Instructions

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Avoid sensory-only instructions.

    74k GitHub stars~533 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Rigorous Math Proof

    tradecatlabs/vibe-coding-cn

    Writes and audits natural-language math proofs as checkable packages, with explicit assumptions, proof obligations and counterexample hunting, refuting or repairing weak claims.

    17k GitHub stars~571 tokensUpdated today
    Research & ScienceAuto-check passed

More from agiprolabs/claude-trading-skills

All 68 skills in this repo
  • Backtrader

    agiprolabs/claude-trading-skills

    Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers, and custom indicators

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Birdeye API

    agiprolabs/claude-trading-skills

    Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

    410 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Coingecko API

    agiprolabs/claude-trading-skills

    Broad crypto market data from CoinGecko covering 13,000+ tokens.

    410 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Cointegration Analysis

    agiprolabs/claude-trading-skills

    Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability analysis

    410 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Copy Trading

    agiprolabs/claude-trading-skills

    Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Correlation Analysis

    agiprolabs/claude-trading-skills

    Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail dependence, and regime-dependent correlation

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Pumpfun Mechanics

What does Pumpfun Mechanics do?

PumpFun bonding curve math, graduation mechanics, instruction parsing, and PumpSwap migration. Pumpfun Mechanics is an agent skill from agiprolabs/claude-trading-skills.

How do I install Pumpfun Mechanics in Claude Code?

Run `npx skills add agiprolabs/claude-trading-skills --skill pumpfun-mechanics -a claude-code`. Or copy the skill folder (skills/pumpfun-mechanics in agiprolabs/claude-trading-skills) into .claude/skills/pumpfun-mechanics in your project. Claude Code loads it when a task matches its description.

How do I install Pumpfun Mechanics in Codex?

Run `npx skills add agiprolabs/claude-trading-skills --skill pumpfun-mechanics -a codex`. Or copy the skill folder (skills/pumpfun-mechanics in agiprolabs/claude-trading-skills) into .agents/skills/pumpfun-mechanics in your project. Codex loads it when a task matches its description.

Can I use Pumpfun Mechanics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agiprolabs/claude-trading-skills --skill pumpfun-mechanics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pumpfun-mechanics, .gemini/skills/pumpfun-mechanics, .github/skills/pumpfun-mechanics and .opencode/skills/pumpfun-mechanics in your project.

What does Pumpfun Mechanics need to run?

Going by SKILL.md and its folder, Pumpfun Mechanics needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Pumpfun Mechanics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pumpfun Mechanics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pumpfun Mechanics use?

Pumpfun Mechanics is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pumpfun Mechanics use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Pumpfun Mechanics?

Skills that share tags, products or a category with Pumpfun Mechanics: Math (parcadei/Continuous-Claude-v3, 3.9k stars), Acreadiness Generate Instructions (github/awesome-copilot, 40k stars), A-Share Convertible Bond Analysis (HKUDS/Vibe-Trading, 35k stars) and Math Computation (tradecatlabs/vibe-coding-cn, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pumpfun Mechanics?

agiprolabs (a GitHub user) maintains it in agiprolabs/claude-trading-skills, which has 410 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on September 3, 2026.

Source: agiprolabs/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.