Docs Playing the Game

Playing the Game

Everything you need to go from zero to placing your first on-chain BTC prediction — wallet setup, making bets, reading the chart, and claiming your winnings.

Getting Started

Ticker Tok runs on BNB Smart Chain (BSC) Mainnet. You'll need a compatible wallet with some BNB to cover your bets and gas fees.

What you need

  • A Web3 wallet — MetaMask, Trust Wallet, or any WalletConnect-compatible wallet
  • BNB on BSC Mainnet (Chain ID: 56)
  • At least 0.001 BNB for betting + a small amount for gas (~$0.02)

Connecting your wallet

  1. Visit the Ticker Tok app and click Connect Wallet in the top right.
  2. Select your wallet from the modal (MetaMask, WalletConnect, Trust Wallet, and more are supported).
  3. Approve the connection in your wallet app.
  4. If prompted, switch to BNB Smart Chain (Chain ID 56). The app will request the network switch automatically.
  5. Your BNB balance will appear and the betting panel will unlock.
Make sure you're on BSC Mainnet (Chain ID 56), not BSC Testnet. Transactions on the wrong network will fail.

Placing a Bet

You can place a bet at any time. If a round is currently LIVE (open), your bet enters that round. If a round is already running or has closed, your bet applies to the next round — you're always betting on the next available round.

Step-by-step

  1. Watch the countdown. The timer shows when the next round opens or how long the current round is still open. Place your bet to enter the next round that will be settled.
  2. Enter your bet amount. Minimum is 0.001 BNB; the maximum depends on vault liquidity and is shown in the app. The equivalent USD value is shown below.
  3. Pick a direction. Press TICK ↑ if you think BTC will be higher at the end of the round, or TOK ↓ if you think it will be lower.
  4. Confirm the transaction. Your wallet will prompt you to sign the transaction.
  5. Wait for the round to end. The live chart shows the current BTC/USD price. When the round closes (~30 seconds after lock), the result is displayed.

During an active bet

Once your bet is confirmed on-chain, the betting panel switches to show your Active Bet status — your direction, amount, and the lock price. The chart highlights the lock price level so you can track your position visually.

Worked example

-- Round #4821 opens -- Lock Price : $67,422.50 Your bet : 0.02 BNB on TICK ↑ -- 30 seconds later -- Close Price : $67,498.10 (higher than lock) Result : TICK wins ✓ Payout : 0.02 × 1.9 = 0.038 BNB Net profit : +0.018 BNB

Claiming Rewards

Winnings are not automatically sent to your wallet. After a round ends in your favor, a Claim button will appear in the UI. You must submit a claim transaction to receive your payout.

  1. After the round ends, look for the Claim Reward panel on the right side of the app.
  2. The panel shows your pending payout amount (your stake × 1.9).
  3. Click Claim and confirm the transaction in your wallet.
  4. BNB is transferred from the vault to your wallet immediately on confirmation.
Unclaimed winnings stay in the contract indefinitely. There is no expiry — you can claim at any time. Multiple unclaimed rounds can be batched into a single claim transaction to save gas.

Refunds (Push rounds)

If the BTC price doesn't move between lock and close (extremely rare), the round is a push. All bets are refunded in full. No house profit, no player loss. The same claim flow applies.

Reading the Chart

The live chart shows real-time BTC/USD price data from the Pyth Network BTC/USD feed:

  • Green line / fill — price is above the round's lock price (TICK territory)
  • Red line / fill — price is below the lock price (TOK territory)
  • Lock price line — horizontal dashed line marking the round's starting price
  • Comet particle — a visual indicator showing the live price head
  • Scroll wheel — zoom the time axis to see more or less price history

The chart uses Catmull-Rom spline interpolation for smooth curves even at low update frequencies.

Sim Mode

Sim Mode lets you play Ticker Tok without connecting a wallet or spending real BNB. It's the best way to learn the game or test UI flows during development.

How Sim Mode works

  • You start with a simulated 0.1 BNB balance
  • Rounds run on a local timer (not on-chain)
  • Prices come from the Pyth WebSocket feed (real data) or fall back to a synthetic price walk
  • Bets are instant — no transaction confirmation required
  • Win/loss results are calculated locally using the same 1.9× multiplier
  • Your simulated balance updates in real time
Sim Mode results are not on-chain. Simulated winnings have no real value. Sim Mode is for learning and testing only.

Activating Sim Mode

Sim Mode activates automatically when you access the app without a connected wallet. The UI indicates Sim Mode is active with a SIM label next to your balance. Connect a wallet at any time to switch to real on-chain play.