> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tradeonsight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Discovery

> Find prediction markets using search, filters, and categories

## Browsing Markets

Onsight offers multiple ways to discover prediction markets based on your interests and trading strategy.

<CardGroup cols="2">
  <Card title=" Trending" icon="fire">
    Markets with the highest 24-hour trading volume. These are the most active markets right now.
  </Card>

  <Card title=" Volume" icon="chart-column">
    Markets sorted by total historical volume. Find the most liquid markets with best price discovery.
  </Card>

  <Card title=" New" icon="sparkles">
    Recently created markets. Get in early before prices move too far from fundamentals.
  </Card>

  <Card title=" Category" icon="folder-open">
    Browse markets by topic: Politics, Sports, Crypto, Business, Science, Entertainment, and more.
  </Card>
</CardGroup>

## Market Filters

### Trending Markets

See what traders are focusing on right now, ranked by 24-hour volume:

<Steps>
  <Step title="Access Trending">
    From the home screen:

    1. Click **Markets**
    2. Select **Trending**
  </Step>

  <Step title="Browse Results">
    Markets display with:

    * Market question
    * Liquidity
    * Volume: 24h and total
    * Market end date
    * Available outcomes

    <Tip>
      High 24h volume indicates active trading and tight spreads. Great for market orders with minimal slippage.
    </Tip>
  </Step>

  <Step title="Navigate Pages">
    * **Next ▶️** - See more markets
    * **Previous ◀️** - Go back
    * Up to 5 markets per page
  </Step>
</Steps>

### Volume Leaders

Find the most liquid markets for the best trading experience:

<Info>
  Markets with higher total volume typically have:

  * Tighter bid-ask spreads
  * Better price discovery
  * More efficient markets
  * Lower slippage on trades
</Info>

**Why Trade High-Volume Markets:**

* Market orders execute closer to displayed prices
* Limit orders fill faster
* More participants = better pricing
* Less market manipulation risk

### New Markets

Get in early on newly created prediction markets:

<Warning>
  **Be Cautious:** New markets may have:

  * Lower liquidity (wider spreads)
  * Higher slippage on trades
  * Less price discovery
  * More volatility

  Do extra research before trading new markets.
</Warning>

**Benefits of New Markets:**

* Prices may not reflect true probability yet
* First-mover advantage on information
* Potential for larger profit margins
* Less competition from other traders

### Category Filtering

Browse markets by topic to find what interests you:

<Tabs>
  <Tab title="🏛️ Politics">
    **Elections, Legislation, World Events**

    * Presidential races
    * Congressional elections
    * International politics
    * Policy decisions
    * Geopolitical events

    Typically the highest volume category on Polymarket.
  </Tab>

  <Tab title="⚽ Sports">
    **Games, Championships, Player Stats**

    * NFL, NBA, MLB, NHL
    * Soccer (Premier League, Champions League)
    * UFC, Boxing
    * Esports
    * Player performance props
    * Season win totals

    Fast-moving markets with clear resolution dates.
  </Tab>

  <Tab title="💰 Finance">
    **Company Performance, Earnings, M\&A**

    * Tech company earnings
    * Stock price predictions
    * Product launches
    * Mergers and acquisitions
    * CEO decisions

    Research-heavy markets with fundamental analysis opportunities.
  </Tab>

  <Tab title="₿ Crypto">
    **Price Predictions, Protocol Events, Regulation**

    * Bitcoin/Ethereum price targets
    * Token launches
    * Network upgrades
    * Regulatory decisions
    * Exchange events

    <Tip>
      Crypto markets can move quickly with news. Use limit orders to avoid paying premium prices during volatility.
    </Tip>
  </Tab>

  <Tab title="🌍 Geopolitics">
    **World Events**

    * Geopolitical events
    * International politics
    * Foreign policy
  </Tab>

  <Tab title="🌐 World">
    **World Events, Elections**

    * International elections
    * International politics
    * Geopolitical events
  </Tab>

  <Tab title="💻 Tech">
    **Innovation, Research, Space, AI**

    * AI developments
    * Space missions
    * Scientific discoveries
    * Technology releases
    * Research breakthroughs

    Longer-term markets requiring deep technical knowledge.
  </Tab>

  <Tab title="🎭 Culture">
    **Movies, Music, Awards, Pop Culture**

    * Oscar predictions
    * Box office results
    * Music awards
    * Celebrity events
    * TV show outcomes

    Fun markets with social sentiment driving prices.
  </Tab>
</Tabs>

## Search Functionality

Find specific markets using keywords or phrases:

<Steps>
  <Step title="Start Search">
    1. Click **Markets** → **Search**
    2. You'll see a prompt to enter search terms
    3. Type your keywords in chat
  </Step>

  <Step title="Search Tips">
    **Effective Search Strategies:**

    <CodeGroup>
      ```txt Single Word theme={null}
      Search: "Trump"
      Finds: All markets mentioning Trump
      ```

      ```txt Multiple Words theme={null}
      Search: "Bitcoin 100k"
      Finds: Markets about Bitcoin price reaching $100k
      ```

      ```txt Phrase Search theme={null}
      Search: "Super Bowl winner"
      Finds: Markets about Super Bowl championship
      ```

      ```txt Event Date theme={null}
      Search: "2024 election"
      Finds: Markets about 2024 elections
      ```
    </CodeGroup>

    <Tip>
      Search is case-insensitive and finds matches in market titles and descriptions. Be specific for better results.
    </Tip>
  </Step>

  <Step title="Review Results">
    Search returns up to 20 matching markets, sorted by relevance:

    * Market question/title
    * Current YES price
    * Quick **Buy** button

    No results? Try:

    * Different keywords
    * Fewer words (be less specific)
    * Browse by category instead
  </Step>
