Tipping and giveaways
Tipping
For some fun, users can send and receive tips in Cosmobot's group chats! Each user gets their own on-chain addresses managed by Cosmobot. They can deposit the following coins to their respective addresses:
Coins supported: $AKT, $ATOM, $AXL, $BCNA, $CHEQ, $DEC, $DGN, $DVPN, $DYM, $EVMOS, $FET, $GRAV, $HUAHUA, $INJ, $JKL, $JUNO, $LUNA, $NTRN, $ORAI, $OSMO, $RUNE, $SAGA, $SCRT, $STARS, $STRD, $TIA, $TX, $WHALE, $XKI, $XPRT
Tokens supported: $ATOM1KLFG, $CAC, $LAB, $NEWT, $ROAR, $TAB
Personal deposit address and all the information on tipping can be seen if the following message is sent to @ibc_cosmobot in DM:
Usage
Once personal deposit address is funded, reply to someone's message in any group chat to tip them in the following format:
For instance,
in reply to User A message will send 1.5 ATOM to them.Similarly,
in reply to User B message will send 150 $SCRT to them.
For tokens, the chain’s native gas token is also required, e.g, $LUNA is required to tip $ROAR.
If sending a tip results in a failure - try again later or let us know at @cosmosrescue, it is likely to be an RPC issue that can be easily fixed.
Giveaways
You can create a giveaway in a public chat using your tip balance if you feel generous.
Other people in the chat can then claim it.
Balance should be enough to cover the giveaway amount and distribution transaction fees.
To create a giveaway - send the #giveaway command in a public chat in the following format:
For instance:
It will create a giveaway of 10 $ATOM for 5 unique telegram users, 2 $ATOM each.
Coins supported: $AKT, $ATOM, $ATOM1KLFG, $AXL, $BCNA, $CAC, $DEC, $DGN, $DVPN, $FET, $GRAV, $HUAHUA, $INJ, $JKL, $JUNO, $NEWT, $NTRN, $OSMO, $SAGA, $SCRT, $STARS, $STRD, $TAB, $TIA, $TX, $XKI, $XPRT
Elite giveaways
Elite giveaways allow you to create giveaways that require participants to have a minimum amount of staked $ATOM. This ensures that only genuine stakers can claim the giveaway, preventing farming by throwaway accounts.
Currently, elite giveaways support $ATOM only.
How it works
To participate in an elite giveaway, users must first link a Cosmos wallet to their Telegram account via the Cosmobot Elite mini app at t.me/ibc_cosmobot/elite, or via the dApp at elite.cosmosrescue.com.
Eligibility is based on the 7-day average staked $ATOM balance. Only staked (delegated) $ATOM counts - liquid balances are not considered. Days where no data is available count as 0 in the average. The 21-day unbonding period on Cosmos Hub acts as a natural anti-gaming measure. Staking data must also be fresh - the most recent balance snapshot must be within the last 24 hours.
If a user tries to claim an elite giveaway but is not eligible, the rejection is sent as a DM from Cosmobot rather than in the group chat. The DM includes a link back to the giveaway and explains the specific reason (no Cosmobot account, no linked wallet, stale data, or balance too low).
Multi-wallet linking
Each user can link up to 3 Cosmos wallets to a single Telegram account. Eligibility for elite giveaways is computed across all linked wallets: the sum of each eligible wallet's 7-day average staked $ATOM is used as the user's aggregate stake. Only wallets in the Eligible state contribute to the aggregate.
Each linked wallet has one of the following states:
- Eligible - at least 4 days of non-zero staking activity in the past 7 days, latest snapshot within the last 24 hours, and latest stake greater than 0. Counts toward the aggregate.
- Syncing - the bot is still backfilling 7 days of historical staking data for this wallet. Does not yet contribute to the aggregate.
- Stale - the latest snapshot is older than 24 hours. Excluded from the aggregate until refreshed.
- Inactive - the latest stake is 0. Excluded from the aggregate.
- Insufficient - fewer than 4 days of staking activity in the past 7 days. Excluded from the aggregate.
The daily snapshot job runs every 12 hours, so newly linked wallets typically reach the Eligible state within a few days once they accumulate enough staking history.
Usage
To create an elite giveaway, send the #elitegiveaway command in a public chat in the following format:
For instance:
It will create a giveaway of 50 $ATOM for 5 winners, where each participant must have at least 100 $ATOM staked (7-day average). Each winner receives 10 $ATOM.
The giveaway is distributed once all spots are claimed or after the expiration period, whichever comes first - same as regular giveaways.
Growth bonus
Elite giveaways support an optional growth bonus pool that rewards claimers whose staked balance has
grown over the past 7 days. To add a growth bonus, append bonus <amount> to the command:
This creates a giveaway of 30 $ATOM distributed evenly among up to 3 claimers, each requiring at least 500 $ATOM staked (7-day average), plus a 20 $ATOM bonus pool. The total cost to the sender is 50 $ATOM (30 base + 20 bonus).
The bonus pool is split among claimers proportionally to each claimer's 7-day stake growth, measured across
all of their linked wallets as growth = (current total stake) / (stake 7 days ago) - 1. Negative growth is
clamped to 0, so a claimer who reduced their stake receives no bonus but is not penalized. Any unawarded
bonus is refunded to the sender.
The bonus is resistant to link/unlink gaming: when a new wallet is linked, the bot backfills 7 days of historical stake data for that address, so a long-staked wallet linked today shows its true historical balance from 7 days ago rather than 0. There is no way to fake growth by linking a fresh wallet.
Omitting bonus N, or passing bonus 0, creates a giveaway with no growth bonus and behaves identically to
the original format. Bonus amounts below 0.01 $ATOM are rejected.
Validator giveaways
Validator giveaways are elite giveaways restricted to the delegators of one specific validator. Only the $ATOM staked with that validator counts toward the minimum, so a sponsor can reward exactly the community of a single validator.
Anyone with a funded Cosmobot account can create a validator giveaway for any validator - the announcement always shows who created it. Only validators in the active set (bonded, not jailed) are supported. The validator is shown by its moniker, linked to its Mintscan page.
How it works
Wallet linking and eligibility work exactly like elite giveaways, with one difference: the 7-day average is computed only over the stake delegated to the giveaway's validator. All the elite rules apply per validator:
- The claimer needs at least the minimum staked with that validator as a 7-day average, summed across eligible linked wallets.
- Staking with that validator on at least 4 of the last 7 days is required. Freshly redelegated stake therefore needs time before it counts - redelegating right before claiming does not work.
- Redelegating away from the validator is picked up by the next balance snapshot, after which the wallet no longer qualifies for that validator's giveaways.
Because the average uses a fixed 7-day window, a delegator who wants to qualify for a minimum of 100 $ATOM on day 4 needs roughly 175 $ATOM staked; staking exactly 100 $ATOM qualifies after the full 7 days.
Ineligible claim attempts do not consume a claim spot - the spot stays open for actual delegators, and the rejection DM explains whether the user has no stake with the validator or simply not enough yet.
Usage
To create a validator giveaway, send the #valgiveaway command (alias: #validatorgiveaway) in a public chat in the following format:
#valgiveaway <amount> <currency> <number of winners> <minimum staked> <validator address> [bonus <bonus amount>]
For instance:
It will create a giveaway of 50 $ATOM for 5 winners, where each participant must have at least 100 $ATOM staked with that validator (7-day average). Each winner receives 10 $ATOM.
The optional bonus N pool works like the elite growth bonus, but growth is measured on the stake with the
giveaway's validator only - it rewards claimers who increased their delegation to that validator over the
last 7 days. Distribution and expiration behave the same as elite giveaways.
The following scenarios use the giveaway #elitegiveaway 30 atom 3 500 bonus 20 (30 $ATOM split evenly among
3 claimers, plus a 20 $ATOM bonus pool). Each claimer always receives the 30 / 3 = 10 $ATOM even share
regardless of growth. Total cost to the creator if everyone qualifies: 50 $ATOM.
Example 1 - standard split. Three claimers with 7-day stake growth of +50%, +30%, and +20%. The total
growth across claimers is 100. Each claimer's bonus share is 20 * (their_growth / 100):
- @cosmonautA: +50% growth, 10 $ATOM bonus, plus 10 $ATOM even share (20 $ATOM total)
- @cosmonautB: +30% growth, 6 $ATOM bonus, plus 10 $ATOM even share (16 $ATOM total)
- @cosmonautC: +20% growth, 4 $ATOM bonus, plus 10 $ATOM even share (14 $ATOM total)
Example 2 - single grower takes the whole pool. Same 30 / 20 setup, but only one claimer had positive growth (+10%); the other two were flat at 0%. The one grower receives the entire 20 $ATOM bonus pool on top of their 10 $ATOM even share. The two flat claimers receive only their 10 $ATOM even share.
Example 3 - nobody grew, bonus refunded. Same 30 / 20 setup, all three claimers at 0% growth (or negative, which is clamped to 0). Each claimer receives the 10 $ATOM even share. The full 20 $ATOM bonus pool is refunded to the giveaway creator. Total spent by the creator: 30 $ATOM.
When the giveaway is distributed, a "Growth bonus" section is appended below the "Claimed:" list in the chat message. Example 1 produces the following announcement:
Claimed: @cosmonautA, @cosmonautB, @cosmonautC
Growth bonus (20 $ATOM pool):
@cosmonautA +50% growth, 10 $ATOM bonus
@cosmonautB +30% growth, 6 $ATOM bonus
@cosmonautC +20% growth, 4 $ATOM bonus
DM #tipmenu to @ibc_cosmobot to view your balance.
The all-refunded variant from Example 3 looks like this:
Claimed: @cosmonautA, @cosmonautB, @cosmonautC
Growth bonus refunded: No claimer grew their stake in the past 7 days. Full 20 $ATOM bonus refunded.
DM #tipmenu to @ibc_cosmobot to view your balance.
The how-to menu in Cosmobot has a "Create elite giveaways" button with additional guidance.
Giveaway and tipping stats
Cosmobot keeps running totals of what has been tipped and given away and exposes a few read-only leaderboard commands. Each one is per coin and takes an optional number to control how many entries are shown, from 1 to 25, defaulting to 5. As elsewhere in Cosmobot, the number is appended to the command (for instance #atomts10 for the top 10).
Top tippers
Shows the biggest tippers of a coin. The short form is #
For instance:
atomts lists the top 5 $ATOM tippers, #atomts10 the top 10.
Top giveaway senders
Shows who has given away the most of a coin, along with the total given away. The short
form is #
For instance:
atomgs lists the top 5 $ATOM giveaway senders, #atomgs10 the top 10.
Top chats
Ranks chats by how much of a coin was given away in them, along with the total. Each chat is shown as a link to its public group where one exists.
For instance:
topchatsatom lists the top 5 chats by $ATOM given away, #topchatsatom10 the top 10.
Giveaways in this chat
Run inside a chat to see how much has been given away there, broken down by coin. It takes no arguments.
This lists every coin given away in the current chat with its total and giveaway count.