IOS (eng)

General
Synchronization on Android (Health Connect)
Synchronization on Android (phone sensors)
Synchronization on Android with fitness watches
Synchronization on iOS
Shop
Leaderbords
Inviting Friends
Earning Coins
Series
Boost of the Day
Giveaway
Listing

FAQ STEPMANIA

General

StepMania is a mini-app within Telegram that monetizes your steps, allows you to compete with friends, set records, earn rewards, and participate in prize giveaways.

The StepMania mobile app is needed to collect data about your steps and distance traveled from your phone through Apple Health. This data is transmitted to the StepMania mini-app in Telegram, unlocking various features and opportunities.

Your steps are visible only to you. If you create or join a leaderboard, other participants will be able to see your step count in the StepMania mini-app and in the bot's daily reports in the chat. However, your steps remain hidden from other Telegram users, including your contacts.

The StepMania mini-app receives step data from your mobile app, which syncs with Apple Health, Health Connect, or phone sensors. We only use step and distance data. Other data, including geolocation, is not requested or used.

StepMania employs multiple protection levels to count only real steps. If the system detects step-inflating apps or manual step input, such steps will not be counted.
Therefore, data in StepMania may differ from your app.

What happens if you try to cheat the system?

First violation – Step synchronization is blocked for up to 2 days.
Repeated violations – Access is permanently blocked.

Fair play is the key to success! Don’t risk your steps and coins

Synchronization

Step 1: Download the StepMania app from the App Store

Step 2: Launch the app and provide access to Apple Health data (steps and distance).

Step 3: In the StepMania app, click the "Confirm in Telegram" button. A bot will open, confirming the connection of steps and offering to open the StepMania mini-app.

Step 4: Click the button and check if the steps appear in the StepMania mini-app.

If you didn't provide access to Health data during the first launch of the app, follow these steps:

Step 1: Open the Health app on your phone.

Step 2: Tap your profile picture in the top right corner.

Step 3: In the "Privacy" section, tap "Apps" and select StepMania. Tap "Enable All" — data synchronization will start.

Step 4: Go to the main screen of the StepMania mobile app and tap the "Back to Telegram" banner. The bot will confirm the successful connection of steps and provide a button to open the StepMania mini-app in Telegram.

Step 1. Set up data transfer in "Health" (Apple Health). Usually, the synchronization feature can be found in the profile settings of the fitness watch app and is named something like "Connect other services," "Apps and devices," "Manage connections," or "Add accounts."

Step 2. After synchronization, open Apple Health, tap "Browse" → "Activity" → "Steps."

Step 3. Scroll down to the bottom to the "Data Sources & Access" section → tap "Edit" in the top right → press and hold ☰ and move the watch or the watch app to the top.

Step 4. Now, Apple Health will send data from your watch to the StepMania service.

1. Check the step count for today in the Health (Apple Health) app on your phone.

2. If 0 steps are shown in the Health (Apple Health) app as well, check if fitness tracking is enabled: Go to Settings – Privacy – Motion & Fitness and make sure fitness tracking is enabled.

3. If the step count in the Health (Apple Health) app differs from the mobile StepMania app, check if StepMania has access to the Health (Apple Health) data. The permissions should be enabled. For instructions on how to set up synchronization, refer to the section "How to synchronize StepMania with your device".

If the problem persists, contact support.

1. Check synchronization settings: Make sure the synchronization is correctly set up according to the instructions for your platform in the "How to synchronize StepMania with your device" section.

2. Synchronization delay: If you are on a walk or run, the step count may differ due to synchronization delay. In this case, wait some time for the data to update.

1. Check the connection between the mobile app and the mini-app. Open the StepMania mobile app, go to the "Back to Telegram" banner, and if the StepMania bot sends a message confirming successful authorization with a button saying "Open mini-app," click the button. The steps should now be up to date.

2. If the system detects step inflation, including manual entry, those steps will not appear in the StepMania mini-app in Telegram. Be cautious: if step inflation is detected, synchronization may be blocked for up to 2 days. Repeated violations may lead to permanent access blockage. Please avoid using any cheating methods to prevent negative consequences

Open the Health app on your phone.
Find the list of apps requesting access to Health data.
Go to the StepMania app and revoke access to all requested data (steps and distance).

1. It is not possible to connect steps through the desktop version of Telegram.

2. To connect steps, open the StepMania mini-app in Telegram on your mobile device and follow the instructions in the "How to sync StepMania with your device" section.

Shop

The StepMania store offers several categories of items:

Auto-Boosters – Automatically collect speed boosts.
Coin Lotteries – Give you a chance to win valuable prizes by participating in special draws.
Telegram Gifts – Virtual postcards that can be purchased with in-game coins.
Main Screen Backgrounds – Splash screens for the app’s main screen.
Promo Codes for Discounts

