Famulus
Find a coin
Docs

How the keeper works, in full

Everything Famulus says about a coin comes from the chain, and everything it does with money is a transaction you can read. This page explains both.

How it reads

Famulus reads Solana itself. It does not use pump.fun's website or any price feed. It keeps a live connection to a Solana node, subscribed to each coin it reads, and decodes the events pump.fun and PumpSwap programs write into every trade: who bought or sold, how many tokens, for how much SOL.

  • Trades arrive live. When the connection drops, Famulus reconnects and reads the signatures it missed, so the gap is filled.
  • Holders come from reading every token account of the coin at once, again and again: every few minutes for coins people follow, less often for others. The bonding curve and the pool are not counted as holders.
  • The launch window is read by paging back to the coin's first block and decoding the first transactions.
  • Wallet funding is traced for the dev, the early buyers and the largest holders: Famulus finds the first SOL each one received. Wallets with a thousand or more transactions are not traced, since where they started says little now.
  • New launches: Famulus watches pump.fun's create events and reads the first minutes of new coins. The busy ones show up on the coins page.

Transactions a node only simulated never happened. Famulus drops them before they reach any count.

What it looks for

Top ten share
The share of supply the ten largest wallets hold. Flagged from 30%, warned from 50%.
The dev wallet
The wallet pump.fun names as the coin's creator: what it holds, every sale, and tokens it moved to other wallets without a sale.
Bundle
Wallets other than the creator that bought in the same block as the create.
Snipers
Wallets that bought in the three blocks after the create.
Cluster
Wallets first funded by the same source, funded by another holder, or bundled together. A source that funded holders of many unrelated coins, like an exchange, does not link anyone.
Whale
A wallet holding at least the coin's whale line, 1% of supply unless its creator set another.

These are readings, not verdicts. A coin with warnings can do well and a clean one can fail. Famulus never says which.

How it answers

For coins whose creator has connected, holders can ask the agent questions. Before answering, Famulus turns its reading of the coin into a list of numbered facts, each a plain sentence with the time it was read. The answer may use only those facts, and shows the ones it used.

  • Every number in an answer is checked against the facts it cites. An answer with a number that is in none of them is thrown away.
  • If no fact answers the question, the agent says it does not know.
  • It does not tell anyone to buy or sell, predict prices or promise anything.
  • What visitors type travels as data, fenced off from the agent's rules. Text that tries to change the rules or pull out instructions is answered by the rule-based answerer and never reaches the model.
  • Answers are written by a language model through OpenRouter when it is available, within a daily spending cap per coin and in total. Past the cap, or without the model, a rule-based answerer replies from the same facts.

Alerts

The dev wallet sold
Any sale from the creator wallet, with the size and what it still holds.
A wallet linked to the dev sold
A sale from a wallet in the creator's cluster.
The dev moved tokens
The creator wallet's balance fell without a sale.
A cluster is selling
Three wallets from one cluster sold within 15 minutes, or the cluster sold more than its threshold of what it holds.
A whale entered or left
A wallet crossed the whale line, or a whale sold half or more.
Liquidity moved
The curve completed, the coin moved to PumpSwap, or someone added to or withdrew from the pool.

Alerts show on the coin page the moment they are raised. Follow a coin and they also reach your device as notifications. On iPhone, add Famulus to the home screen first; Safari only delivers web notifications to installed sites.

Post drafts

For connected coins the agent writes a daily summary, a post at holder milestones, at graduation and at the first burn. They are drafts for the creator to copy. Famulus never posts anywhere itself. The X button only opens X with the text filled in. Drafts state what the chain shows and never talk about price.

The burn

A coin's creator can route part of its creator fees to its famulus, which buys the coin back and burns it by rules shown on the coin page: the share of each fee claim, at most one burn per so many hours, the largest single burn, and the worst price accepted. Every burn has a receipt that links to its transaction.

Now: creator-signed burns

The creator signs every step in Phantom. Famulus builds the transactions: claim the waiting creator fees, then buy the coin with the share the rules allow and burn all of it in the same transaction. Famulus never holds a key or a lamport. It checks every receipt against the published rules and marks any burn that came early or was too big. What this cannot do is force a creator to keep burning: the rules are a public promise, and the receipts show whether it is kept.

What it cannot do

  • It cannot protect against a fall in price. Burning tokens does not set a price.
  • A burn buys at the market. Someone can trade around it; the largest-burn rule and the price limit bound what that can cost.
  • A creator can stop burning at any time. The coin page shows when the last burn was.

Famulus never holds anyone's money or keys, and no burn depends on money from Famulus.

$FAMULUS

When $FAMULUS is live, a part of every burn run through Famulus buys $FAMULUS and burns it in the same way, as its own transaction with its own receipt. Holders of $FAMULUS can follow more coins, get alerts the moment they are raised instead of in a five-minute digest, and see every past daily report. More on the token page.

Limits and privacy

  • Questions, follows and new coins are rate limited per visitor, and questions per coin.
  • Famulus stores no names or emails. Visitors are counted by a salted hash of their network address.
  • Following a coin stores your browser's push address and the coins you follow, nothing else.
  • Coins whose names are offensive or name real people are read when pasted, but not shown on Famulus's own lists.