pump-public-docs

New: Smaller Trades, Multi-Hop Swaps, Pump Coins as Quote Mints, Fees Kept on the Curve

• Smaller trade instructions. buy_v3, sell_v3 and buy_exact_quote_in_v3 on the bonding curve, and buy_v2, sell_v2 and buy_exact_quote_in_v2 on PumpSwap, do the same trades with 17 accounts, so more fits in one transaction. Same prices, same fees. All existing trade instructions keep working. Bonding curve v3 · PumpSwap v2
• Multi-hop swap. One PumpSwap instruction, multi_hop_swap, trades through two or more pools and bonding curves in a row, for example SOL → coin A → coin B, with no token account for the middle coin. Multi-hop swap
• Any pump coin as a quote mint. create_v2 can pair a new coin with an existing pump coin. You pass the quote coin's bonding curve (and its pool, if it has migrated) as extra remaining accounts. Creating a coin paired with a pump coin
• Fees stay on the curve and pool. The new trades keep the protocol fee and the creator fee on the bonding curve or in the pool instead of paying them out on every trade. Anyone can pay them out with the permissionless sweep_protocol_fee / sweep_creator_fee instructions. Creators, CTOs and fee sharing must sweep the creator fee first. Fee sweeps
• Why virtual_quote_reserves goes negative. Fees kept in a pool are subtracted from virtual_quote_reserves, so the price does not count them. If you already handle it as a signed value, this is not a breaking change for your quotes, and all existing trade instructions work the same way. Virtual quote reserves and fees
• Synthetic migration: the last buy on the curve has no max size. With the v3 buys, the buy that empties the bonding curve can ask for more than what is left. It buys the rest from the tokens that would have gone into the PumpSwap pool, at that pool's price, and the pool later opens where that buy stopped. Only the buy that crosses the limit gets this; after it, no buys or sells are possible on the curve until the migration happens. Synthetic migration

The IDLs and TypeScript types in idl are updated with all of the above. SDK support: @pump-fun/pump-sdk 3.2.0, @pump-fun/pump-swap-sdk 2.1.0 and pump-rust-client 0.3.1, see SDKs.

PumpSwap Update: Negative Virtual Quote Reserves (September 30)

Starting September 30, Pool::virtual_quote_reserves can be negative. The field has been an i128 since it was introduced and its type is not changing, so always treat it as a signed value: effective_quote_reserves may be above or below pool_quote_token_account.amount. We guarantee that pool_quote_token_account.amount + virtual_quote_reserves will never overflow and will never be negative, so integrations only need to do the signed addition and price against the result.

Full details: Negative virtual quote reserves.

Holder Rewards Coins and the End of Cashback

Coins can now be created as holder rewards coins: the creator fee charged on every trade is set aside for the coin's holders and paid out to them by pump.fun, instead of going to a creator wallet.

• create_v2 takes one new trailing, optional is_holder_reward (OptionBool) argument. [true] creates a holder rewards coin; omitted or [false] creates a regular coin, so existing integrations keep working unchanged.
• There are no trade interface changes. buy, sell, buy_v2, sell_v2, buy_exact_quote_in_v2 and the PumpSwap buy / sell take the same accounts and arguments for every coin.
• BondingCurve and PumpSwap Pool gain an is_holder_reward flag; CreateEvent / CreatePoolEvent gain is_holder_reward; TradeEvent and PumpSwap BuyEvent / SellEvent gain holder_rewards_bps / holder_rewards. The existing creator fee fields are unchanged.
• Cashback mode is deprecated. create_v2 rejects is_cashback_enabled = [true], so no new cashback coins can be created. Existing cashback coins keep trading as before and their accrued cashback stays claimable.
• Contact the CTO team if you want the creator fee bps changed on a custom pair, or an existing coin converted into a holder rewards coin.

Full details: Holder rewards coins.

PumpSwap Update: Virtual Quote Reserves

PumpSwap pools now carry a virtual_quote_reserves field (appended to the Pool account). Buys and sells are priced against the pool's effective quote reserves:

effective_quote_reserves = pool_quote_token_account.amount + Pool::virtual_quote_reserves

• Use effective quote reserves (not the raw quote-vault token balance) wherever you quote, price, or index a pool.
• virtual_quote_reserves is 0 on all pools today, so quotes are unchanged. Switching to effective quote reserves now keeps your quotes correct if a pool later carries a non-zero value.
• Indexers: the BuyEvent and SellEvent logs include the appended virtual_quote_reserves field, so effective quote reserves can be reconstructed from the event stream.

Full details: PumpSwap docs — Quoting: effective quote reserves.

New Bonding Curve Trade Instructions

Hello everyone. As part of supporting stable paired meme coins, we are announcing three new trading instructions for the bonding curve program:

• buy_v2
• sell_v2
• buy_exact_quote_in_v2

