Skip to content

Tipping and giveaways

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:

#tipmenu

Usage

Once personal deposit address is funded, reply to someone's message in any group chat to tip them in the following format:

#tip <amount> <currency>

For instance,

#tip 1.5 atom
in reply to User A message will send 1.5 ATOM to them.

Similarly,

#tip 150 scrt

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:

#giveaway <amount> <currency> <number of winners>

For instance:

#giveaway 10 atom 5

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:

#elitegiveaway <amount> <currency> <number of winners> <minimum staked> [bonus <bonus amount>]

For instance:

#elitegiveaway 50 atom 5 100

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:

#elitegiveaway 30 atom 3 500 bonus 20

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.

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.