Pally — docs

Telegram bot @PallySocialBot · home

start

DM the botOpen @PallySocialBot, send /start.
Add to a groupAdd @PallySocialBot as a member. It needs to see messages to catch pasted addresses; if it ignores them, an admin must run /setprivacy → Disable in @BotFather for the bot, or just use /scan.
/trial3 days of access for this chat. One per chat, one per Telegram account, ever.
/subscribePay for this chat. See access.
/chatidThis chat's id.

scan

paste a contract addressAny message containing a Solana or EVM address gets the scan card. Groups only if privacy mode is off.
/scan <CA | ticker | name>Scan card. A ticker resolves against tokens already in the index, then DexScreener. If several tokens share the ticker you get the candidates with addresses. Also works as a reply to a message containing an address.
/callers <CA | ticker | name> [page]Everyone who has called the token, with call count and last call time. 40 per message; add a page number for the rest (/callers <CA> 2).
/thesis <CA | ticker | name>Only the scan card's thesis: the one-line summary of what the callers on fomo and pump.fun wrote about the token. Counts as a scan toward the chat's scan budget. Also works as a reply to a message containing an address.

The scan card shows: who called it on fomo and pump.fun with their theses, which of those callers are on fomo's or pump.fun's own leaderboards (with rank), a one-line summary of the theses, largest holders with sniper/bundler flags, holder count, price/mcap/liquidity/24h from DexScreener, the first caller seen on each source, and quick links (DexScreener, Defined, DexTools, GMGN, Birdeye, Photon, Axiom, Padre, OKX, Jupiter, Trojan, Maestro, Banana Gun, Bloom, Nova, Sigma, Bubblemaps, RugCheck, X search, explorer — the set depends on the token's chain). The same card also shows the share of supply the callers hold and the top holder's and top wallet's theses at length. When both fomo and pump.fun have calls, the newest are listed per source.

Limits: 30 scans per chat per 10 minutes, 300 per day. The same address scanned again within a minute is served from cache.

analytics

/topcallers [day | week | all]The platforms' own leaderboards, live: fomo's top traders by real closed PnL and pump.fun's top callers by callout multiples (avg, % that hit 2×, best). Default week. These are ranked by fomo and pump.fun on data we don't hold, so they can't be gamed against our index.
/topcallers indexOur own board over the traders we've indexed, by money (realized + credible unrealized). ★ = fomo, all-time, from their positions. ◆ = pump.fun, the PnL pump.fun itself reports, 30-day window.
/topcallers index wr | pnl | upnlOur board by win rate, realized $, or unrealized $ on open positions. On the win-rate board ★ = fomo, real closed positions, and ○ = pump.fun, a proxy (the call peaked ≥ 2×; pump.fun exposes no per-call PnL). ⚠️ paper marks rows whose unrealized exceeds 3× banked gains + $25k, or that Jupiter can't sell near the mark.
/themesNarratives proven callers are converging on: token count, caller count, proven-caller count, realized PnL, momentum.
/recentbuysWhat top callers just bought.
/convergence [hours]Coins multiple top callers bought in the window. A snapshot, not a push — run it again for the current picture. fomo positions only.
/freshbuys [days]What brand-new fomo accounts (created within N days, max 90) are buying.
/tails [@handle]Who tails who: pairs of callers who repeatedly first-call the same tokens in order. With a handle, only that caller's pairs.
/statusWhether fomo and pump.fun are answering right now, and when each was last fetched.

tracking

Pushes land in the chat that set them up. Only calls made after you start tracking are pushed; history never replays.

/trackcoin <CA | ticker>Every new thesis or callout on the coin, from anyone, on fomo and pump.fun. Checked every 3 minutes. Max 10 coins per chat.
/untrackcoin <CA | ticker>Stop.
/trackpump <handle | wallet | pump.fun profile link>A pump.fun caller's new callouts, full text, with their current holding in the token. Checked every minute. Max 10 callers per chat.
/trackfomo <handle>A fomo caller's theses. fomo has no per-user feed, so these fire when the caller's thesis turns up in a scan or a tracked coin.
/untrackpump, /untrackfomo <handle | wallet>Stop.
/autoscan <on | off>Off: pasted contract addresses are ignored in this chat and only /scan gets a card. On (the default): a pasted address is scanned. Group admins only; no argument shows the current setting.
/trackcoin, /trackpump, /trackfomo (no argument)List this chat's tracks.

access

unitA Telegram chat. A subscribed group = everyone in it, present and future. A subscribed DM = one person.
trial/trial: 3 days, once per chat and once per Telegram account.
card/subscribe → "Card" button → Whop checkout. $100/month solo (DM), $250/month group. Renews monthly; cancel any time on Whop. Access lands in the chat automatically after payment.
USDC/subscribe → the message ends with an exact amount (e.g. 100.437 USDC) and a Solana address. Send exactly that amount in USDC on Solana from any wallet — the amount that arrives must be at least the invoice, so if your exchange deducts a withdrawal fee, add it on top. The decimals identify your chat; access lands automatically, usually within a minute. Each payment is 30 days, added to whatever is left. Invoice valid 24 h.
/paid <transaction link>Sent the round price without the decimals? If yours was the only open invoice at that price, access still lands by itself. If the bot can't tell whose payment it is, it asks — reply /paid with the transaction link (from your wallet's activity or Solscan) in the chat you're paying for. Any other wrong amount is not lost: it's held and matched by hand; message the operator.
expiryA reminder 24 h before, a notice when access ends. Paid time stands unless a card payment is refunded or charged back, which removes that payment's 30 days.

