An open API service indexing awesome lists of open source software.

https://github.com/kuestcom/prediction-market

Launch Your Own Decentralized Prediction Market in Minutes.
https://github.com/kuestcom/prediction-market

arbitrage cryptodev defi ethereum kalshi kalshi-clone liquidity opensource polygon polymarket polymarket-clone prediction-markets smartcontracts trade trade-bot web3

Last synced: 5 months ago
JSON representation

Launch Your Own Decentralized Prediction Market in Minutes.

Awesome Lists containing this project

README

          

# πŸš€ Launch Your Decentralized Prediction Market in Minutes

> **🚨 Big Announcement (05 Jan 2026): Forkast is now Kuest.** This repo has been reset for clean redeploys β€” expect to redeploy from scratch, reset the DB, and update your env vars, URLs, and docs.

[![License: Kuest MIT+Commons](https://img.shields.io/badge/License-Kuest--MIT--Commons-blue.svg)](./LICENSE) [![CI](https://github.com/kuestcom/prediction-market/actions/workflows/ci.yml/badge.svg)](https://github.com/kuestcom/prediction-market/actions/workflows/ci.yml)

[![Kuest Banner](https://i.imgur.com/q1edYP5.png)](https://kuest.com)

Open-source project to launch and monetize Web3 prediction markets, inspired by Polymarket, but with full transparency and control.

## ✨ Core Benefits

Tired of centralized platforms? Want to build your own business in the DeFi space? This project offers you:

- **⚑ Rapid Launch:** Get your prediction market website running in **minutes**, not months.
- **πŸ“ˆ Ready Events & Liquidity:** We sync popular events from platforms like Polymarket, ensuring you have active markets with initial liquidity for your users.
- **πŸ’° Earn Fees Automatically:** Earn **1% of traded volume** on your fork, directly via smart contracts. Another 1% goes to maintain backend infrastructure, blockchain operations, and continuous development of the base protocol.
- **πŸ› οΈ Hassle-Free & Transparent:** Infrastructure is managed for you, while you keep full control over the code and operations. Focus on growing your community and contributing to a decentralized ecosystem.
- **πŸ’Έ Arbitrage Opportunities:** Your users can profit from price differences between your platform and other prediction markets like Polymarket, creating natural trading volume and liquidity.
- **⚑ Built on Polygon:** Fast transactions with minimal fees, ideal for traders and scaling your market.
- **πŸ—³οΈ Fair Event Resolution (via UMA/Oracles):** A global voting area ensures fairness and security of results.

## πŸ› οΈ Get Started Now!

Follow these simple steps to launch your own prediction market:

### 1. Fork the Repository

Click the **Fork** button in the top right corner (and feel free to leave a **⭐ star**!)

### 2. Create a New Project on Vercel

1. Go to [Vercel](https://vercel.com) dashboard
2. Select **Add New** β†’ **Project**
3. Connect your **GitHub account**
4. Import and Deploy your **forked repository**

*Note: The initial deployment may fail due to missing environment variables. This is expected.
Complete Step 3 (Supabase) and Step 4 (environment) first, then redeploy from your project dashboard.*

### 3. Create Database (Supabase)

1. Go to your project dashboard
2. Navigate to the **Storage** tab
3. Find **Supabase** in the database list and click **Create**
4. Keep all default settings and click **Create** in the final step
5. Once ready, click the **Connect Project** button to link to your project

### 4. Configure Your Environment

1. **Download** the `.env.example` file from this repository
2. **Edit** it with your configuration:
- **Kuest CLOB Ordersbook**: Connect your wallet at [auth.kuest.com](https://auth.kuest.com), sign to verify ownership, and copy the API key, secret, and passphrase
- **Reown AppKit**: Get Project ID at [dashboard.reown.com](https://dashboard.reown.com)
- **Better Auth**: Generate secret at [better-auth.com](https://www.better-auth.com/docs/installation#set-environment-variables)
- **CRON_SECRET**: Create a random secret of at least 16 characters
3. Go to your Vercel project dashboard
4. Navigate to **Settings** β†’ **Environment Variables**
5. Click **"Import .env"** button
6. Select your edited `.env.example` file

### 5. Redeploy your project

*Optionally, add your custom domain in **Settings** β†’ **Domains** on your project dashboard.*

### 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** - This enables automatic sync with the main repository

**Ready! πŸŽ‰** Your prediction market will be online with automatic database setup in a few minutes.

## 🎯 Features

- πŸ“± Mobile Ready
- 🎨 Modern UI/UX (Polymarket-style)
- πŸ“š Docs
- πŸ‘¨β€πŸ’» API
- ⚑ Live Price Updates
- πŸ’³ Web3 Wallets (MetaMask, Reown AppKit)
- πŸ“Š Advanced Charts & Analytics
- πŸ”’ Secure Smart Contracts

## πŸ”§ Tech Stack

- **Frontend:** Next.js 16 (React 19, TS, Tailwind, Zustand, @visx)
- **Backend/DB:** Supabase (Postgres, Drizzle)
- **Auth:** Better Auth + SIWE
- **Blockchain:** Polygon (viem, wagmi)

## ⚠️ Disclaimer

Kuest is provided "as is" and should be used at your own risk. Review the [Modified MIT License with Commons Clause](./LICENSE) before deploying production forks: running derivatives that alter the core on-chain contracts or orderbook modules may fall outside the permitted use. Always verify smart contracts and comply with relevant regulations in your jurisdiction.

## πŸ”— Links

**πŸ“š [Documentation](https://kuest.com/docs/users)** β€’
**πŸš€ [Live Demo](https://kuest.com)** β€’
**πŸ—ΊοΈ [Roadmap](https://github.com/orgs/kuestcom/discussions/51)** β€’
**πŸ’¬ [Discussions](https://github.com/orgs/kuestcom/discussions)**

**πŸ“± [Discord](https://discord.gg/kuest)** β€’
**🐦 [X (Follow us)](https://x.com/kuest)** β€’
**πŸ› [Issues](https://github.com/kuestcom/prediction-market/issues)** β€’
**⭐ [Contribute](https://github.com/kuestcom/prediction-market/blob/main/CONTRIBUTING.md)**

---
*🚧 This project is under active development.
Developers and contributors are welcome to join and help build Kuest into a fully decentralized ecosystem.*