Currently, the shop uses two types of currency:

In-game coins – earned through gameplay.
Telegram Stars – purchased via Telegram.

Telegram gifts are virtual postcards that can be purchased with in-game coins. After the purchase, the gift is sent within 24 hours by the @StepMania_support. You can find it in your profile under the “Gifts” tab.
Important: Each user can buy only one Telegram gift of each type. If a gift is out of stock, the purchase button will become inactive.

Telegram gifts are sent within 24 hours after purchase by the StepMania bot. If you haven’t received your gift within that time frame, please contact support.

This is a lottery that you enter by spending coins.

Participation rules:

Pay the entry fee as listed in the store.
You can increase your chances by contributing more coins.

Where to find the lotteries?

In the “Store” tab – under the special “Coin Lotteries” section, which leads to the lottery page.

Open the “Shop” tab.
Select the item you’re interested in and click on it — a window with detailed information will open.
In the opened window, click “Pay”.

If the purchase is made with in-game coins, the amount will be deducted from your balance immediately.
If the purchase is made with TG Stars, they will be deducted from your balance. If there are not enough Stars, a window will open allowing you to buy more.

4. After successful payment, the item will appear in the “My items” tab — except for the “Giveaway for coins” item.

No, returns are not possible.

Check your account balance and try again later.

People (Leaderbords)

A leaderboard is a step competition among members of a specific Telegram chat. It’s a great way to stay motivated and inspire others to be more active.

Within a leaderboard, you can:

Compete for top positions
Set team records
Receive daily motivational summaries from the bot

In the “People” section, there are two types:

Friends Leaderboard – created automatically from your friends in the app.
Custom Leaderboard – created manually by you.

People you invited via the “Friends” section
People you invited using the “Invite Friends” button inside a leaderboard
Your referrals (those who joined via your link and synced their steps)

If someone joins through your referral link, you both appear in each other's Friends Leaderboard.

Tap “+” or “Create New” at the top of the “Top” section
Enter a name and choose an emoji as the avatar
Invite friends using the “Invite” button or by sending them the invite link
Once they click the link, they’ll be added automatically

Get an invite link from a participant
Open the link — you’ll see the leaderboard name and who invited you
Tap “Join” to enter

Yes! You can join and participate in as many leaderboards as you like — no limits.

No. There are no restrictions on the number of leaderboards you can create or join. Compete across different groups freely!

No, there’s no limit on the number of participants in a leaderboard.

Open the leaderboard in the StepMania mini app
Tap the “Leave” icon in the top-right corner

You cannot leave the Friends Leaderboard.

Open your leaderboard in StepMania
Tap “Add to Chat”
Select a Telegram group chat
Telegram will prompt you to add @StepmaniaBot — confirm it
Done! The leaderboard is now linked to the chat

💡 Notes:
– The bot does not need admin rights
– You can link only one chat per leaderboard
– To unlink the chat, simply remove the bot from the group
The bot posts a daily update at 12:00 (local time), showing:

Who was in the lead
The team’s total step count
Any new records
With an image or GIF

When the bot is a regular participant in the chat, it does not have access to other chat messages. However, if the bot is assigned admin rights, it will have access to other chat messages (a technical feature of bots on the Telegram platform).

StepMania does not use or process chat messages received by the bot when it is an admin in the chat. StepMania is committed to maintaining user communication privacy and asks users not to grant admin rights to the bot.

Inviting Friends

Open the “People” section in the StepMania mini app on Telegram. You have two options:

1. Via the “Referrals” tab:

Tap the copy icon to copy your personal referral link.
Or tap “Invite a friend” — a list of chats will open where you can instantly send a pre-filled message with your link.

2. Via a leaderboard invite:

Open the desired leaderboard.
Tap “Invite”.
Choose friends from your Telegram contacts and send them the invitation — they’ll automatically join the leaderboard and be counted as your referrals.

Users who join the StepMania mini-app in Telegram through your referral link are recorded in the system as your referrals. You can view the list of your referrals and their activity status in the "Friends" section of the mini-app.

No bonuses are given until the referral syncs their steps. When the referral syncs their steps, two types of bonuses are activated:

One-time bonus: You receive 10,000 StepMania coins. This bonus is only granted when your referral first syncs their steps.
Daily bonus: You earn 0.1 StepMania coins for each step your referral takes. This bonus is credited for steps synced on the same day. Note that the daily bonus expires if not collected within the day.

Earning Coins

StepMania coins are the in-app currency within the StepMania mini-app in Telegram. They are not cryptocurrency.

There are several ways to earn coins in the StepMania mini-app:

