Game Manual

Everything about PUMPBOIS: what the agent does, how the free plays work, where the money comes from, and the API underneath.

01 WHAT IS PUMPBOIS

PUMPBOIS is an autonomous trading agent wired into pump.fun, wrapped in a memecoin ($BOIS). The agent watches every new token minted on the platform, scores it against a set of filters, and — once live trading is enabled — takes positions with strict risk rules. Everything it does is logged to a public feed.

The token and the agent are one loop: the coin funds the agent, the agent gives the coin something real to point at.

02 PLAYING THE AGENT (FREE)

Anyone can use the scanner on the landing page — no wallet, no signup, no payment.

3 runs per 24 hours per IP. A run = one full scan of a mint address you choose.
Runs are counted on a sliding 24-hour window; your quota comes back as old runs age out.
The agent is locked until launch (Sep 05 · 15:00 UTC). Before that, every request returns LOCKED.

Each run returns a score (0–100), a verdict — BUY / WATCH / SKIP — and the list of reasons behind it: token age, socials, market-cap band, bonding-curve progress, community activity.

⚠ NOT FINANCIAL ADVICE Verdicts are heuristic output from a machine that likes pixels. They are information, not instruction. You can lose everything trading memecoins. DYOR.

03 WHY IT’S FREE — THE FEE LOOP

pump.fun pays token creators a dynamic creator fee of 0.05%–0.95% of every trade, scaling with market cap. Those fees are claimable at any time and can be split across up to 10 wallets.

PUMPBOIS routes them like this:

$BOIS trades on pump.fun
      ↓  creator fee (0.05–0.95%)
TREASURY WALLET          ← claims logged in treasury_flows
      ↓                        ↓
SNIPE CAPITAL            INFRA (RPC, servers)
      ↓
agent buys/sells → PnL → back to treasury

So the free public scanner and the agent’s trading capital are both paid for by trading volume on the coin itself. More volume → bigger treasury → stronger agent. Every flow is a Solana transaction you can verify.

04 HOW A SCAN WORKS

Age — fresh pairs (<30 min) score higher; stale ones don’t.
Phase — still on the pump.fun curve beats already-migrated.
Market cap band — the $20K–$200K “sweet spot” scores best.
Socials — Twitter/Telegram/website present or not.
Volume velocity — last hour vs 24h average; acceleration scores.
Buy pressure & liquidity — buys/sells ratio last hour, thin liquidity is penalized.

Live-trading mode adds harder filters (dev holdings, bundler detection, holder spread) before real money moves. Those run server-side only.

05 API

The landing page uses this API; you can call it directly too. Same limits apply.

ENDPOINT	WHAT IT DOES
GET /api/status	Launch time, live flag, contract address, your quota settings.
POST /api/agent/run	Body `{"mint":"<address>"}`. Returns score, verdict, reasons, and `remaining` credits.
GET /health	Liveness check.

RESPONSES YOU’LL MEET

CODE	MEANING
403 LOCKED	Agent not launched yet. Comes with `launch_at`.
429 RATE_LIMITED	3 runs used. Comes with `reset_at`.
422	Scan failed — invalid mint, or token not on pump.fun.

# example
curl -X POST https://API_BASE/api/agent/run \
  -H "content-type: application/json" \
  -d '{"mint":"YOUR_MINT_ADDRESS"}'

ⓘ FAIR USE The limit is per IP, enforced server-side. VPN-hopping for extra credits just burns treasury money that would otherwise trade for the community. Be cool.

06 FAQ

DO I NEED TO HOLD $BOIS TO USE THE AGENT?

No. It’s free for everyone. Holding $BOIS is what keeps it free — fees from trading fund the whole machine.

CAN THE AGENT LOSE MONEY?

Yes. It trades memecoins; drawdowns are part of the game. Risk rules (stop-loss, position caps) bound each loss, and the public feed shows everything — wins and Ls.

WHERE’S THE WALLET / TREASURY?

Addresses are published at launch, and every treasury flow lands in the public treasury_flows feed with its transaction signature.

WHY ONLY 3 RUNS?

Each run costs real infrastructure. Three free scans a day keeps the arcade open for everyone without draining the treasury.