📖 Documentation

polyko is an AI-powered prediction market built on Solana. Unlike traditional prediction markets where events are curated by humans, polyko's AI agent autonomously creates, manages, and resolves prediction events — from serious crypto forecasts to hilariously absurd scenarios.

The platform combines the thrill of prediction markets with the humor and unpredictability of AI-generated content. Every event is crafted to be entertaining, thought-provoking, and most importantly — fun to bet on.

1. AI Creates Events — The polyko agent scans crypto twitter, on-chain data, and cultural trends to generate prediction events with multiple outcomes.
2. Users Browse & Bet — Connect your Solana wallet, browse active events, pick your side, and place a bet in SOL.
3. Odds Shift — As more people bet, odds dynamically adjust based on the distribution of bets across outcomes.
4. Event Resolves — When the event's timeframe ends, the AI agent determines the outcome based on verifiable data.
5. Winners Get Paid — Winning bettors receive their proportional share of the losing pool, minus a small platform fee.

Placing a bet on polyko is straightforward:

1. Connect Wallet — Support for Phantom, Solflare, and other Solana wallets.
2. Select Event — Browse by category, sort by pool size, popularity, or end date.
3. Choose Outcome — Click on the outcome you believe in. A bet modal appears.
4. Set Amount — Pick from preset amounts (0.1, 0.25, 0.5, 1, 2, 5 SOL) or enter custom.
5. Confirm Transaction — Your wallet prompts you to approve a SOL transfer.
6. Done — Your bet is recorded. Watch the odds shift in real-time.

polyko uses a parimutuel betting model. This means odds are determined by the total amount bet on each outcome, not by a bookmaker.

The polyko AI agent is the brain behind all events. It operates autonomously with the following capabilities:

• 📡
  Signal Processing — Monitors crypto twitter, on-chain metrics, market data, and cultural trends 24/7 to identify prediction-worthy scenarios.
• ✍️
  Event Generation — Crafts engaging, funny, and sometimes absurd prediction events with carefully balanced outcome options and initial odds.
• ⚖️
  Resolution — When events expire, the agent verifies outcomes using on-chain data, APIs, and social media signals to determine results.
• 🧬
  Self-Improvement — Learns which event types generate the most engagement and adjusts its generation strategy accordingly.

polyko operates entirely on Solana mainnet. All transactions are standard SOL transfers.

Event resolution follows a strict protocol:

1. Deadline Reached — Each event has a clear end time. No bets are accepted after this point.
2. AI Evaluation — The agent gathers data from multiple sources (on-chain data, APIs, social media) to determine the outcome.
3. Verification Period — A brief window where the community can flag potential disputes.
4. Resolution Published — The winning outcome is marked, and payouts are calculated.
5. Automatic Payout — Winners can claim their rewards directly to their connected wallet.

Treasury funds are used for: platform development, AI infrastructure costs, community rewards, and event pool seeding for new categories.

• ✅
  Non-custodial — polyko never holds your private keys. All interactions happen through your connected wallet.
• ✅
  On-chain Transparency — Every bet is a standard SOL transfer verifiable on Solscan.
• ✅
  Balance Verification — Pre-transaction balance checks prevent failed or unexpected transactions.
• ✅
  Open Resolution — Event resolution data sources are documented. Disputes can be raised publicly.
• ✅
  Rate Limiting — API and transaction rate limits prevent spam and manipulation.