Every coin gets a vault. Every callout pulls the trigger.
pumpball launches pump.fun coins paired with PUMP, whose creator fees can only go one place: back into the coin. This page is the whole rulebook, and its numbers are read from the same config the keeper runs.
The loop
Six steps, and then it goes around again.
- 01
Launch
You fund a brand-new vault wallet with a little SOL, and pumpball creates the coin on pump.fun, paired with PUMP, with that vault as its creator. From the first trade, the creator’s cut belongs to the coin instead of to a person.
- 02
Trading pays the creator fee
Traders buy and sell with PUMP, and every trade pays a 3% creator fee in PUMP, on the bonding curve and after graduation to PumpSwap. The rate is fixed when the coin is created.
- 03
The vault receives it
pump.fun fee sharing routes all of the creator fee to the coin’s own vault, in PUMP, and the config is locked so nobody can point it anywhere else later.
- 04
Someone calls it out
Someone calls the coin out in the pump.fun app, and that callout is the trigger. pump.fun allows one callout per account every six hours.
- 05
Buy and burn, one transaction
The keeper spends PUMP from the vault to buy the coin and burns every token it bought in the same transaction. The tokens never sit in a wallet, so there is nothing to sell later.
- 06
Attention
The shot lands on the chart as a buy, the supply shrinks, and the transaction is linked from the coin’s page. That gives people something to talk about: more trades, more callouts. Back to step 2.
When it fires
The keeper takes a pass over every live coin every 15 seconds and makes one decision for each.
Fast lane
A callout fires now
Each new callout the keeper hears fires a shot on its next pass. It goes straight past the cooldown and the score.
- One callout buys at most one shot. Callouts are answered oldest first, one per shot.
- Every callout is tracked by its id, so the same callout seen twice is ignored the second time.
- Callouts are read from pump.fun’s public, undocumented API.
Otherwise
Four terms, each from 0 to 1
Callouts
Unanswered callouts. 3 waiting scores 1.0.
Clock
Time since the last shot, or since launch. 20 min scores 1.0.
Full vault
The standing budget against a full shot, the most the impact cap allows. Enough for a full shot scores 1.0.
Dip
How far the price sits under its 1 hour average. A 12% drop scores 1.0, once 5 prices are in.
Any term at 1.0
fires on its own. A full clock, a full vault or a deep enough dip is reason enough.
Blend at 0.50
Below that, the terms add up by weight and the blend fires at 0.50. Several half-reasons make a shot.
Cooldown
After a shot, clock-driven shots wait 10 min. A callout doesn’t wait.
Minimum spend
If the budget is under 100 PUMP, nothing fires, whoever asked. A standing callout keeps its place and fires once fees refill the vault.
Example pass
0.32
No term is at 1.0, so the blend decides: 0.325 is short of the 0.50 threshold.
Example pass
0.52
No term is at 1.0, so the blend decides: 0.520 reaches the 0.50 threshold.
How big a shot is
A shot spends a share of what the coin has earned, leans in when the price has dipped or someone called it, and never spends past either of two ceilings.
spend = min(
budget × spendShare
× (1 + dipBoost·dip
+ calloutBoost·callout),
budget,
reserve × impactCap
)- budget
- What the coin has earned and not yet spent, in PUMP: claimed creator fees minus earlier shots, never more than the vault holds.
- spendShare
- 75% of the budget before boosts.
- dip
- The dip term, 0 to 1, weighted by the dip boost.
- callout
- 1 when a callout pulled the trigger, otherwise 0.
- reserve
- The PUMP on the other side of the trade: the bonding curve’s virtual reserve, or the PumpSwap pool plus its virtual reserve.
- impactCap
- 1% of that reserve per shot.
Why the cap
On a constant-product market, buying with 1% of the PUMP reserve moves the price about 2%. Capping a shot at 1% of the reserve keeps each one a nudge rather than a spike, and with trading fees charged on both legs, sandwiching it costs more than it makes. A shot cut down by the cap carries a “capped” chip. Each buy allows 1% slippage.
Worked example
Say a callout arrives for a young coin whose vault has 20,000 PUMP to spend, trading against a 1,500,000 PUMP reserve.
- budget × 0.75 × (1 + 0.5)
- 22.5K PUMP
- budget
- 20K PUMP
- 1% of the 1.5M PUMP reserve
- 15K PUMP
Live parameters
Straight from the config the keeper runs.
| Parameter | Value |
|---|---|
Cadence The clock term reaches 1.0 after this long without a shot. | 20 min |
Cooldown Minimum gap after a shot before a clock-driven shot. Callouts skip it. | 10 min |
Spend share Share of the standing budget a shot starts from, before boosts. | 75% |
Callout boost Added to the multiplier when a callout pulled the trigger. | 0.5 |
Dip boost Multiplied by the dip term and added to the multiplier. | 0.5 |
Impact cap The most one shot may spend, as a share of the PUMP reserve it trades against. | 1% (100 bps) |
Dip reference A drop this far under the 1 hour average scores 1.0. | 12% |
Dip window The average the dip is measured against, and how many prices it needs first. | 1 hour · 5 samples |
Callout reference Unanswered callouts that score 1.0 on the callouts term. | 3 |
Weights How the four terms add up into the blend. | callouts 0.30 · clock 0.35 · vault 0.20 · dip 0.15 |
Blend threshold The blend fires once it reaches this score. | 0.50 |
Minimum spend Below this budget nothing fires, whoever asked. | 100 PUMP |
Slippage Price tolerance on each buy. | 1% |
Creator fee Set on every new coin at creation and paid to its vault on each trade. | 3% (300 bps) |
Gas floor Below this SOL balance the vault stalls: no claims and no shots until it gets more. | 0.003 SOL |
Where the money comes from
Where each trade’s fee goes
paid in PUMPOn the bonding curve
3.95%per trade
- 3%creator fee → the coin’s vault
- 0.95%pump.fun protocol fee
After graduation, on PumpSwap
3.25%per trade
- 3%creator fee → the coin’s vault
- 0.20%liquidity providers
- 0.05%pump.fun protocol fee
pump.fun sets the protocol and liquidity-provider rates and can change them. The 3% creator rate is fixed when the coin is created.
Paired with PUMP
Every pumpball coin trades against PUMP, pump.fun’s own token. Traders buy and sell with PUMP, so prices, market caps, creator fees, budgets and shots are all counted in PUMP.
A fixed rate, a locked recipient
The 3% creator rate is set when the coin is created, at the most pump.fun allows, and nobody can change it afterwards. The fee-sharing config names the coin’s vault as the only recipient and is locked too. Each coin page shows whether the lock is in place.
Gas is paid in SOL
Claims and shots are Solana transactions, so the vault pays their network fees in SOL, from the gas float funded at launch. If it drops below 0.003 SOL the vault stalls: no claims and no shots until someone sends it SOL, and its coin page shows the warning.
The launch payment is not ammunition
Launching costs 0.045 SOL: a 0.025 SOL budget for creating the coin and a 0.02 SOL gas float that stays in the vault. Shots only ever spend PUMP the coin has earned.
What it doesn’t do
It isn’t free money
A shot spends fees that traders already paid. It adds buying and removes supply; it doesn’t make value out of nothing, and burned tokens promise nobody a price.
It isn’t a price floor
Shots are small on purpose, at most 1% of the reserve each, and a determined seller outpaces them easily. The price can still fall, a long way.
A callout is counted, not read
The keeper doesn’t judge what a callout says. A call with no words counts the same as a long argument, and a bearish call fires a shot like a bullish one.
The keeper is trusted; the record isn’t
The keeper holds the vault keys, so you are trusting it to follow these rules. You don’t have to trust its account of what happened: every shot is an on-chain transaction linked from its coin’s page, and the vault’s history is public.
Launch yours
Its own vault, its own shots, from the first trade.