Documentation

Every command.
Every feature.

Bid runs in four places at once: group chats (the trading floor), bot DMs (your private desk), inline search (any chat), and the Mini App (the full network). Here's everything they do.

πŸš€Getting started

Three ways in β€” pick any, they all share one account.

1 Β· DM the bot

Open the bot, hit /start, and run the 5-step setup wizard: handle, bio, who to follow, privacy, clan. Paste any contract address to get your first trading card.

2 Β· Add it to your group

Add the bot to any group as admin (it needs to see messages; it never deletes or DMs members). Every pasted CA becomes a live trading card for the whole floor.

3 Β· Open the Mini App

Tap the menu button in the bot (or /app) for the full experience β€” feed, search, positions, ranks, inbox, clan, profile.

πŸ“ Paper season

Everyone starts with a $10,000 paper balance and live market prices. Full product, zero risk β€” the leaderboards are real, the money isn't. Real rails come next.

🟩Trading

Works in DMs and in groups. Amounts accept 50, $50, 50u or 0.5sol.

/bid <amount> <CA|$TICKER> [thesis]Place a bid β€” attach a thesis and it travels with the trade, your profile and the token page.
/sell <CA|$TICKER> [percent]Sell a position (default 100%). Always shows a confirm summary first: tokens sold, USDC received, expected PnL.
paste any CAInstant token card with one-tap bid buttons β€” in DMs or on the group floor.
Confirm-first, always. Every buy and sell shows the full summary before it fires, then an Executing… state, then a βœ… receipt with your actual fill, average entry/exit and PnL. Presets 25/50/75/100% plus custom $ and % sells everywhere β€” bot and Mini App.

πŸ“ŠPortfolio

Your private desk, in DMs.

/homeDashboard β€” account value, open positions, realized PnL, clan, quick actions.
/positionsOpen positions with live PnL. Tap one for the manage view: token logo, entry vs current mcap, one-row buy and sell ladders, PnL card.
/walletBalance, equity, realized PnL β€” and a paper-balance reset.
/withdrawMove USDC (any destination chain β€” bridged for you) or any held token out to a pasted wallet address. Presets 25/50/100%, X% and $X, full confirm summary first.
/transferSend paper USDC to another trader β€” @handle + amount, confirm, done.
/slippageYour trade slippage tolerance β€” presets 10/20/40/80% or custom 1–100%.
⭐ watchlistStar any token in the app β€” Β±10% moves DM you with one-tap buy buttons (6h cooldown per token).
πŸ“Έ PnL cardsGenerate a share-ready PnL image for any position, one tap from the manage view.

πŸ›‘Groups & clans

Your group chat is a clan: one board, one banner, one shot at the weekly pot.

place a bid in a groupYour first group bid auto-joins you to that clan. One clan per trader β€” first one sticks until you leave.
/leaderboardThe clan board, in-chat β€” realized PnL, PnL %, bid counts, 24H/7D/30D/ALL buttons. Global board in DMs.
/clanYour clan, member count and how to switch.DM
/myclanYour clan's leaderboard, right in the DM.DM
/clanboardEvery clan ranked by realized PnL β€” the pot race, with 24H/7D/30D/ALL windows.
/leaveclanLeave your clan β€” your next group bid joins that group's clan instead.DM
/optout Β· /optinHide from (or rejoin) this clan's board and pot without leaving the group.GROUP
/exclude Β· /include @userAdmins: remove a member from the clan (board + pot), or bring them back.ADMINS
βš™οΈ Clan SettingsGroup owners & admins get a Settings sub-tab in the Mini App's Clan tab: floor-alert mode (buys+sells / buys only / off), followed-trader alerts on/off, member remove & re-add, and the clan's follow list β€” followed traders' trades and followed tokens' Β±10% moves post straight into the group.OWNERS
Fair by design. A trader's PnL scores for exactly one clan β€” no double-counting across groups. Boards rank performance, never volume, so wash trading buys nothing.

πŸ“‘Scanner & scan boards

Paste a CA anywhere and Bid keeps the receipts forever.

