Enabling the /holders to track your project's holder count
`/holders` replies with the live holder count of one token, set per bot from the dashboard. It works in groups and in a DM with the bot.
/holders replies with the live holder count of one token, set per bot from the dashboard. It works in groups and in a DM with the bot.
Setup
Turn /holders on
- Open Settings → Features (the Bot Utilities page).
- Turn on the
/holderscard. With no contract address saved, the Configure Holders modal opens. - Pick the token's chain under Blockchain.
- Enter the Contract Address.
- Tap Enable /holders — it enables once the address matches the chain's format.
- Send
/holdersin the chat.
/holders appears in Telegram's command menu once it is enabled with a valid address.
A pencil button on the /holders card reopens the modal to change the chain or address.
Chains
/holders works on these chains:
- Ethereum
- BNB Chain
- Base
- PulseChain
- Robinhood Chain
- Solana
- TON
- Sui
The reply
Every outcome
| Case | Reply |
|---|---|
| Configured; a source answers | 📊 Holders: 12,483 |
| Live sources down, but a cached count exists | 📊 Holders: 12,483 (cached) |
| Enabled, no valid address saved | 📊 Holders not configured yet. |
| Every source fails and nothing is cached | 📊 Holder data temporarily unavailable. Try again later. |
| Feature off | No reply |
Groups and access
A group is authorized when it's on the bot's allowed list. Each feature decides for itself whether it checks that list.
Custom commands
Text commands and button commands are built from the same modal in the dashboard's **Commands** tab. A command saved with buttons attached is a button…