MCP / API

The same index over MCP (Streamable HTTP, JSON responses) for your own Claude, Cursor, script or bot. You pay your own model bill. Keys are issued by the operator with a subscription.

URL      https://pallybot.duckdns.org/mcp
Auth     Authorization: Bearer tb_…
Claude Code:
  claude mcp add --transport http trench https://pallybot.duckdns.org/mcp --header "Authorization: Bearer tb_…"
curl:
  curl -s https://pallybot.duckdns.org/mcp -H "Authorization: Bearer tb_…" -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"leaderboard","arguments":{"by":"wr","limit":5}}}'
toolargumentsreturns
resolve_tokenquery ticker, name or addressRanked candidates: ca, chain, symbol, n_calls, n_callers, liquidity. Falls back to DexScreener when the index has nothing.
resolve_callerquery handle or walletRanked candidates with identity_ids (one handle can be several accounts — pass all of them to the caller tools), platform, win rate (pump.fun = proxy).
token_overviewca, chain (solana | evm)Symbol, name, mcap, ATH mcap, supply, call and caller counts, first seen.
token_callsca, chain, limit ≤ 60Calls on the token: handle, platform, time, position size where known, thesis text.
token_proven_callersca, chainCallers on the token who clear the win-rate bar, with their stats.
caller_callsidentity_ids, limit ≤ 40, optional ca/chainThe caller's calls, newest first; data_as_of. Refreshed live from pump.fun/fomo unless swept in the last 10 min.
caller_positionsidentity_ids, status active | closed, limit ≤ 40fomo positions with realized/unrealized PnL, entry, exit, cost basis.
caller_tradesidentity_ids, optional ca, limit ≤ 50On-chain swaps for the caller's wallet (Helius on Solana, Blockscout on EVM) and net positions — the "did they sell" answer for pump.fun callers. Empty = not collected yet, not "no trades".
price_atca, chain, ts ISO 8601Price near that time from collected fills; null = no data, not zero.
callers_on_bothca_a, chain_a, ca_b, chain_bCallers who called both tokens.
leaderboardsource index | fomo | pump, period day | week | all, by total | wr | pnl | upnl, limit ≤ 25source=fomo / pump: that platform's own live board (prefer these). index (default): our computed board; rows marked fomo (real PnL) or pump.fun (proxy).
themeslimit ≤ 25Same as /themes.
smart_money_buyshours, limit ≤ 30Same as /recentbuys.
convergencehours, min_callersSame as /convergence.
fresh_account_buyshoursSame as /freshbuys.

Per key: 30 tool calls per minute, 2000 per 24 h, 20 live refreshes per hour on the caller tools (after that they read stored history and say so in note), batches of at most 20 messages. A rate-limited call returns an isError result saying so — back off, don't loop. Tool failures come back as isError results, never as JSON-RPC errors.

data

indexPartial. "Nothing found" means nothing in the index, never "nobody called it".
fomoTheses from holders, positions with real closed-position PnL. All chains fomo supports.
pump.funCallouts with thesis text and market cap at call. No position or sell data per call; win rate is a peak-multiple proxy and is labelled so. Dollar PnL exists only for traders on pump.fun's own PnL leaderboard, as pump.fun reports it. Sells are visible only through caller_trades where the wallet has been swept.
on-chainDexScreener (price, mcap, liquidity, volume, pool age, socials, chain of an EVM address), Blockscout (EVM holders on Robinhood, Base, Ethereum), pump.fun top holders and Helius (Solana holders), Jupiter sell quotes for sellability, Solana RPC for supply.
freshnessA scan pulls both sources live (cached 60 s per address). Caller data can be hours old between sweeps; the MCP tools return data_as_of.
storedTelegram chat and user ids, addresses scanned, tracks, payment references. No card or wallet keys.

Information, not financial advice. Callers can be wrong or lying; the bot reports what they said and what the chain shows.