Documentation

Everything you need to run your staking operation with StakerHQ.

Overview

StakerHQ gives your staking syndicate a complete back-office. You get a private Telegram bot that your stakers interact with, and a web dashboard where you track every bet, balance, and game outcome in real time.

🤖
Telegram Bot
Your stakers receive game tips, subscribe, and log bets — all inside Telegram. No app download needed.
📊
Web Dashboard
Real-time P&L, staker balances, full bet ledger, game analytics, and transaction history.
🖼️
Auto OCR & Watermark
Game photos are read by AI (league, teams, odds extracted automatically) and watermarked with your brand.

Getting Set Up

  1. 1
    Create a Telegram bot — Open Telegram, message @BotFather, send /newbot, follow the prompts. Copy the bot token it gives you.
  2. 2
    Find your Telegram User ID — Message @userinfobot and it will reply with your numeric ID (e.g. 123456789).
  3. 3
    Sign up & complete the wizard — Create your account at /signup then paste your bot token, one primary Telegram user ID (no commas), and optional brand name in the Setup Wizard. Add other admins later in the bot via Manage additional admins. Your bot starts automatically.
  4. 4
    Open your bot in Telegram — Search for your bot's username and send /start. You'll see the admin panel with buttons to send games, manage users, check balances, and more.
  5. 5
    Recommended: add /dashboard to Telegram’s menu — Message @BotFather with /setcommands, choose your bot, then paste this single line (no leading slash): dashboard - Open your dashboard That exposes /dashboard in the / command picker next to the input for both admins and stakers. See Slash menu for details.

Sending Games

As an admin you send games directly from your Telegram chat with the bot. Every approved staker who is online receives the game card instantly with Subscribe and Enter Bet buttons.

📸 Photo game
Send any bet slip or odds screenshot as an image. The bot reads it with AI OCR — extracting sport, league, teams, and odds — then watermarks it with your brand name. Stakers receive the photo with Subscribe and Enter Bet buttons.
✏️ Text game
Send a text message describing the game. Stakers receive it as a formatted card. Useful when you have a tip but no screenshot.
📢 Admin replies / broadcasts
After sending a game, open Game Analytics and tap Manage → Manage Replies to broadcast an update to all subscribers (e.g. "game starts in 10 min").
⏹ Stopping / cancelling a game
Stop hides the game from new online stakers but keeps it for existing subscribers. Cancel marks the game as cancelled and notifies all subscribers.
🔄 Reactivating a game
Use Ready to re-send a stopped game to all online stakers. Even stakers who previously deleted the game card receive a fresh copy instantly.

Managing Stakers

➕ Adding a staker

In the bot, open the admin panel (/dashboard), tap Manage Users → Manage all users → Add. The bot will ask for their Telegram ID. You can:

  • Type their numeric Telegram ID (they get it from @userinfobot)
  • Forward any message from them — the bot reads the sender's ID automatically
⚠️ If the staker has Telegram's Forward Privacy enabled, forwarding won't reveal their ID. Ask them to message @userinfobot and share the number with you.

Once added the staker receives a welcome message. Their Telegram username is set as their default nickname — you can change it at any time.

➖ Removing a staker

Tap Remove in the users panel. All their game messages are deleted from Telegram automatically.

✏️ Nicknames

Inside Manage all users, tap a staker's name to edit their display nickname. Nicknames appear in analytics messages, balance reports, and the web dashboard.

⭐ Superusers

Superusers receive all game cards automatically without needing to Subscribe first. Use this for trusted VIP stakers. Manage via Manage Superusers in the bot.

👑 Additional admins

The setup wizard only saves one primary admin ID. To add teammates, use Manage additional admins here. Extra admins receive game analytics messages and can use admin commands in the bot. They do not have platform dashboard access (only the account owner can log into the web dashboard).

Bets & Balances

📝 Entering a bet (staker side)

After subscribing to a game, the staker taps Enter Bet. The bot prompts for one line:

amount odds match market

Example: 250 1.90 Away over 1.5 HT

The bot saves stake, odds, potential winnings, match name, and market. A confirmation message with Win ✅ / Lose ❌ buttons is sent to the staker so they can settle individually, or you settle for all at once from analytics.

💰 Balance

The staker's balance represents the running total they owe to you (the admin). It increases when bets win and decreases when they lose — based on the stake formula assigned to that staker.

You can manually deposit (add) or withdraw (subtract) from a staker's balance at any time from the web dashboard. All changes are logged with full history.

📋 Reports

Stakers: /reports — shows all their bets and outcomes.
Admins: visit the Bets tab in the web dashboard for a complete filterable ledger.
On the staker's detail page you can also edit individual bet fields and see the full edit audit trail.

Marking Results

Open Game Analytics for the game (via /dashboard or the analytics message pinned in your admin chat). Tap 🏁 Finish Game and then select Win or Lose.

  • ✓ All unsettled staker bets are updated to the result in one click.
  • ✓ Balances adjust automatically based on each staker's stake formula.
  • ✓ A settlement notification is sent to every subscriber.
  • ✓ Stakers can also settle their own individual bets with the Win/Lose buttons on their bet card.
  • ✓ The game result (Won / Lost) is shown on the web dashboard games table.

Stake Formulas

