Token buys and whale banners
Scaled emoji volume bars, buyer wallet link, value and 24h flow, with a separate banner once a buy clears the whale threshold. Buttons on the card: Buy, First Ledger, Chart and Website.
The multi-tenant bot behind token communities across the XRP Ledger. Buy and whale banners, sell and burn tracking, AMM flow, RLUSD cross-currency detection, XLS-20 NFT trade surveillance, cryptographic holder verification and raid coordination, all from one daemon watching the ledger live.
Section 01 .. what it posts
One daemon resolves every chat to its own tenant, so each community sees only its own project. These are the event types shipped and running on mainnet today.
Scaled emoji volume bars, buyer wallet link, value and 24h flow, with a separate banner once a buy clears the whale threshold. Buttons on the card: Buy, First Ledger, Chart and Website.
Sells are tracked on the same stream, so the 24h figure is real net flow rather than buy volume on its own.
Burns are read straight from ledger metadata, so a deflationary event posts as itself and is never inferred from a balance change.
Deposits and withdrawals on XRPL Automated Market Makers, with pool TVL and fee available on demand through /pool.
Native cross-currency path payments are detected as buys and are not double counted against the direct payment path.
Verified against 173 real mainnet sales. A brokered sale resolves to the true buyer and seller with the marketplace named separately: xrp.cafe, XRP Deals, DeepTide and OpulX.
During a green candle the buys batch per project and per token instead of flooding the chat with one card per transaction.
/leaderboard standings for a running buy contest, and X post raids that fan out to Telegram and Discord with one-tap Like, Repost and Comment buttons.
A join challenge greets new members through /welcome, which is free. The word filter and scam-address guard behind /spam are part of the Pro alert-tuning package.
Where traits come from, and why onboarding is a config block. Trait data is read from the ledger itself: account_nfts returns each NFT URI from a plain rippled node and the IPFS JSON gives the traits. That works for any XRPL collection with no database, no per-client setup and no Clio.
Section 02 .. holder gating
Other gates ask for a private key, or ask a member to connect a wallet to an unaudited dApp, or keep a plaintext map of who holds what. This one asks a member to sign a challenge, then verifies that signature itself.
The bot builds a native SignIn payload inside the Telegram conversation. The member signs on their own device and the bot checks the signature. Nothing leaves Telegram.
The member opens the verify page and signs a self-to-self payment carrying the session nonce in the memo, with LastLedgerSequence: 1 so it can never reach the ledger. No transaction cost, and no way to move funds.
A multi-sig vault signs an on-chain VAULT_AUTH proof bound to the verification nonce the server issued, so a proof scraped off the ledger cannot be replayed against a different member.
The security invariant. The web page is a courier and nothing else. It never learns which Telegram account is verifying, it decides nothing, and it drops the raw proof into a mailbox. The bot then checks that proof against the ledger with its own verifier, and fails closed, before it issues a single-use invite.
Section 03 .. tiers
Free stays genuinely useful on purpose: alerts, contests, raids, custom media and wallet verification all work without paying, because every card carries the Ice Cave Labs footer. The subscription buys the analytical tooling and the fan-out. Billing is settled in RLUSD inside Telegram. There is no web checkout. For the current monthly price and your payment details, run /subscribe pro or /subscribe elite in your project chat: that is where the price actually lives, and it issues the payment tag that routes the money to your group.
| Capability | Free0 RLUSD | ProSee /subscribe pro | EliteSee /subscribe elite |
|---|---|---|---|
| Monthly cost | Free forever | See /subscribe pro | See /subscribe elite |
| Monitored tokens | 1 | 2 | 10 |
| Monitored NFT collections | 2 | 5 | 20 |
| Linked Telegram chats | 2 | 10 | 50 |
| Watched wallets named in alerts 1 | No | 10 | 50 |
| Core alerts: buys, sells, burns, AMM, RLUSD, NFT trades | Yes | Yes | Yes |
Buy contests and /leaderboard | Yes | Yes | Yes |
Social raids, /raid and /raiders | Yes | Yes | Yes |
Custom image or GIF on every alert slot, /setmedia | Yes | Yes | Yes |
| Empty slot fallback | Ice Cave stock loops | Ice Cave stock loops | Ice Cave stock loops |
Wallet verification for members, /verify and /mybag 3 | Yes | Yes | Yes |
Welcome greeting and join challenge, /welcome | Yes | Yes, plus banner | Yes, plus banner |
24h recap posted on demand, /digest | Yes | Yes | Yes |
| Daily recap on a schedule | No | Yes | Yes |
Holder gating rules, /gate 2 | No | Yes | Yes |
Alert tuning, toggles and thresholds, /settings | No | Yes | Yes |
Word filter and scam-address guard, /spam | No | Yes | Yes |
Market stats: /stats /floor /chart /holders /pool | No | Yes | Yes |
Trait floors and deals: /traits /deals /rarity | No | Yes | Yes |
| Automatic deal alerts when a listing drops under its trait floor | No | Yes | Yes |
Holder list as CSV, /snapshot | No | Yes | Yes |
Discord relay, /discord | No | Yes | Yes |
Announce a Space by hand, /spaces | Yes | Yes | Yes |
Auto-watch an X account for Spaces, /spaces watch | No | Yes | Yes |
Stickers /setsticker and the forge /makesticker | No | Yes | Yes |
Emoji packs and project symbol, /emoji | Classic pack | Packs and symbol | Plus per-slot overrides |
AI community assistant, /assistant and /summary | No | No | Yes |
Community art polls, /communitypost | No | No | Yes |
| White label, attribution footer removed | No | No | Yes |
1 Watched wallets are part of the paid plan. The list is readable by anyone in the chat and removing an entry is free, but adding one needs Pro. If a subscription lapses you keep the wallets you already have, and the list simply cannot grow until it is back under the limit. A wallet cannot be renamed in place: remove it and add it again.
2 Holder gating is Pro. The wizard opens its first screen on any tier so you can see what it does, but it cannot write a rule, a target group or an enabled state without the subscription.
3 Members can prove a wallet on any tier, but only once the project has a gate configured, and configuring one is Pro.
Section 04 .. media layer
/setmedia puts your own image or GIF on any alert slot: buy, whale, sell, burn, NFT sale and the welcome. Every buy bot lets a project brand its own buys, so this is not something to charge for. Use the command rather than the hub button.
Any slot you have not set renders one of nine procedurally built dark ice animations. Set a slot to none for text only, or stock to put the loop back.
/makesticker turns an uploaded image, or an NFT artwork named by its NFTokenID, into a Telegram video sticker. Effects: bounce, pulse, spin, shake, float and glow, rendered server-side as WebM VP9, 512 px, three second loop.
Emoji packs are a single table. Every emoji on every card and digest comes from one file, so a restyle is a one-file edit. Packs (classic, ocean, neon, royal, degen, minimal) and a project symbol are Pro, per-slot overrides are Elite, and a lapsed subscription drops back to classic on its own rather than breaking a card.
Section 05 .. community
Paste an X post link in the group. The bot picks it up and asks for a private confirm, then fans the raid card out to Telegram and Discord together.
The card carries one-tap Like, Repost and Comment buttons that open the post directly, plus an I raided button.
/raiders ranks the month from those taps. It is an honour system by design and it is labelled as one, rather than pretending to scrape social proof it cannot verify.
Buy contests run the same way: /leaderboard shows live standings, and no contest exists until an admin starts one, so the command answers honestly on a quiet day.
Section 06 .. setup
Add @IceCaveLabsBot to your Telegram group or announcement channel.
Make it an administrator so it can post, then in @BotFather turn Group Privacy off (/mybots, your bot, Bot Settings, Group Privacy) so it can read commands.
Send /start or /menu in the chat to open the control hub, then set your token issuer and NFT taxons. For your own alert art use the /setmedia command. /testalert proves it end to end.
Section 07 .. reference
Every command below is registered in the running bot. Aliases and closely related commands are shown beneath each one, and the description says where they differ. Admin commands need group admin. The tier badge is the minimum tier for the operation described, and a locked command offers the upgrade instead of failing silently.
Members
| Command | Does | Tier |
|---|---|---|
| /price /p, /mcap | Price, market cap and 24h flow | Free |
| /chart /c | Price chart and 24h move | Pro |
| /stats /floor | Observed floor, volume and listings | Pro |
| /deals /snipe | Listings below a real trait floor | Pro |
| /traits | Trait floor directory | Pro |
| /rarity NFTokenID | Rarity rank and traits for one NFT | Pro |
| /holders /holder, /rich | Holder count, trend and top wallets | Pro |
| /pool /amm, /lp | AMM liquidity, TVL and fee | Pro |
| /ca /contract, /address | Issuer and currency code | Free |
| /trustline /trust, /tl | How to hold the token before you can buy | Free |
| /verify | Prove your wallet for holder access, once the project has a gate | Free |
| /mybag /bag, /my | What your verified wallet holds, answered privately | Free |
| /watchnft | Watch one NFT, DM on listing, offer or sale | Free |
| /alert | DM you when the price hits a level | Free |
| /alerts /myalerts | List the price alerts you have set | Free |
| /leaderboard /contest | Buy contest standings | Free |
| /raid | Current community raid target | Free |
| /raiders /topraiders | Top raiders this month, honour system | Free |
| /help /start | The member command list | Free |
Admins
| Command | Does | Tier |
|---|---|---|
| /menu /config, /setup2 | Every setting in one place | Free |
| /setup | Set up this chat | Free |
| /link /linkcode, /unlink | Link another chat to this project, or detach one | Free |
| /token /collection | Tokens and NFT collections this bot watches | Free |
| /setlink | Website and marketplace links on every alert | Free |
| /topic /topics | Which forum topic alerts post in | Free |
| /setmedia /media | Image or GIF on each alert type, welcome included. Use the command, not the hub button | Free |
| /welcome | Greeting and join challenge, banner image is Pro | Free |
| /cmd /commands | Custom replies for your community | Free |
| /digest | Post the 24h recap now | Free |
| /testalert | Send a sample alert to this chat | Free |
| /chatid /id | This chat ID, for setup. Any member can run it | Free |
| /raidconfig /configbot | Raid settings | Free |
| /raidstop /stopraid | Stop a running raid | Free |
| /subscribe /upgrade | Subscription and payment details, settled in RLUSD | Free |
| /settings | Opens on any tier. Changing toggles, minimums and delivery is Pro | Pro |
| /gatesetup /gatewizard | Holder-gating setup wizard. Free opens the first screen but cannot proceed | Pro |
| /gate /gateset, /gaterule | Holder-only access rules and gate settings | Pro |
| /spam /antispam | Word filter and scam-address guard | Pro |
| /watch | Add a watched wallet, named in alerts. Listing it is free for any member | Pro |
| /unwatch | Remove a watched wallet | Free |
| /floorpost | Post the cheapest listings now | Pro |
| /snapshot /airdrop | Holder list as CSV, for airdrops | Pro |
| /discord /setdiscord, /set_discord | Relay alerts to a Discord webhook | Pro |
| /spaces | Space overview, announce a Space by hand, and unwatch | Free |
| /spaces watch | Auto-watch an X account for new Spaces | Pro |
| /setsticker /stickers | Sticker after whale, buy or sale alerts | Pro |
| /makesticker /forge | Animated sticker from an image or an NFT artwork | Pro |
| /emoji /emojis | Overview and reset are free. Choosing a pack or a project symbol is Pro, per-slot overrides are Elite | Pro |
| /assistant /ai | The AI community assistant | Elite |
| /summary /recap | What you missed today | Elite |
| /summaryset /dailysummary | Schedule that recap daily | Elite |
| /communitypost | Community art polls. Creating and running one is Elite; viewing and turning it off are free | Elite |
Free to add, free to keep, and useful before you pay anything. Bring your token issuer and your NFT taxons and the first alert lands in minutes.