Listing Discovery
How listings, categories, filters, and markets appear to players
Players discover listings first. A listing is the player-facing page or card; a market is the tradable question inside that listing.
Categories and filters are discovery labels configured for the operator environment. Operators do not need to design or maintain them day to day. They only need to understand what the labels mean so they can place listings where players expect to find them.
Operator takeaway
Treat categories and filters as placement choices for a listing, not as a configuration-management workflow.
Discovery Model
| Layer | What operators should know |
|---|---|
| Listing | The player-facing page or card. It has title, visibility, image, description, category placement, and one or more markets. |
| Category | The main browse area where a listing appears, such as Sports, Crypto, Politics, or Entertainment. |
| Filters | Labels inside a category, such as Asset, League, Region, or Event Type. |
| Market | The tradable binary question under a listing. It has claim sides, timing, limits, and a resolution rule. |
A player opens a listing, then trades one or more markets attached to it.
What Operators Check During Listing Creation
When creating or reviewing a listing, operators should check:
- The listing belongs in the category where players would naturally look first.
- Any selected filters help players narrow the listing, rather than creating confusion.
- The listing title, image, and description match the attached market questions.
- The listing visibility matches the launch plan: public, unlisted, or private.
- The listing appears correctly in the embed before promotion.
If a needed category or filter is missing, unclear, or wrong for the launch plan, escalate it as configuration work instead of inventing a workaround in the market wording.
Listing Types
Different listing kinds support different player-facing layouts:
| Listing kind | Operator use |
|---|---|
| Simple question | One primary prediction page. |
| Outright page | A page for an event with multiple possible market questions. |
| Fight page | Combat-sports style page with participants and fight-specific markets. |
| Sports match page | Team or player matchup page with match-related markets. |
| Price ladder | Price-level style listing, usually for financial or crypto predictions. |
| Collection | A grouped player-facing hub for related listings. |
Choose the listing kind that matches how players should understand the page. The goal is not to expose the data model to players; it is to make the iframe render the right browsing and trading surface.
Visibility
Listings can be:
| Visibility | Operator use |
|---|---|
public | Normal player-facing discovery. |
unlisted | Accessible in direct or configured flows, but not broadly promoted. |
private | Not for general player discovery. |
Do not use private or unlisted visibility as a substitute for compliance review. Visibility controls discovery, not whether a market is legally or operationally ready.
Review Checklist
- The listing appears in the expected player-facing area.
- Filters narrow the listing in a way players understand.
- Public listings are ready for player traffic and support questions.
- Unlisted or private listings are intentionally hidden from general discovery.
- Sandbox and production placement have both been checked before launch.