These new instructions have no optional accounts. All accounts are mandatory and are passed in the same order for all kinds of coins.

This should alleviate many of the issues integrations are facing when choosing which accounts to pass based on the type of coin being traded.

We are moving to this new unified interface and would urge all integrations to switch to these instructions to future proof their setup.

Existing Trade Instructions

All existing trade instructions will continue to work with the same setup. No changes are needed to continue trading coins with the existing coins.

You can switch to the new instructions to trade coins paired with both SOL and USDC, with no change to quotes or costs.

The first feature we are looking to support with the new interface is the addition of USDC as a quote asset for meme coins.

Important Note For Existing Coins

These new interfaces can be used to trade all coins ever created by passing the quote mint as the wrapped SOL mint:

So11111111111111111111111111111111111111112

Trading and transfer will continue to happen with native SOL for these coins. However, to provide a unified interface regardless of quote_mint, please pass the wrapped SOL mint shown above.

What's New

• user_volume_accumulator account is mandatory for all buys and sells.
• sharing_config PDA is mandatory for all buys and sells.
• Added the following accounts to support more quote mints:
  • quote_mint
  • associated_quote_bonding_curve
  • associated_quote_fee_recipient
  • associated_quote_buyback_fee_recipient
  • associated_creator_vault
  • associated_quote_user
• Added a new quote_mint field in the bonding curve struct. This field is Pubkey::default() for all coins created to date and for all coins created with SOL as the quote mint.
• Renamed real_sol_reserves to real_quote_reserves in the BondingCurve.
• Renamed virtual_sol_reserves to virtual_quote_reserves in the BondingCurve.
• New Global field called initial_virtual_quote_reserves. Coins paired with SOL have their BondingCurve.virtual_quote_reserves start at initial_virtual_sol_reserves. All other quote mints will start theirs at initial_virtual_quote_reserves.

SOL-Paired Meme Coins

Trading will continue to happen with native SOL for all SOL-paired coins. For those coins, the following accounts are only Anchor seed constrained to the quote mint and do not need to be initialized for the instruction to work:

• associated_quote_fee_recipient
• associated_quote_buyback_fee_recipient
• associated_quote_bonding_curve
• associated_quote_user
• associated_creator_vault
• associated_user_volume_accumulator

When using the new instructions (buy_v2, sell_v2, buy_exact_quote_in_v2) for SOL-paired meme coins, there will be no extra cost compared to the legacy instructions (buy, sell, buy_exact_quote_in). All account initialization costs remain the same.

Launch Timeline

Today we are only announcing the launch of the new interface.

Currently, no quote mint other than native SOL can be used to create or trade coins. We will add USDC next week. Exact Date and time TBH. Trading USDC-paired coins will not be possible with the legacy instructions.

SDKs

These releases include builders for everything in the new section at the top: v3 trades, PumpSwap v2 trades, multi-hop swaps, pump coins as quote mints and fee sweeps.

• @pump-fun/pump-sdk 3.2.0 (Pump program): https://www.npmjs.com/package/@pump-fun/pump-sdk/v/3.2.0
• @pump-fun/pump-swap-sdk 2.1.0 (PumpSwap): https://www.npmjs.com/package/@pump-fun/pump-swap-sdk/v/2.1.0
• pump-rust-client 0.3.1 (both programs): https://crates.io/crates/pump-rust-client/0.3.1

New docs

• Bonding curve trades v3: docs/instructions/TRADE_V3.md
• PumpSwap trades v2: docs/instructions/PUMP_SWAP_TRADE_V2.md
• Multi-hop swap: docs/instructions/MULTI_HOP_SWAP.md
• Creating a coin paired with a pump coin: docs/instructions/CREATE_WITH_PUMP_COIN_QUOTE.md
• Fee sweeps (fees kept on the curve and pool): docs/instructions/SWEEP_FEES.md
• Virtual quote reserves and fees: docs/VIRTUAL_QUOTE_RESERVES_FEE_ADJUSTMENT.md
• Synthetic migration (the last buy has no max size): docs/SYNTHETIC_MIGRATION.md
• Holder rewards coins: docs/HOLDER_REWARDS_README.md
• Fee recipients: docs/FEE_RECIPIENTS.md
• Coin creation: docs/instructions/COIN_CREATION.md
• Buy: docs/instructions/BUY.md
• Sell: docs/instructions/SELL.md
• Claim cashback (existing cashback coins only, cashback is deprecated): docs/instructions/CLAIM_CASHBACK.md
• Collect creator fee: docs/instructions/COLLECT_CREATOR_FEE.md
• Creator fee sharing: docs/instructions/CREATOR_FEE_SHARING.md

Other documentation

• Pump Program
• PumpSwap
• PumpSwap SDK
• Pump Program creator fee update
• PumpSwap creator fee update
• FAQ
• Pump fee program docs

---