AVAX Bingo Docs
Everything you need to know about the on-chain prediction bingo game built on Avalanche
Game Overview
AVAX Bingo is a fully on-chain prediction game built on the Avalanche blockchain. Players build unique NFT bingo cards by choosing 25 predictions about the Avalanche ecosystem, then compete for a prize pool as real-world events unfold.
You pick your own predictions from a curated pool — each prediction has a difficulty rating and point value. Arrange them strategically on your 5x5 card to maximize your score and chase bingo line bonuses.
When events happen in the real world, game administrators resolve predictions with proof links. Your score grows as your predictions come true, and completing a full line of 5 triggers a bingo multiplier on that line's points. The highest-scoring cards win from the prize pool.
25
Predictions Per Card
You Choose
Your Predictions
2x+
Bingo Line Multiplier
How It Works
Connect Your Wallet
Use MetaMask, Core Wallet, or any Avalanche-compatible wallet. Make sure you're on the Avalanche C-Chain (Fuji testnet during beta).
Build Your Card
Browse the prediction pool and choose 25 predictions to fill your 5x5 bingo card. Each prediction has a category, difficulty, and point value. Drag and arrange them strategically — the layout determines which bingo lines are possible.
Mint Your Card
Once you've filled all 25 slots, mint your card as an on-chain NFT in a single transaction. Your chosen predictions and their arrangement are permanently stored in the smart contract.
Watch Events Unfold
As events happen in the real world, game administrators resolve predictions with proof links. Your score grows as your chosen predictions come true. Complete a full row, column, or diagonal for a bingo multiplier bonus.
Win Prizes
Cards are ranked by total score on the leaderboard. Prize pool payouts are distributed based on configurable rank tiers — top-scoring cards earn the biggest share.
Bingo Cards
Each bingo card is an ERC-721 NFT on Avalanche. You build your card by choosing 25 predictions and arranging them in a 5x5 grid. The predictions and their positions are stored on-chain, making them immutable and verifiable.
Card Properties
- 25 predictions — you choose which predictions to include from the available pool
- Strategic layout — you arrange predictions in the 5x5 grid, determining which bingo lines are possible
- Single-tx mint — one transaction to mint your card on-chain
- Transferable — standard ERC-721, can be traded or gifted
- Max per wallet — configurable limit to prevent monopolization
Important: Cards cannot be modified after minting. Choose your predictions and arrangement carefully! You can mint multiple cards with different strategies.
Predictions
Predictions represent forecasts about the Avalanche ecosystem. Each prediction has an ID, point value, difficulty, and category. They are created by game administrators and stored in the backend.
AVAX price targets and market movements
e.g. "AVAX hits $15"
Avalanche network events and milestones
e.g. "New L1 launches on Avalanche"
Twitter/X moments and community events
e.g. "Emin tweets a meme"
Meta events and milestones
e.g. "Meta integrates AVAX"
Ava Labs official team announcements
e.g. "Ava Labs announces new partnership"
Each prediction has a difficulty rating (Easy, Medium, Hard) and a point value (1–5 pts). Harder predictions are worth more points. Points from resolved predictions contribute to your card's total score.
Resolution Process
- A real-world event happens (e.g., AVAX price hits $15)
- Game administrator calls
resolveSquare()on the BingoGameV2 contract with a proof URI - The resolution is recorded on-chain and visible on the Prediction Tracker page
- All cards containing that prediction earn its point value
Scoring System
Your card's score is calculated from two components: base score and bingo bonus.
Base Score
The sum of point values for all resolved predictions on your card. Higher-difficulty predictions contribute more points.
1 pt
High probability events. Safe picks for steady progress.
2-3 pts
Uncertain outcomes. Balanced risk and reward.
4-5 pts
Unlikely but high-value. Moonshot predictions.
Bingo Bonus
When all 5 predictions in a line (row, column, or diagonal) are resolved, that line's points are multiplied by the bingo multiplier (set per game, e.g. 2x). This bonus is added on top of your base score.
Example (2x multiplier):
Card has 10 resolved predictions = 18 base pts
One complete row (5 resolved, 8 pts total in row)
Bonus = 8 x (2-1) = +8 pts
Total = 18 + 8 = 26 pts
Scoring determines:
- Leaderboard ranking
- Prize pool payout tier placement
- Balanced Bingo multiplier — squares in completed lines trigger the multiplier once, even if they overlap
Bingo & Multiplier
A bingo line is achieved when all 5 predictions in a row, column, or diagonal are resolved. Each bingo line multiplies that line's points.
Horizontal
5 in a row
Vertical
5 in a column
Diagonal
Corner to corner
There are 12 possible bingo lines on each card: 5 rows + 5 columns + 2 diagonals. Any square that is part of a complete line receives the multiplier bonus. Overlapping squares are only multiplied once to ensure fairness.
Strategic placement matters! Since you choose where each prediction goes on your card, try to align high-probability predictions in the same row, column, or diagonal to maximize your chance of triggering the bingo multiplier.
Prize Distribution
Prizes are distributed based on leaderboard ranking. The prize pool is funded by mint fees and can be topped up by the game administrator. Payout tiers determine what percentage of the pool each rank range receives.
Payout Tiers
Each game has configurable payout tiers defined by rank ranges and basis points (1 BPS = 0.01%). For example:
Rank 1: 40% of prize pool
Rank 2: 25% of prize pool
Rank 3: 15% of prize pool
Ranks 4-10: 20% split equally
Actual tiers vary per game and are set on-chain by the administrator.
How Prizes Work
- Prize pool is funded by mint fees and administrator contributions
- Rankings are determined by total score (base + bingo bonuses)
- Leaderboard results are committed on-chain by the administrator at game end
- If a game is cancelled, all funds are refunded
Example
50 cards minted x 0.02 AVAX = 1 AVAX mint fees
Admin funds additional 0.5 AVAX
Total prize pool: 1.5 AVAX
1st place (40%): 0.6 AVAX
2nd place (25%): 0.375 AVAX
Smart Contracts
AVAX Bingo runs on two smart contracts deployed on Avalanche C-Chain:
BingoCardV2.sol
ERC-721 NFT contract for player-built prediction cards.
- Player-chosen predictions — players select 25 predictions and their grid positions
- Single-tx mint — no commit-reveal needed, one transaction to mint
- On-chain storage — 25 prediction IDs stored as uint8[25]
- ERC721Enumerable — efficient per-owner token queries
- Game ID tracking — cards are associated with the active game at mint time
- Configurable — mint price, max per wallet, mint open/close
BingoGameV2.sol
Game lifecycle, prediction resolution, scoring, and prize distribution.
- Game lifecycle — PENDING → ACTIVE → COMPLETED / CANCELLED
- Prediction resolution — with proof URIs, tracked via getResolvedSquares()
- Points-based scoring — prediction points set on-chain per game via setPredictionPoints()
- Bingo multiplier — configurable per game, multiplies points on complete lines
- Payout tiers — configurable rank-based prize distribution via setPayoutTiers()
- Leaderboard commit — final rankings committed on-chain via setLeaderboardResult()
- Resolver roles — authorized addresses for prediction resolution
Security & Trust
On-Chain Storage
Card predictions stored on-chain — no one can alter your picks after minting.
Transparent Resolution
Every resolved prediction includes a proof URI. Anyone can verify the evidence.
On-Chain Scoring
Prediction points, bingo multiplier, and payout tiers are all set and verifiable on-chain.
Non-Custodial Prizes
Prize pool held in the smart contract. Winners claim directly — no middleman.
Game Timeline
Game Setup
Admin creates game on-chain with bingo multiplier. Prediction points and payout tiers are configured.
Status: PENDINGMinting Period
Admin starts the game and opens minting. Players build and mint their bingo cards. Mint fees fund the prize pool.
Status: ACTIVEActive Game
Events unfold in the real world. Admins resolve predictions with proof links. Players track their scores on the leaderboard.
Status: ACTIVEBingo Bonuses
As predictions resolve, cards with complete lines earn bingo multiplier bonuses. Leaderboard rankings shift.
Status: ACTIVEGame End
Admin ends the game. Final leaderboard is committed on-chain with token IDs and scores.
Status: COMPLETEDPrize Claims
Winners claim prizes based on their payout tier. AVAX goes directly to their wallet.
Status: COMPLETEDStrategy Guide
Building Your Card
Balance Risk and Reward
Easy predictions (1 pt) are likely to resolve but give fewer points. Hard predictions (5 pts) are less likely but worth much more. Mix both to ensure steady base points while chasing high scores.
Optimize for Bingo Lines
Place your most likely predictions together in the same row, column, or diagonal. A complete bingo line multiplies all its points. Five easy predictions in a row is worth more than five scattered hard ones.
Target High-Value Multipliers
Any unique square involved in a completed bingo line gets multiplied. Placing your highest value (Hard) predictions at intersection points (like the center) increases their odds of securing the multiplier, providing a massive bonus!
Tips
- Mint early — the prize pool grows with every card minted
- Put your highest-confidence predictions on the main diagonal and middle row/column — they overlap with the most bingo lines
- Mint multiple cards with different strategies — one conservative, one aggressive
- Cards are tradeable NFTs — you can sell cards with great layouts!
Frequently Asked Questions
What blockchain is this on?
Avalanche C-Chain. During beta, we use the Fuji testnet — no real money required.
How much does a card cost?
Mint price is set per game by the administrator. The fee contributes to the prize pool.
Do I choose my own predictions?
Yes! You browse the available predictions, pick 25, and arrange them on your 5x5 card however you like. Your arrangement determines which bingo lines are possible.
Can I change my card after minting?
No. Your 25 predictions and their arrangement are permanently stored on-chain. Mint additional cards with different strategies.
Who resolves the predictions?
Designated game administrators (resolvers). Every resolution includes a proof link so players can verify the evidence.
How are winners determined?
By total score on the leaderboard. Your score = base points (from resolved predictions) + bingo bonuses (from complete lines). Prizes are paid out based on configurable rank-based payout tiers.
What's the bingo multiplier?
When all 5 predictions in a row, column, or diagonal are resolved, their points are multiplied. Any square involved in at least one bingo line is multiplied once (no stacking bonuses for the same square).
Can I sell my bingo card?
Yes! Bingo cards are standard ERC-721 NFTs. You can transfer or sell them on any Avalanche NFT marketplace. The new owner inherits the card's predictions and game participation.
What if no one gets bingo?
Bingo lines earn bonus points but aren't required to win. The leaderboard ranks all cards by total score — even without a bingo line, you can win with enough resolved predictions.
What wallet do I need?
Any Avalanche-compatible wallet: MetaMask, Core Wallet, Rabby, WalletConnect-compatible wallets, etc.