orbo:~/docs$ man orbo▌

01what orbo is↑ contents#

orbo launches tokens on pump.fun and runs their creator fees. every token gets its own wallet, made for that token alone. the creator fees its trading earns go there, and an agent decides, within limits you set, when to claim them and when to spend them buying the token back. everything it buys is burned in the same transaction. it never sells.

10% of every claim goes to the protocol, in SOL, in the same transaction as the claim. the other 90% belongs to the token: it is only ever used to buy that token back and burn it. the person who launched the token doesn't receive creator fees. that's the deal: you give up the fees, and the token gets a buyer that keeps buying.

        trades on pump.fun
               │ creator fee on every buy and sell
               ▼
     ┌──────────────────────┐
     │ the token's orbo     │   one wallet per token,
     │ wallet               │   nobody else's fees in it
     └──────────┬───────────┘
                │ claim
       ┌────────┴─────────┐
       ▼                  ▼
   10% to the         90% buyback budget
   protocol (SOL)          │ buy, when the agent decides
                           ▼
                     burn, same transaction

there are two ways in: launch a new token here, or launch it on pump.fun and join it, either as you create it or afterwards. after that, both are managed exactly the same way.

02launching a token↑ contents#

1. 01name it. name, symbol, description, an image and optional links. the image and the metadata are pinned to IPFS, so the token doesn't depend on this site staying up.
2. 02set its fee policy. the hard limits the agent works inside. see your fee policy.
3. 03optionally buy some first. an initial buy happens in the launch transaction itself, so you get in at the starting price.
4. 04prove the wallet is yours. your wallet signs a short message. it costs nothing and moves no funds; it stops anyone from launching in your name.
5. 05sign the launch. your wallet pays for and signs one transaction that creates the token on pump.fun. the token's creator is set to its new orbo wallet, so its creator fees go there from the first trade.

orbo sends the transaction, waits for it to confirm and starts watching the token immediately. if your wallet sends it itself, or something interrupts the confirmation, orbo still finds the token on chain and takes it over within a few minutes.

noteon pump.fun, a launched token's creator is shown as its orbo wallet, not yours. that's how the fees reach the agent.

03joining from pump.fun↑ contents#

launching on pump.fun, or already launched there? the coin's creator can hand its fees to orbo. orbo uses pump.fun's own creator fee sharing: the coin's fees are split, permanently, 100% to a wallet orbo makes for that coin. there are three ways to do it; all end the same.

while you create the coin (the simplest)

1. 01set a fee policy and get an address on /join ("launching it now"). no wallet connects to this site, and nothing is paid. the address is for one coin.
2. 02create the coin on pump.fun as usual, and in its creator fee sharing add that address as the only recipient, at 100%. pump.fun locks the split.
3. 03that's it. orbo searches pump.fun for a coin whose fee sharing pays that address, finds it within seconds if /join is still open (or within minutes otherwise), checks it, and takes it over. you can also paste the new coin's address on /join to skip the search. if the split isn't 100% to the address, or the coin is one orbo can't run (paired with a token instead of sol, or a cashback coin), it says why and doesn't.

on pump.fun, for a coin that already exists

1. 01look it up and set its policy on /join, then ask for the coin's orbo address. it's made for that coin only, and asking again gives the same one.
2. 02on pump.fun, open the coin with the wallet that created it, go to its creator fee sharing, and set that address as the only recipient, at 100%. pump.fun locks the split.
3. 03that's it. orbo sees the lock within seconds if /join is still open, or within a few minutes otherwise, and takes the coin over. if the split isn't 100% to the coin's address, it says so and doesn't.

or sign it here

1. 01look it up. paste the coin's address on /join. orbo reads it from the chain and says whether it can join, and if not, why.
2. 02set its fee policy, the same as for a launch.
3. 03read the terms and connect the creator wallet. only the wallet that created the coin can join it. it proves it's yours with a free signed message.
4. 04sign once. one transaction turns on fee sharing for the coin with a single recipient at 100%, its new orbo wallet, and pump.fun locks it. from then on, nobody can change the split. not you, not orbo.

