# KNEEL Prediction Market

> Decentralized Prediction Markets

KNEEL Prediction Market is a prediction market for trading on real-world events. It supports market discovery, event pages, sports and esports views, public trader profiles, portfolio management, wallet funding, CLOB trading, SDK downloads, and developer documentation.

## LLM Usage Notes
- Prefer documentation links ending in `.md` when loading reference material into an LLM.
- Public app pages may be localized with `/de`, `/es`, `/pt`, `/fr`, `/zh`, `/ja`, `/ar`, `/ru`, `/it`, `/pl`, `/ko` prefixes; docs content is canonical in English.
- Authenticated routes such as `/portfolio`, `/settings`, and SDK downloads require a signed-in user.
- Do not treat public API examples as financial, legal, or trading advice.

## Primary App Routes
- [Home](/): Explore active prediction markets and featured categories.
- [New markets](/new): Recently added prediction markets.
- [Activity](/activity): Live public activity across trades and market interactions.
- [Sports](/sports): Sports prediction markets, live games, futures, props, and league pages.
- [Esports](/esports): Esports markets, live events, upcoming matches, props, and game pages.
- [Leaderboard](/leaderboard): Trader rankings and public performance views.
- [Mentions](/mentions): Live events where you can predict the words and phrases that will be said.
- [Portfolio](/portfolio): Authenticated user positions, winnings, open orders, and wallet actions.
- [Settings](/settings): Authenticated profile, notification, trading, affiliate, 2FA, and SDK settings.
- [Terms of Service](/tos): Legal terms for using the market.

## Route Patterns
- `/event/{eventSlug}`: Event detail page with markets, probabilities, order book, chart, comments, rules, and resolution state.
- `/event/{eventSlug}/{marketSlug}`: Specific market view inside a multi-market event.
- `/predictions/{query}`: Search-result landing page for prediction topics.
- `/profile/{usernameOrWallet}`: Public trader profile, positions, and activity.
- `/series/{seriesSlug}`: Markets grouped by a recurring series.
- `/sports/{sportSlug}`: Sport-specific market landing page.
- `/sports/{sportSlug}/{eventSlug}`: Sports event page with game markets and related context.
- `/sports/{sportSlug}/{eventSlug}/{marketSlug}`: Specific market view inside a sports event.
- `/esports/{gameSlug}`: Esports game landing page.
- `/{categorySlug}`: Dynamic category landing page, such as crypto, finance, politics, sports, or culture.
- `/{categorySlug}/{subcategorySlug}`: Dynamic subcategory landing page.
- `/docs/{docPath}.md`: Machine-readable markdown version of a documentation page.

## Selected Frontend API Routes
- `/api/events`: Paginated event listing used by home, category, search, sports, and esports surfaces.
- `/api/event-activity?market={conditionId}`: Public activity feed for a market condition.
- `/api/holders?conditionId={conditionId}`: Top holder data for a market condition.
- `/api/embed/events/slug/{eventSlug}`: CORS-enabled event payload for external embeds.
- `/api/embed/markets/slug/{marketSlug}`: CORS-enabled market payload for external embeds.
- `/api/market-context`: POST endpoint that returns structured market context for event tooling.
- `/market.html?market={marketSlug}`: Embeddable market widget HTML endpoint.

## Developer Resources
- [Documentation](/docs): User and API documentation.
- [API Reference](/docs/api-reference): Overview of the public Gamma, CLOB, Data, and WebSocket APIs.
- [Authentication](/docs/api-reference/authentication): CLOB API authentication, credential flow, and SDK guidance.
- [Clients & SDKs](/docs/api-reference/clients-sdks): Python, Rust, and TypeScript SDK guidance.
- [Rate Limits](/docs/api-reference/rate-limits): API rate-limit behavior.

