› Docs › Introduction

Ticker Tok

A decentralized BTC price prediction game on BNB Smart Chain. Predict whether Bitcoin goes TICK ↑ or TOK ↓ in 30-second rounds and win 1.9× your stake.

Round Duration
30s
Win Multiplier
1.9×
Network
BSC Mainnet
Min Bet
0.001 BNB
Max Bet
Depends on vault liquidity
Price Oracle
Pyth BTC/USD

What is Ticker Tok?

Ticker Tok is a fully on-chain prediction market built on BNB Smart Chain (BSC). Every 30 seconds, a new round opens and players submit predictions on whether the BTC/USD price will be higher or lower at the end of the round.

The game uses the Pyth Network BTC/USD price feed — a high-frequency, institutional-grade data feed providing BTC/USD prices at up to 20 Hz. When the round closes, the smart contract compares the lock price (snapshot at round start) to the close price (snapshot at round end) and pays out all winners at a fixed 1.9× multiplier.

No counterparty. No order book. No slippage. Just you vs. the price.

ℹ
Ticker Tok uses a fixed payout model — winners always receive 1.9× their stake regardless of total pool size. The house liquidity is held in the MoonDoomVault; it is provided by the team — players cannot stake in the house.

Components

Frontend

Vanilla JS SPA served on Vercel. Handles wallet connection (Reown AppKit), bet submission, live price chart, and claim flow. Also supports a no-wallet Sim Mode for testing.

Smart Contracts

Two contracts on BSC. MoonDoom.sol manages the game. MoonDoomVault.sol holds the house liquidity (provided by the team; players do not stake in the vault).

Keeper Bot

A Node.js process that acts as the on-chain operator. It fetches Pyth price attestations and calls executeRound() every 30 seconds to advance the game.

Supabase

PostgreSQL database (via Supabase) stores bet history, round outcomes, leaderboards, and claim records. The keeper bot writes; the frontend reads via a public anon key.