fees the coin earned before joining stay yours: the join pays them out to you, or leaves them in your own creator vault to collect as usual. everything after goes to the coin's orbo wallet, and from there exactly as described in where the fees go.

which coins can join

• -SOL-paired coins, on the bonding curve or graduated.
• -SPL Token and Token-2022 coins, including mayhem-mode coins.
• -coins with no fee sharing yet, or with fee sharing set up but not locked, run by the connecting wallet.
• -not: cashback coins (their creator fee goes to traders, so there's nothing to redirect), coins paired with another token, coins whose fee sharing is already locked to someone else, and coins already managed here.

notea joined coin shows up in the token lists after its first claim, with a joined badge. its own page works from the moment it joins. if pump.fun's admins ever reassign a joined coin's fee sharing, orbo notices and stops managing it.

04where the fees go↑ contents#

pump.fun charges a fee on every trade, and part of it is the creator fee. depending on how the trade was made, it lands in the creator's vault right away or waits on the bonding curve (or in the pool, after graduation) until someone sweeps it. orbo counts both as claimable, and its claim transaction sweeps whatever is waiting first.

pump.fun doesn't split anything: 100% of a token's creator fees go to its orbo wallet, whether it was launched here or joined. the 10% is sent on from that wallet inside the claim transaction itself, so there is never a moment where the fees are claimed but the protocol's share hasn't moved.

a claim, step by step (one transaction)

launched here                          joined from pump.fun
──────────────────────────────────     ──────────────────────────────────────
sweep fees waiting on the curve/pool   sweep fees waiting on the curve/pool
collect the vault → token's wallet     pump.fun pays the fee-sharing vault
                                         out: 100% → token's wallet
───────────── both ──────────────────────────────────────────────────────
transfer 10% of what was collected → protocol treasury, in SOL
keep the rest in the token's wallet: a small reserve, then buyback budget

• -the 10% is a fixed rule in the code, not a setting. every claim pays at least its own full 10% in the same transaction; if more fees arrived between building the claim and running it, the difference is settled afterwards.
• -the protocol's share is never used for buybacks, and the buyback budget is never paid to anyone.
• -each token's wallet keeps a small SOL reserve for rent and fees, topped up from claims before anything is added to the budget.
• -the launcher, or the creator of a joined coin, never appears as a recipient. there is no setting that changes this.

05how the agent decides↑ contents#

each token is looked at only when something meaningful changes, so quiet tokens cost nothing. a look is triggered when:

• -its unclaimed fees reach the claim minimum (and again each time they grow by a good margin),
• -a claim has just made buyback budget available,
• -its price moves enough since the last look,
• -or it has been quiet for a while (it gets looked at every 30 minutes at the latest).

who decides what

• -claims are decided by rule. once unclaimed fees reach the minimum and no buyback is due, they're claimed. nothing to judge.
• -buybacks are decided by the model. it's only asked when a buyback is actually possible: there is budget, the cooldown has passed, and at least one buyback condition holds.
• -the rules never buy. if the model is unavailable or its answer fails validation twice, orbo claims by rule if it can and otherwise waits. a buyback always needs a validated model decision.

when a buyback is on the table

never     the price is up more than 25% in the last 15 minutes
          (it doesn't chase a pump)

otherwise, at least one of:
          the price is at least 10% below its 24-hour high
          the price is flat or down over the last 15 minutes
          the budget has piled up to twice the per-buyback limit

the model answers in a strict format: an action, an amount, a confidence and a one-line reason. orbo checks it against the hard limits in code before anything happens: the amount can't exceed the budget, your per-buyback maximum or the protocol's global cap, the cooldown must have passed, and the action must be one of claim, buyback or nothing. there is no sell action anywhere, so it can't be asked for or produced.

the model runs on our own hardware. no outside AI service sees the prompts or decides anything.

06your fee policy↑ contents#

set at launch or join. these are limits, not targets: inside them, the agent picks when and how much.

notethe 10% to the protocol and the 90% for buybacks are fixed for every token. they aren't part of the policy.

07curve and graduation↑ contents#

on the bonding curve

a buyback buys an exact number of tokens straight from the pump.fun curve and burns exactly that number in the same transaction. the most it can pay is the planned amount plus 15% (the slippage every coin uses, sent through a protected route so bots can't sandwich it); if the price moved further, the transaction fails and nothing is bought.

after graduation

once a token graduates to pump.fun's AMM, buybacks are routed through a swap aggregator. every route is checked before the token's wallet signs it: only known swap programs, only from SOL into this token, never more than planned. the swap's guaranteed minimum is burned in the same transaction, and anything it filled above that minimum is burned right after.

buybacks stay private until they land

a buyback is sent through a protected route and isn't shown on this site until it's confirmed, so nobody can read it off the feed and trade ahead of it.

08watching it work↑ contents#

• -live: the agent at work, every token it watches orbiting it. buys and claims play out as they happen.
• -log: every decision, including the ones where it chose to do nothing. open any of them to see the exact prompt, the raw model output, the validation result and the transaction. its stream view types out the model's reason for each decision as it comes in; buybacks appear there once they have landed.
• -tokens: each token's page shows its fees, claims, buybacks, burned supply, policy and managed wallet.
• -protocol: totals over time: fees claimed, bought back and burned, and the protocol's 10%.

every transaction links to a block explorer, so anything shown here can be checked on chain.

a token's price chart is built from every trade on it, like pump.fun's: orbo reads each trade straight from pump.fun's and PumpSwap's own records on chain, with the price it left and how much SOL moved. so the highs and lows are real trades, the bars underneath are the volume, and the last candle moves as people trade. it shows market cap in dollars by default (SOL/USD from Pyth's on-chain price feed, today's rate for the whole chart), or price, or SOL. under it is every trade: who, how much, and the transaction. yours say you, and "orbo · burn" is the coin's own wallet buying back. history from before orbo recorded a coin's trades is drawn from its price samples (every 15 seconds, on a move of 0.5% or more); those candles have no volume, and a flat grey one means it looked and nothing moved that much.

charts are drawn with TradingView Lightweight Charts™, Copyright (c) 2025 TradingView, Inc. https://www.tradingview.com/, under the Apache License 2.0.

09wallets and safety↑ contents#

• -one wallet per token. each is derived from a master key the operator keeps, with an offline backup. a token's fees never mix with another's.
• -the operator pays the network fees for claims and buybacks. a token's own wallet only ever spends on its 10% to the protocol and on buying itself back.
• -what the agent can do is limited in code: claim, buy back and burn, or nothing. it can't sell, can't send a token's SOL anywhere but the protocol's 10% and the swap, and can't exceed your limits or the global caps.
• -wallet proofs are free signed messages, each usable once, for one purpose (launch or join), for 5 minutes. they never move funds.
• -pump.fun is still pump.fun. its own admins keep powers over coins that nobody else can remove, for coins launched here and joined coins alike.

notenone of this is financial advice. these are memecoins on a bonding curve: they are risky, and buybacks don't guarantee a price.

10what things cost↑ contents#

11questions↑ contents#

12terms↑ contents#

creator fee

the part of pump.fun's trading fee that goes to a coin's creator.

creator vault

where pump.fun holds a creator's fees until they're claimed.

bonding curve

pump.fun's built-in market for a new coin: the price rises as people buy.

graduation

when the curve fills up and the coin moves to pump.fun's AMM pool.

fee sharing

pump.fun's way to split a coin's creator fees between wallets. a joined coin's split is 100% to its orbo wallet, locked.

claim

collecting the fees into the token's wallet, with 10% to the protocol in the same transaction.

buyback

spending the token's budget to buy it, then burning what was bought.

burn

destroying tokens for good: the supply goes down.

budget

the token's SOL set aside for buybacks: what's left of its claims after the 10% and the reserve.

mayhem / token-2022

newer kinds of pump.fun coins. both are supported.