## Public Service Endpoints
- Gamma API: (https://gamma-api.kuest.com) - Market discovery, events, tags, series, and search metadata.
- CLOB API: (https://clob.kuest.com) - Orders, cancellations, trades, order books, pricing, and CLOB authentication.
- Data API: (https://data-api.kuest.com) - Positions, user activity, holders, leaderboards, and analytics.
- CLOB WebSocket: (wss://ws-subscriptions-clob.kuest.com) - Market and user real-time streams.
- Live Data WebSocket: (wss://ws-live-data.kuest.com) - Sports and live-data streams.

## Machine-Readable Indexes
- [llms.txt](/llms.txt): This project-level LLM index.
- [Sitemap](/sitemap.xml): XML sitemap index for public app, docs, category, prediction, and event URLs.
- [Docs sitemap](/sitemaps/docs.xml): XML sitemap for documentation pages.

## Documentation Pages
> User and API docs. Each link points to the machine-readable markdown view.

- [Introduction](/docs.md): Learn how the platform works and how to place your first trade
- [Introduction](/docs/api-reference.md): Overview of our APIs
- [Authentication](/docs/api-reference/authentication.md): How to authenticate requests to the CLOB API
- [Get Aggregated Builder Leaderboard](/docs/api-reference/builders/get-aggregated-builder-leaderboard.md): Placeholder route for the builder leaderboard
- [Get Daily Builder Volume Time Series](/docs/api-reference/builders/get-daily-builder-volume-time-series.md): Placeholder route for the builder time-series
- [Clients & SDKs](/docs/api-reference/clients-sdks.md): SDKs for CLOB trading, relayer wallet actions, market discovery, and market maker workflows
- [Get Comment Replies](/docs/api-reference/comments/get-comment-replies.md): Returns Gamma-compatible replies for a community comment id
- [Get Comments By User Address](/docs/api-reference/comments/get-comments-by-user-address.md): Returns Gamma-compatible comments filtered by user address
- [List Comments](/docs/api-reference/comments/list-comments.md): Returns Gamma-compatible comments for an event, market, or series scope
- [Get Closed Positions For A User](/docs/api-reference/core/get-closed-positions-for-a-user.md): Returns cached exits for a wallet with filtering, sorting, and pagination
- [Get Current Positions For A User](/docs/api-reference/core/get-current-positions-for-a-user.md): Returns cached positions for a wallet, enriched with metadata and lifecycle hints
- [Get Positions For A Market](/docs/api-reference/core/get-positions-for-a-market.md): Returns cached positions for a wallet, enriched with metadata and lifecycle hints
- [Get Top Holders For Markets](/docs/api-reference/core/get-top-holders-for-markets.md): Ranks wallets by outcome token balance for each requested market
- [Get Total Value Of A Users Positions](/docs/api-reference/core/get-total-value-of-a-users-positions.md): Returns the aggregated exposure for a wallet
- [Get Trader Leaderboard Rankings](/docs/api-reference/core/get-trader-leaderboard-rankings.md): Returns trader rankings by profit/loss or volume
- [Get Trades For A User Or Markets](/docs/api-reference/core/get-trades-for-a-user-or-markets.md): Returns cached trade fills with filters for user, market, pagination, side selection, taker flags, and notional thresholds
- [Get User Activity](/docs/api-reference/core/get-user-activity.md): Returns the cached user activity feed
- [Get Midpoint Price](/docs/api-reference/data/get-midpoint-price.md): Get the bid/ask midpoint
- [Get Server Time](/docs/api-reference/data/get-server-time.md): Get server time
- [Get Event By Id](/docs/api-reference/events/get-event-by-id.md): Returns a single Gamma-compatible event by numeric id
- [Get Event By Slug](/docs/api-reference/events/get-event-by-slug.md): Returns a single Gamma-compatible event by slug
- [Get Event Comment Count](/docs/api-reference/events/get-event-comment-count.md): Returns comment count for an event
- [Get Event Creator](/docs/api-reference/events/get-event-creator.md): Returns a creator wallet record by id
- [List Event Creators](/docs/api-reference/events/list-event-creators.md): Returns creator wallets that have created synced events
- [List Events](/docs/api-reference/events/list-events.md): Returns Gamma-compatible events from the synced catalog
- [Get Fee Rate](/docs/api-reference/market-data/get-fee-rate.md): Get CLOB base fee rate for a token
- [Get Fee Rate By Token](/docs/api-reference/market-data/get-fee-rate-by-path.md): Get CLOB base fee rate for a token path parameter
- [Get Last Trade Price](/docs/api-reference/market-data/get-last-trade-price.md): Get last trade price
- [Get Last Trade Prices Query Parameters](/docs/api-reference/market-data/get-last-trade-prices-query-parameters.md): Get last trade price
- [Get Last Trade Prices Request Body](/docs/api-reference/market-data/get-last-trade-prices-request-body.md): Get last trade prices
- [Get Market Price](/docs/api-reference/market-data/get-market-price.md): Get the best price for a side
- [Get Market Prices Query Parameters](/docs/api-reference/market-data/get-market-prices-query-parameters.md): Get the best price for a side
- [Get Market Prices Request Body](/docs/api-reference/market-data/get-market-prices-request-body.md): Get best prices for many tokens
- [Get Midpoint Prices Query Parameters](/docs/api-reference/market-data/get-midpoint-prices-query-parameters.md): Get the bid/ask midpoint
- [Get Midpoint Prices Request Body](/docs/api-reference/market-data/get-midpoint-prices-request-body.md): Get midpoints for many tokens
- [Get Neg Risk](/docs/api-reference/market-data/get-neg-risk.md): Get the negative-risk flag for a token
- [Get Neg Risk By Token](/docs/api-reference/market-data/get-neg-risk-by-path.md): Get the negative-risk flag for a token path parameter
- [Get Order Book](/docs/api-reference/market-data/get-order-book.md): Get a token order book snapshot
- [Get Order Books Request Body](/docs/api-reference/market-data/get-order-books-request-body.md): Fetch multiple order books
- [Get Spread](/docs/api-reference/market-data/get-spread.md): Get the bid/ask spread
- [Get Spreads](/docs/api-reference/market-data/get-spreads.md): Calculate bid/ask spreads
- [Get Tick Size](/docs/api-reference/market-data/get-tick-size.md): Get minimum tick size
- [Get Tick Size By Path Parameter](/docs/api-reference/market-data/get-tick-size-by-path-parameter.md): Get minimum tick size
- [Get Market By Id](/docs/api-reference/markets/gamma-get-market-by-id.md): Returns a single Gamma-compatible market by numeric id or condition id
- [Get Market By Slug](/docs/api-reference/markets/gamma-get-market-by-slug.md): Returns a single Gamma-compatible market by slug
- [Get Market Description](/docs/api-reference/markets/gamma-get-market-description.md): Returns the Gamma-compatible market description object
- [Get Market Tags](/docs/api-reference/markets/gamma-get-market-tags.md): Returns tags for a Gamma-compatible market
- [List Markets](/docs/api-reference/markets/gamma-list-markets.md): Returns Gamma-compatible markets from the synced catalog
- [Get Batch Prices History](/docs/api-reference/markets/get-batch-prices-history.md): Get historical midpoint prices for many markets
- [Get CLOB Market Info](/docs/api-reference/markets/get-clob-market-info.md): Get CLOB market settings
- [Get Market By Id](/docs/api-reference/markets/get-market-by-id.md): Get market details
- [List Markets](/docs/api-reference/markets/get-market-by-slug.md): Returns a list of markets
- [Get Market By Token Id](/docs/api-reference/markets/get-market-by-token-id.md): Get market identifiers for a token
- [Get Prices History](/docs/api-reference/markets/get-prices-history.md): Get historical midpoint prices
- [Get Sampling Markets](/docs/api-reference/markets/get-sampling-markets.md): List sampling markets
- [Get Sampling Simplified Markets](/docs/api-reference/markets/get-sampling-simplified-markets.md): List sampling simplified markets
- [Get Simplified Markets](/docs/api-reference/markets/get-simplified-markets.md): List simplified markets
- [List Markets](/docs/api-reference/markets/list-markets.md): List markets
- [Get Live Volume For An Event](/docs/api-reference/misc/get-live-volume-for-an-event.md): Returns the total matched volume snapshot for the requested event
- [Get Open Interest](/docs/api-reference/misc/get-open-interest.md): Returns open interest for each market
- [Get Total Markets A User Has Traded](/docs/api-reference/misc/get-total-markets-a-user-has-traded.md): Returns how many distinct markets a wallet has traded in
- [Get Public Profile](/docs/api-reference/profiles/get-public-profile.md): Returns a Gamma-compatible public profile by wallet address
- [Get Public Profile By User Address](/docs/api-reference/profiles/get-public-profile-by-user-address.md): Returns a Gamma-compatible public profile by path wallet address
- [API Rate Limits](/docs/api-reference/rate-limits.md): Request caps and throttling windows for CLOB endpoints
- [Search Markets and Events](/docs/api-reference/search/search-markets-events-and-profiles.md): Searches Gamma-compatible markets, events, and tags
- [Get Series Comment Count](/docs/api-reference/series/get-series-comment-count.md): Returns comment count for a series
- [List Series](/docs/api-reference/series/list-series.md): Returns event series generated from the synced Gamma catalog
- [List Tags](/docs/api-reference/tags/list-tags.md): Returns tag records available in the synced Gamma catalog
- [Cancel All Orders](/docs/api-reference/trade/cancel-all-orders.md): Cancel all open orders
- [Cancel Orders For A Market](/docs/api-reference/trade/cancel-orders-for-a-market.md): Cancel open orders for a market or asset
- [Cancel Single Order](/docs/api-reference/trade/cancel-single-order.md): Cancel an order
- [Get Builder Trades](/docs/api-reference/trade/get-builder-trades.md): List builder trades
- [Get Order Scoring Status](/docs/api-reference/trade/get-order-scoring-status.md): Check if an order is scoring (L2)
- [Get Single Order By Id](/docs/api-reference/trade/get-single-order-by-id.md): Fetch an order
- [Get Trades](/docs/api-reference/trade/get-trades.md): List trades for the authenticated account
- [Get User Orders](/docs/api-reference/trade/get-user-orders.md): List live orders for the authenticated account
- [Post A New Order](/docs/api-reference/trade/post-a-new-order.md): Create a new order
- [Post Multiple Orders](/docs/api-reference/trade/post-multiple-orders.md): Create multiple orders
- [Send Heartbeat](/docs/api-reference/trade/send-heartbeat.md): Keep your trading session alive
- [Market](/docs/api-reference/wss/market.md): Subscribe to market order book and trade updates over WebSocket
- [Sports](/docs/api-reference/wss/sports.md): Subscribe to live activity, comments, and price updates over WebSocket
- [User](/docs/api-reference/wss/user.md): Subscribe to authenticated user updates over WebSocket
- [Arbitrage](/docs/exploring-markets/arbitrage.md): Learn how Outcome and Polymarket arbitrage combine two opposite positions below their $1 resolution payout
- [Buy & Sell Shares](/docs/exploring-markets/buy-sell-shares.md): Step-by-step flow to open, close, and manage positions
- [Canceling Orders](/docs/exploring-markets/canceling-orders.md): Cancel open limit orders from your portfolio
- [Market Overview](/docs/exploring-markets/market-overview.md): Understand how events, markets, and outcomes are organized
- [Market Terms](/docs/exploring-markets/market-terms.md): Key terms you will see while trading
- [Order Types](/docs/exploring-markets/order-types.md): Choose market or limit execution based on speed vs price control
- [Understanding Prices](/docs/exploring-markets/understanding-prices.md): Learn how prices map to probabilities and move with order flow
- [Fee Examples](/docs/fees-limits/fee-examples.md): Practical examples using the live trading-fee configuration
- [Trading Fees](/docs/fees-limits/trading-fees.md): How fees are calculated and where to verify them in the UI
- [Limits](/docs/fees-limits/trading-limits.md): Operational thresholds for order entry and transfers
- [Claim](/docs/getting-started/how-to-claim.md): Claim payouts after a market resolves in your favor
- [How to Deposit](/docs/getting-started/how-to-deposit.md): Fund your account using wallet transfer, card on-ramp, or direct USDC transfer
- [How to Sign Up](/docs/getting-started/how-to-sign-up.md): Create your account and prepare your wallet for trading
- [Help & Support](/docs/help-support/contact-support.md): Where to get help and what details to include
- [FAQ](/docs/help-support/faq.md): Common user questions about trading, claims, and account settings
- [Platform Rules](/docs/help-support/platform-rules.md): Basic conduct and fair-use expectations
- [Account](/docs/my-account/account.md): Manage two-factor authentication and account deletion
- [Account Security](/docs/my-account/account-security.md): Practical steps to keep your account and wallet safe
- [Affiliate Program](/docs/my-account/affiliate-program.md): Share your referral link and earn commission from referred trading activity
- [Notifications](/docs/my-account/notifications.md): Configure in-app and email notification preferences
- [Portfolio & Open Positions](/docs/my-account/portfolio-open-positions.md): Track positions, open orders, history, and claimable winnings
- [Profile Settings](/docs/my-account/profile-settings.md): Update your avatar, username, and account profile details
- [Public Profile](/docs/my-account/public-profile.md): Understand what is visible on your public trader profile
- [Trading Preferences](/docs/my-account/trading-preferences.md): Choose how market orders execute
- [Transaction History](/docs/my-account/transaction-history.md): Review activity and export CSV for reporting
- [Claiming Winnings](/docs/resolution-settlement/claiming-winnings.md): Claim from portfolio or market panel after final resolution
- [Disputes & Edge Cases](/docs/resolution-settlement/disputes-edge-cases.md): What to do when a market enters dispute or review states
- [Market Resolution](/docs/resolution-settlement/market-resolution.md): Understand how markets finalize and when results become claimable