</Steps>

### Search Examples

<AccordionGroup>
  <Accordion title="Political Events">
    **Good searches:**

    * "Biden approval" - Find approval rating markets
    * "Senate race" - Find Senate election markets
    * "Supreme Court" - Find SCOTUS-related markets
    * "Ukraine" - Find geopolitics markets

    **Tip:** Include year for specific election cycles (e.g., "2024 election")
  </Accordion>

  <Accordion title="Sports Outcomes">
    **Good searches:**

    * "Lakers" - Find Lakers game and season markets
    * "Super Bowl 59" - Find specific championship
    * "Mahomes MVP" - Find player award markets
    * "Premier League winner" - Find season outcome markets

    **Tip:** Use team names or player names for best results
  </Accordion>

  <Accordion title="Crypto Markets">
    **Good searches:**

    * "Bitcoin 100k" - Find BTC price prediction markets
    * "Ethereum ETF" - Find ETF approval markets
    * "Coinbase" - Find exchange-related markets
    * "DeFi" - Find decentralized finance markets

    **Tip:** Include price levels or specific events
  </Accordion>

  <Accordion title="Business & Tech">
    **Good searches:**

    * "Apple earnings" - Find AAPL financial markets
    * "Tesla" - Find Tesla-related markets
    * "AI" - Find artificial intelligence markets
    * "IPO" - Find initial public offering markets

    **Tip:** Company ticker symbols also work (AAPL, TSLA, etc.)
  </Accordion>
</AccordionGroup>

## Market Details

When you open a market, you'll see comprehensive information:

### Price Information

```txt Market Details Example theme={null}
Fed decreases interest rates by 25 bps after December 2025 meeting?

🟢 Status: Open
📊 Prices: Yes: $0.940  |  No: $0.070
📈 24hr Change: +1.0%

💰 24h Volume: $1.4M
💵 Total Volume: $38,170,799.918
💧 Liquidity: $1,159,958.274 | Spread: 1.00%

📅 Closes: Dec 10th, 2025
```

**Understanding Prices:**

* Prices represent probability from 0% to 100%
* YES + NO always equal \$1.00 (approximately)
* Higher volume = more accurate pricing
* Prices update in real-time

### Trading Interface

From the market detail screen:

1. **Buy Yes** / **Buy No** buttons - Choose your position
2. **Market** or **Limit** - Choose order type
3. Amount selection → Confirmation
4. View current positions in this market (if any)

<Tip>
  Bookmark interesting markets! Add to your watchlist by...wait, that's a future feature. For now, use**Search**  to quickly find markets again.
</Tip>

## Group Integration

Onsight can detect Polymarket links shared in Telegram groups:

<Steps>
  <Step title="Add Bot to Group">
    1. Open your Telegram group
    2. Click group name → Add Members
    3. Search for Onsight bot
    4. Add to group

    <Check>
      Bot needs permission to read messages and send messages.
    </Check>
  </Step>

  <Step title="Share Markets">
    When someone shares a Polymarket link:

    ```text theme={null}
    https://polymarket.com/event/bitcoin-100k-2024
    ```

    The bot automatically replies with a **Buy** button.
  </Step>

  <Step title="Quick Trading">
    Click the **Buy** button to:

    * Open private chat with bot
    * Navigate directly to that market
    * Execute trade without searching

    Perfect for group discussions about specific events!
  </Step>
</Steps>

<Warning>
  Group integration requires the `BOT_USERNAME` to be configured. If the Buy button doesn't appear, the bot may not be properly configured.
</Warning>

## Market Selection Strategy

<AccordionGroup>
  <Accordion title="For Beginners">
    **Recommended Markets:**

    * High volume (> \$100K total)
    * Clear resolution criteria
    * Short timeframes (days to weeks)
    * Topics you understand well

    **Avoid:**

    * New markets with no volume
    * Complex multi-outcome markets
    * Long-term predictions (> 1 year)
    * Markets you don't understand
  </Accordion>

  <Accordion title="For Scalpers">
    **Recommended Markets:**

    * Trending (high 24h volume)
    * Tight spreads (\< 2% difference)
    * News-driven events
    * Short resolution timeframes

    **Strategy:**

    * Trade momentum and volatility
    * Quick in and out (minutes to hours)
    * Smaller position sizes, more trades
    * Use market orders for speed
  </Accordion>

  <Accordion title="For Value Traders">
    **Recommended Markets:**

    * New markets (less efficient pricing)
    * Low-medium volume (mispricings possible)
    * Topics with specialized knowledge
    * Medium-term timeframes (weeks to months)

    **Strategy:**

    * Deep research before entering
    * Larger positions on high-conviction trades
    * Use limit orders for better entry
    * Hold through volatility
  </Accordion>

  <Accordion title="For Diversification">
    **Recommended Approach:**

    * Mix categories (politics, sports, crypto)
    * Mix timeframes (short and long-term)
    * Mix strategies (scalping and value)
    * Never over-expose to one market

    **Benefits:**

    * Reduce portfolio volatility
    * Smooth out returns over time
    * Learn what works for you
    * Avoid catastrophic losses
  </Accordion>
</AccordionGroup>

<Note>
  Market selection is crucial for success. Start with high-volume, short-term markets to build experience, then expand to other strategies as you learn.
</Note>