BlueBox Logo
BlueBox

Loading...

© 2026 BlueBoxGG Co., Ltd.
NamesFor projectsDocsAboutContactSecurityTermsPrivacyDiscordX (Twitter)

Docs

BlueBox guide

Everything you need to sign in, complete quests and claim rewards, run a campaign for your project, and build on our API.

Docs

  • Guide
  • Public API
  • Blue Pass for developers

Contents

  1. 1. Getting started
  2. 2. Doing quests
  3. 3. Winners and rewards
  4. 4. Blue Pass and levels
  5. 5. Running a campaign
  6. 6. Spaces, seasons and payouts
  7. 7. For developers
  8. 8. Common questions

1. Getting started

You sign in to BlueBox with a crypto wallet. Press Connect wallet at the top of any page and choose your wallet; KUB Wallet and most popular wallets work. Signing in asks you to sign a message. It never moves funds and never costs gas.

The first time you sign in, a short setup window asks for:

  • Your BlueBox ID, the handle other people see. It also becomes your profile address.
  • Your email, confirmed with a one-time code. We use it for reward receipts and account notices, never for spam.
  • Agreement to our Terms of Service and Privacy Policy.

Some quests ask you to link Discord, Telegram or X. You can link them from your profile settings, or when a task needs them.

2. Doing quests

Each quest lists its tasks, its reward, how winners are picked and when it ends. Open a task, do what it asks, then press Verify. Our servers check it there and then. Common tasks:

  • Join a Discord server, hold a Discord role, or join a Telegram group.
  • Post on X with the code the task gives you.
  • Visit a page, answer a quiz or type an answer.
  • Hold a token or NFT, or make a transaction with a contract, on Bitkub Chain and other supported chains.
  • Take part in a BlueBox tournament, or be on a project's allowlist.

A task that cannot be checked does not count, and finishing every task does not always mean you win: read how the quest picks its winners.

3. Winners and rewards

A quest uses one of these ways to pick who gets the reward:

  • Everyone: every wallet that finishes the tasks can claim.
  • First come, first served: the first finishers, up to the number of rewards.
  • Random draw: winners are drawn from all finishers after the quest ends.
  • Chosen by the project: the project picks winners and announces them on the quest page.

Token rewards are claimed from the quest page to your wallet. The claim is a blockchain transaction, so you pay a small network fee. Rewards can also be BlueBox points, XP, Blue Pass progress or a game item code, which you redeem in the game. Claim before the quest's claim period ends, or the reward may be lost.

4. Blue Pass and levels

Everything you do builds your Blue Pass: a soulbound pass with stamps for quests, tournaments and other activity, plus a trust level from our anti-bot checks. Some quests are open only to higher levels, and other projects can read your pass to reward real players. Check your standing on the leaderboard.

5. Running a campaign

Projects can work with BlueBox in two ways:

  • Do it yourself. Open BlueQuest, press Create quest, add tasks and a reward, then publish. You can start from your existing campaign page link to fill in the title and cover. Any fee is shown before you publish. Token rewards are deposited into the quest's reward pool, so players know the reward is really there.
  • Let our team run it. Pick a package and send a request on the quest campaigns page. We plan the tasks, run the campaign and send you a report.

After it ends, you can download the participant list (wallet addresses, finish times, task results and a trust score) from My quests. Use it only for that campaign; see our Terms.

6. Spaces, seasons and payouts

Your first quest gives your project a Space: a page with all your quests, your followers and a points leaderboard. From the Space's Manage tab you can:

  • Open a season with a start and end date, so the leaderboard can reset for each campaign round.
  • Turn points into a payout list: enter a total and get each wallet's share as a table or CSV. You send the tokens yourself.
  • Copy an embed code that shows your open quests on your own website.

7. For developers

  • Public API: check whether a wallet finished a quest or how many points it has in a Space. No key needed.
  • Blue Pass for developers: read reputation on chain, over REST or as signed attestations.
  • BlueTools: create tokens, lock liquidity, set up vesting and multisend on Bitkub Chain.

8. Common questions

My task will not verify. Make sure you did it with the same account you linked (for example the same Discord account), wait a minute and try again. Some checks, like a new post on X, can take a moment to appear.

I finished the quest but cannot claim. Check how the quest picks winners. For a random draw, claiming opens after the draw. For first come, first served, the rewards may already be taken.

Do I need KUB for gas? Only to claim token rewards or use on-chain tools. Signing in and doing tasks are free.

Someone messaged me offering help. We never message first and never ask for your seed phrase. See our security page.

Still stuck?

Ask in our community or send us a message. You can also email contact@blueboxgg.com.