docs

How the drip works.

Everything below is computed from public data — the holder set is on-chain, the price is public, and the rounding rule is written down. Read it, then re-run it yourself.

Overview

A pump.fun creator redirects their fees through pump.fun's own fee system. Each cycle, those fees buy a tokenized stock on Solana, and that stock is split across the coin's holders in proportion to what they hold.

StonkDrip never holds the coin, the fees, or your keys. It reads the chain, does the arithmetic, and the arithmetic is the product.

The split, exactly

pot        = creator_fees ÷ stock_price     (in whole stock)
pot_units  = floor(pot × 10^8)            (indivisible units)

eligible   = holders whose share ≥ 0.1%
share      = balance ÷ eligible_supply
units      = floor(share × pot_units)

leftover   = pot_units − Σ units
             → handed out one unit at a time to the
               largest fractional remainders

Note that share is taken over the eligible supply, not total supply — so the pot is always fully distributed rather than partly stranded on wallets too small to qualify.

Who earns

·Any holder with at least 0.1% of eligible supply at snapshot time.
·No signup, no claim, no staking — holding is the entry.
·Sell below the minimum and you simply stop qualifying; buy back in and you're back.
·The cadence is every 60 minutes, and our cut is 0%.

Rounding & dust

Naive pro-rata code rounds each holder separately, which either pays out more than the pot or leaves units stranded. StonkDrip floors every share, then hands the remaining units out one at a time to the largest fractional remainders (the largest-remainder method), with ties broken by address so the result is deterministic.

Result: the payouts sum to the pot exactly. Nothing is lost, nothing is invented, and no dust quietly stays behind.

Excluded addresses

Some addresses would otherwise farm the reward they help create. These are removed before any share is computed, so they neither receive nor dilute:

·the bonding curve / pool account
·burn and system addresses
·the reward wallet itself

Attaching a coin

1Pick the stock your coin should drip — 59 are available.
2Redirect creator fees through pump.fun's native fee system.
3Holders start earning on the next cycle. No migration, no custody.

Automated routing and payout execution is the part still being built — it is listed as roadmap on the front page, not dressed up as live. What runs today is the engine that computes the split, and you can point it at any coin right now.

simulate a cycle →stock menu

API

Read-only JSON, live from the chain.

POST/api/drip

Run a cycle: reads the coin's holders on-chain, prices the stock live, returns the exact split.

{
  "mint":    "<pump.fun mint>",
  "stock":   "SPYx",
  "feeUsd":  250,
  "minShare": 0.001
}

GET/api/stocks

The stock menu with live prices and 24h change.

{ "stocks": [ … ], "count": 59 }

GET/api/state

Honest protocol aggregate — zeros until real cycles settle.

{ "coinsAttached": 0, "cyclesSettled": 0, "stockMenu": 59 }

Honesty & safety

·Every number here is real or zero — never invented. Attached coins and settled cycles read zero because none exist yet.
·Non-custodial: fees move through pump.fun's own system. We never take custody of a coin, a fee, or a key.
·No address is shown for $SDRIP until it's real; the only official CA lives on the token page and our X.