Open-source Prediction Market

Have your own on-chain Web3 prediction market stack inspired by Polymarket. Transparent, open source, and early-stage.

[ Demo • About • Installation • Roadmap ]

Why Kuest

• Launch your own on-chain prediction market in minutes.
• Polygon-native for low fees and fast settlement.
• Same USDC on Polygon — plug-and-play for Polymarket users.
• Earn trading fees from your fork.
• Amplify volume via on-chain affiliate attribution.
• UMA-powered outcome resolution with public, verifiable oracles.
• Full web UI plus bot-ready APIs and SDKs (Python/Rust). No backend infrastructure to manage.

Tip

Want your own Polymarket-style prediction market?

Launch quickly with your own brand, rules, and fee configuration.

Automated test trading is already available on Polygon Amoy via our bot SDKs, and the Kalshi arbitrage connector is coming soon.

Core Stack

---

Quick Start (15 minutes)

Note

Get Started Now! Follow these simple steps to launch your own prediction market:

1. Fork the Repository

1. In the top right corner, click the [⭐ Star] button
2. Fork it here

2. Configure Environment Variables before Deploy

1. Download .env.example from this repository
2. Edit it with your configuration:

   ENV key	What it is
   KUEST_ADDRESS KUEST_API_KEY KUEST_API_SECRET KUEST_PASSPHRASE	Kuest CLOB Auth credentials (generate at auth.kuest.com by connecting your Polygon EVM 0x wallet)
   ADMIN_WALLETS	Wallets that should be admins (comma-separated 0x addresses)
   REOWN_APPKIT_PROJECT_ID	Reown AppKit Project ID (from dashboard.reown.com)
   BETTER_AUTH_SECRET	Better Auth secret (32 chars, generate at better-auth.com)
   CRON_SECRET	Create a random secret (16+ chars)

3. Create a New Project on Vercel

1. Go to Vercel dashboard
2. Select Add New → Project
3. Connect your GitHub account
4. Click Import on your forked repository
5. In the import modal, open Environment Variables
6. Click Import .env
7. Select your edited .env.example
8. Click Deploy
9. After deployment finishes, click Continue to Dashboard

4. Create Supabase Database on Vercel

1. Open your Vercel project
2. Go to Storage
3. Create Supabase with default settings (create Supabase account if prompted)
4. After clicking Done, click Connect Project on the next screen

5. Redeploy your project

1. Open Deployments
2. Click the three dots (...) and select Redeploy on the latest deployment
3. Optional: wait 15 minutes, then add your custom domain in Settings → Domains

6. Sync Your Fork (via GitHub Actions)

In your forked Kuest repository:

1. Go to Settings → Actions → General
2. Select "Allow all actions and reusable workflows"
3. Click Save

7. Finish Setup in Admin

1. Log in with a wallet listed in ADMIN_WALLETS
2. Open Admin → General to finish setup (Company name, branding, fees...).

Ready! 🎉 Your prediction market is live.

Tip

If you want to self-host outside Vercel, see here.

---

Roadmap

• Polymarket-inspired UI and market pages
• Polygon network support
• On-chain configurable fees per fork
• On-chain affiliate mode (trustless fee sharing)
• Shared liquidity across multiple forks
• Wallet onboarding via Reown AppKit
• Safe-compatible proxy wallet flows
• Relayer server
• Matching engine
• Split and merge functions
• PnL system
• Negative risk position conversion
• Public bot SDK (Python/Rust)
• Activity page
• Trader leaderboard
• Multi-language UI
• Theme customization
• Recurring Crypto and Nasdaq markets with live charts
• Recurring X counter markets
• Recurring temperature markets (soon)
• Sports markets
• Fork-created markets with opt-in cross-fork sharing
• UMA Oracle implementation
• 🏆 MVP Ready (stress tests, security, and financial consistency checks)
• Move matching engine to mainnet
• Kalshi arbitrage connector (soon)
• Layout redesign (soon)

---

Follow Us

---

License: Kuest MIT+Commons.

Important

Forks are welcome for branding, frontend changes, and custom UX. Production deployments must use Kuest infrastructure. Running an independent trading stack or hosted fork requires a separate commercial agreement.