Each staker can have a different formula that determines how winnings and losses are shared between you (the admin) and the staker.

% Profit Share

Admin fronts 100% of the stake. Staker keeps a fixed % of the profit when the bet wins. On a loss, admin bears the full stake.

Example — 20% profit share, stake 100, odds 3.0:
Win: total return 300, profit 200
Staker keeps: 200 × 20% = 40
Admin receives: 300 − 40 = 260
Balance change: +260
Loss: balance change: −100
⚖ Split Stake

Admin and staker each contribute a fixed % of every bet. Winnings and losses split by the same ratio.

Example — 50/50 split, stake 100, odds 3.0:
Win: total return 300, profit 200
Staker keeps: 200 × 50% = 100
Admin profit: 200 × 50% = 100
Balance change: +100
Loss: admin loses admin's 50 of stake, balance: −50

Set or change a staker's formula via Manage Users → Stake Config in the bot admin panel. The current formula is always visible on the staker's detail page in the dashboard.

Web Dashboard

Log in at /login to access your dashboard. The dashboard is accessible from any device.

🏠 Overview
Key stats: total stakers, total staked, win/loss counts, win rate, unsettled bets, and bot status.
👥 Stakers
Full table — balance, total staked, bets placed, W/L record, win rate, online status. Click any staker for their full profile.
👤 Staker Detail
Per-staker profile: stake config, balance with deposit/withdraw controls, full transaction ledger, and editable bet history with audit trail.
📋 Bets
Complete bet ledger — filter by staker, result, date range. Export to CSV. Click staker names to jump to their profile.
🎮 Games
All games sent — OCR-extracted match event, league, country, sport; status; staked/winnings/profit; result. Date range filter and CSV export.
🎮 Game Detail
Full game view: image, subscribers, bets, replies, result, financials. Editable match metadata. Mark Won/Lost inline.
📜 Bot Logs
Live output from your bot process — useful for debugging. Sensitive server paths are automatically hidden.
⚙️ Bot Controls
Restart or stop your bot directly from the dashboard without needing SSH access.

Slash menu: expose /dashboard

We recommend registering at least /dashboard with BotFather so admins and stakers get a persistent entry in Telegram’s built-in command list (tap / next to the message field). It’s optional but we find it much more convenient than typing the command from scratch.

Steps
  1. Open @BotFather in Telegram.
  2. Send /setcommands as a message to BotFather (that is normal — you are not “running” the command in your own bot).
  3. Pick your bot from the list BotFather shows.
  4. Paste your command list as plain text. Use the pattern commandname - Short description. Do not put a / in front of the command name when talking to BotFather.
Minimal example (only dashboard)
dashboard - Open your dashboard

After saving, open a chat with your bot — the menu will show /dashboard. Admins get the admin dashboard; stakers get their status, balance, and stake info. You can add more commands to the same list later if you want.

Bot Commands

👤 Staker commands
/startGo online — receive active games and pending notifications
/dashboardYour personal dashboard — online status, balance, stake setup; we recommend adding this via BotFather (see above)
/stopGo offline — pause incoming game cards
/statusCheck your current online/offline status
/balanceView your current balance
/reportsView all your bets and outcomes
/helpShow the full command list
🔑 Admin commands
/dashboardAdmin panel; same as /start for admins — register it in BotFather’s menu (instructions)
/usersShortcut to manage stakers
/set_balance <id> <n>Set a staker's balance
/set_nickname <id> <name>Set display name for a staker
/reports <user_id>View a staker's full bet history
/infoBot info and runtime stats
/help_adminFull admin command reference
/cancelCancel any pending input action

FAQ

I forwarded a message from a staker but the bot didn't recognise them. ▾
This happens when the staker has Telegram's Forward Privacy enabled — their identity is hidden on forwarded messages. Ask them to message @userinfobot and share their numeric ID with you directly.
Stakers aren't receiving game cards even though they're online. ▾
Make sure they have sent /start to the bot to go online. Also verify they're registered: check Manage all users in the admin panel. Superusers receive all games automatically; regular stakers must Subscribe per game.
A staker's balance looks wrong. ▾
Visit the staker's detail page in the dashboard. You can see the full transaction history (showing exactly when and how the balance changed) and use Deposit / Withdraw to manually adjust. All adjustments are logged with timestamp and note.
Can I have multiple admins? ▾
Yes. The website setup asks for one primary admin Telegram ID only. After that, go to Manage Users → Manage additional admins in the bot and add their Telegram ID. Extra admins receive all game analytics messages and can use admin commands, but they cannot log into the web dashboard (that's reserved for the account owner).
How do I change the watermark on game photos? ▾
Set it during the Setup Wizard (Brand watermark text field). You can update it later directly from the dashboard settings or by contacting support.
Where does the OCR data (match event, league, sport) come from? ▾
When you send a photo game, the platform reads the image with OpenAI's vision model and extracts sport, country, league, team names, odds, and bet type. This data populates the Games table automatically. You can always edit it manually on the game detail page.
What happens when I reactivate a game? ▾
The game is instantly re-sent to all online stakers — including those who previously deleted the game card. Offline stakers will receive it the next time they send /start.

Contact & Support

Have a question, found a bug, or want something set up? Reach out directly — fastest response via Telegram.

✈️
@NikasNikas
Telegram — usually responds same day