1. Walk and earn coins for every step.
To earn coins, simply walk and regularly sync your steps from the StepMania mobile app to the StepMania mini app in Telegram (steps are converted into coins).
You need to collect your step coins by tapping the “Claim” button at the bottom of the main screen in the StepMania mini app on Telegram.
You can increase the number of coins you earn per step by being more active (see the “Streaks” and “Speed ups” sections for details).

Important: Only steps from the last 7 days are converted into coins.
If you haven’t opened the app or synced your steps for more than 7 days, coins for those steps won’t be credited. You will still see the data in the statistics, but coins will not be awarded.

2. Complete tasks. The list of all tasks, conditions, and rewards can be found in the relevant tab. Don't forget to collect your coins after completing a task!

3. Invite friends. You can earn additional coins by inviting friends to the StepMania mini-app in Telegram (see "What do I get for inviting a friend?").

The main way to earn coins in StepMania is by converting steps to coins. However, there are some limits:

A maximum of 20,000 steps can be converted to coins per calendar day.
Steps exceeding this number will be displayed in both the mobile StepMania app and the mini-app in Telegram, but will not be converted to coins.

No other limitations on earning coins exist.

StepMania coins can be used to:

Enter prize lotteries
Purchase various items in the in-app store

It’s a great way to earn valuable rewards for your activity!

No, StepMania coins cannot be transferred or gifted to other users.

No, StepMania coins can only be earned within the functionality of the StepMania mini-app in Telegram. See "How to earn coins?" for more details.

StepMania coins cannot be converted into national currencies.

Streak

A streak is the number of consecutive days in which you have walked 1000 or more steps. The longer your streak (the more consecutive days you complete), the greater your reward for the streak.

Having a streak increases the step-to-coin conversion rate.
The more consecutive days you meet the streak requirement (1,000 steps or more), the higher your conversion rate becomes. A streak is activated once per day.
For reaching certain streak milestones, you’ll also receive bonus rewards in the form of coins — in addition to the increased conversion rate.

Important:
A streak remains active from the moment it's activated until the end of the next calendar day, or until the next streak activation on the following day.
If the streak condition is not met on the next calendar day, the streak resets.

The streak grows when you walk 1000+ steps every day without breaks. If you reach this milestone in a day, upon entering the app, a screen will appear where you can claim the streak.
You can activate it once a day, so make sure to check in and not lose your progress!

Yes, the streak can be lost. It lasts until the end of the next calendar day or until the activation of the next streak. If the condition is not met on the next calendar day, the streak is reset, and the value becomes 1, with the conversion rate increase turned off.

Speed ups

This is a bonus that increases the step conversion rate. You can activate it every hour, and it will last until the end of the day. The more often you activate it, the more you get!

Speed up increases the conversion rate of steps to coins. The higher the boost value (the more frequently speed up is activated), the higher the conversion rate of steps to coins within the current calendar day.

Important: Speed up is active from the moment of activation until the end of the current calendar day or until the next speed up is activated within the same day. At the end of the calendar day, all speed ups are reset.

The first speed-up of the day becomes available when you first enter the app, and then it becomes available every hour.

On the main page, below the steps, a "Speed up" button will appear – click it, and the conversion rate of steps will increase. After activation, a timer will appear, showing when the next speed-up will be available.
Use the speed-up every hour to earn even more coins!

At the end of the calendar day, all speed-ups are reset.

Giveaway

A giveaway is an activity inside the StepMania mini app on Telegram where you can win real prizes.
Each giveaway has an end date, shown as either a specific date or a countdown timer on the giveaway page.
To participate, you need to buy an entry using coins.

1. Check the availability of the lottery.
Open the lottery page and make sure it hasn’t moved to the results or completed stage yet.

2. Review the rules.
Familiarize yourself with the lottery’s dates, rules, and the prizes being offered.

3. Activate the lottery.
Tap the “Participate” button and activate your entry with the required number of coins.
If your steps aren’t connected, you’ll need to connect them first.

4. Increase your chances.
As long as the lottery hasn’t entered the results stage, you can add more entries at any time.
The more entries you purchase with coins, the higher your chances of winning a prize!

On the date and time specified by the giveaway rules, it moves to the results stage. Winners are selected through a randomizer. The list of winners will be published through designated StepMania channels, and each participant will be able to see their result on the giveaway page inside the StepMania mini-app in Telegram.

1 .In-game rewards (coins):
If you win in-game rewards, simply click the “Claim” button next to the reward, and it will be activated, adding to your balance of coins.

2. Physical rewards or rewards from external platforms:
If you win physical rewards or prizes associated with external platforms (e.g., Telegram stars), clicking the “Claim” button will redirect you to the support chat. A support manager will confirm your details for prize delivery and explain the conditions for receiving your reward.

The winner has 30 days to confirm all necessary details for receiving the reward. If the winner does not confirm the details within this period, the giveaway organizer reserves the right to cancel the prize.

Ask your question