Kuest Overview & Capabilities
Relevant source files
The following files were used as context for generating this wiki page:
- README.md
- src/app/[locale]/admin/integrations/_components/AdminIntegrationsForm.tsx
- src/app/llms.txt/route.ts
- src/app/[locale]/(platform)/settings/sdks/page.tsx/settings/sdks/page.tsx)
- src/lib/structured-data.ts
- src/lib/admin-support-settings.ts
- infra/terraform/modules/target-digital-ocean/variables.tf
Kuest is an open-source, white-label prediction market infrastructure built on the Polygon blockchain. It allows operators to deploy branded prediction markets with shared liquidity, custom fee structures, and integrated Web3 trading flows in a non-custodial manner. The platform leverages Polymarket-compatible architectures to support existing trading bots and market-making infrastructure.
The system is designed as a full-stack Web3 solution, handling market creation, order flow, and resolution via decentralized oracles while providing a customizable frontend for diverse operator types such as financial institutions, news groups, and crypto DAOs.
Sources: README.md:1-12, README.md:38-45
Core Platform Features
Kuest provides a comprehensive suite of tools for operators to manage their prediction market. Key capabilities include:
| Feature | Description |
|---|---|
| White-label Branding | Custom domains, logos, categories, and theme customization. |
| Shared Liquidity | Mirrored markets from Polymarket with live order flow synchronization. |
| On-chain Fees | Trustless fee distribution where trading fees go directly to the operator. |
| Multi-Language UI | Built-in internationalization (i18n) support for global audiences. |
| Arbitrage Trading | Native features for arbitrage between the operator's site and Polymarket. |
| Identity Verification | Integration with Sumsub for KYC/identity management. |
Sources: README.md:24-33, src/app/[locale]/admin/integrations/_components/AdminIntegrationsForm.tsx:294-325
Technical Architecture
Kuest utilizes a decentralized stack centered around the Polygon network and USDC as the primary trading currency.
System Components Flow
The following diagram illustrates the relationship between the user interface, the operator's infrastructure, and the underlying blockchain protocols.
The platform separates metadata management (Gamma) from order execution (CLOB) and historical analysis (Data API).
Sources: src/app/llms.txt/route.ts:133-157, README.md:47-58
Key API Endpoints
Kuest exposes several specialized service endpoints for frontend and bot interactions:
- Gamma API: Handles market discovery, events, tags, and series metadata.
- CLOB API: Manages the Central Limit Order Book, including orders, cancellations, and real-time pricing.
- Data API: Tracks user positions, leaderboards, and historical analytics.
- WebSocket Streams: Provides real-time updates for both CLOB data and live sports data.
Sources: src/app/llms.txt/route.ts:133-157
Operator Integrations
Operators can extend platform functionality through a centralized integrations interface. This allows for the configuration of third-party services and custom logic.
AI & Data Enrichment
Kuest integrates with OpenRouter to provide AI-driven market creation, translations, and featured market selection. Operators can specify preferred models or allow the system to select automatically.
Sources: src/app/[locale]/admin/integrations/_components/AdminIntegrationsForm.tsx:180-227
Identity and Compliance
The Sumsub integration provides identity verification workflows. Configuration includes:
- Enforcement Levels: "Disabled", "Observe only", or "Required".
- App Token/Secret Key: Credentials for secure communication with Sumsub's verification engine.
- Webhook Verification: Validates status updates via a Webhook Secret.
Sources: src/app/[locale]/admin/integrations/_components/AdminIntegrationsForm.tsx:238-292
Liquidity and Arbitrage
The platform supports deep integration with Polymarket for mirrored liquidity. It includes a specific "Separate Polymarket wallets" feature, requiring Reown Multi-Wallet support, which allows users to connect distinct wallets for the operator's site and Polymarket simultaneously to facilitate arbitrage.
Sources: src/app/[locale]/admin/integrations/_components/AdminIntegrationsForm.tsx:327-353
Developer SDKs & Automation
Kuest provides personalized SDK bundles in multiple languages to support automated trading and platform extension.
SDK Variants
- Python/Rust/TypeScript: Available for high-performance bot development and workflow automation.
- CLOB Client: Specifically designed for handling orderbook interactions.
- Relayer Client: Used for routing and executing signed on-chain actions.
Sources: src/app/[locale]/(platform)/settings/sdks/page.tsx:84-138
Bot Development Sequence
Infrastructure & Deployment
Deployment is supported through multiple paths, from managed no-code setups to manual enterprise installations using Terraform and Docker.
Environment Requirements
Deployments typically require a core set of environment variables for secure operation:
- Polygon Configuration:
CHAIN_ID,POLYGON_RPC_URL, andRELAYER_URL. - Authentication:
BETTER_AUTH_SECRETandREOWN_APPKIT_PROJECT_ID. - Storage: Support for either Supabase (
SUPABASE_URL) or S3-compatible storage (S3_BUCKET). - Admin Control:
ADMIN_WALLETSandKUEST_API_KEY.
Sources: infra/terraform/modules/target-digital-ocean/variables.tf:87-111, README.md:65-71
SEO and Metadata Management
The system automatically generates structured data to enhance search visibility. This includes:
- Organization Schema: Defines the operator's brand, logo, and social links.
- Event Schema: Provides search engines with market titles, resolution status (Scheduled, Completed, Cancelled), and availability.
- BreadcrumbList: Maps the hierarchy from the home page through categories and subcategories to specific events.
Sources: src/lib/structured-data.ts:117-210
Kuest represents a modular infrastructure for decentralized prediction markets, balancing white-label customization for operators with a robust, audited Web3 backend for secure, non-custodial trading.