paste any CAFull card: price, FDV, liquidity, volume, age, 1H/24H flow, buys vs sells, ATH mcap + when, links with real chain logos.
🚨 security auditBuilt into every card: unverified-CA warning, honeypot risk, buy/sell taxes, top-holder concentration, holder count (GoPlus).
πŸ‘₯ top holdersWhich Bid traders hold it β€” profile picture, $ value, % of supply, PnL, and their attached thesis.
πŸ† first scanThe first caller in your group is stamped with the mcap they called at β€” and the (XΓ—) it did since.
/ga [24h|7d|30d]The scan board: every scanner's calls, hit rate (2Γ—+ after the call), average X, best call β€” plus the group's top calls.GROUP
@bidbot <name>Inline mode β€” type it in ANY chat for instant, shareable token cards with logos.

πŸ‘₯Social

Profiles, follows, DMs β€” reputation you can verify.

/profile [@user]Trading profile β€” open & closed positions, full history feed, equity curve, entry/exit mcaps, hold times.
/follow Β· /unfollow @userFollow a trader: their bids DM you live and fill your following feed.
/followingWho you follow.
πŸ“¨ inboxDM traders inside the app β€” unread badges, per-thread mute & delete, reply-lock states.
🧠 thesesPost reasoning with a trade or standalone; likes surface the best takes on token pages and feeds.
/privacyPublic (leaderboard-eligible), friends-only (mutuals β€” people you follow who follow you back), or private. Plus: hide your @username on cards, control who can DM you.
/verifychannelLink your call channel to your profile (add the bot as its admin β€” that IS the verification). 𝕏 connect lives in Settings.

πŸ†The weekly pot

Every season, the best clans get paid.

How it fills

A slice of every trade executed on a group floor feeds one global pot, all season long. DM trades don't feed it β€” the pot belongs to the floors.

How it pays

Seasons run Monday→Monday. The top 3 clans by realized PnL split the pot 50 / 30 / 20. Inside a winning clan: the owner takes 20%, the rest splits evenly among active members.

Who counts

Public profiles, opted in, not excluded, with at least one scored sell that season β€” the activity floor keeps lurkers and shell groups from farming it.

Where to watch

Live pot total, countdown and podium split on /leaderboard, the Ranks tab, and your Clan tab's pot-race rank.

πŸ’ΈRewards

Referrals for traders, economics for group owners.

/reflinkYour personal referral link β€” lifetime fee share on everyone you bring, from their very first trade.
/earningsWhat you've earned, escrowed in real time.
πŸ’Έ referrals panelIn the app: link, referred count, accrued fees, and claim-to-wallet.
πŸ‘‘ group economicsGroups earn from trades on their floor and from every trader they first brought in β€” plus the owner's cut of pot wins.

πŸ“±The Mini App

Seven tabs, the whole network β€” inside Telegram or in any browser.

🏠 Home

Paper balance & realized PnL, watchlist with live prices, and your following feed β€” big BOUGHT/SOLD verbs, mcap at fill, theses inline.

πŸ”Ž Search

Tokens by name or CA across every chain, and traders with rank, followers and PnL. Recents remembered.

πŸ“Š Positions

Positions value + cash, PnL-tinted cards with entry vs current mcap, full sell flow with presets and custom amounts.

πŸ† Ranks

Solo and clan leaderboards over 24H/7D/30D/ALL with real profiles β€” plus the live pot.

πŸ“¨ Inbox

Your DM threads with unread badges, mute and delete.

πŸ›‘ Clan

Your clan's private board, member count, your rank, pot-race position β€” or how to join one.

πŸ‘€ Profile

Equity chart with hover tooltips, open/closed/feed tabs, wallets, referrals, settings β€” privacy, DM policy, clan, 𝕏 connect.

πŸ“ˆ Token pages

Candles with scrub tooltips, stats, watchers, holder list with theses, live feed β€” and the full buy/sell tradebar.

Also everywhere: real chain logos as native custom emoji Β· profile-picture emojis on holder lines Β· Name ($TICKER) formatting Β· confirm β†’ executing β†’ receipt on every trade Β· /help for this list inside Telegram.