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

# Get Hot Markets

> The absolute hottest markets right now, ranked by insider activity.

Where is the smart money flowing? This endpoint aggregates our entire alert feed into three distinct leaderboard lists: Most Alerts, Highest Signal Score, and Biggest Trades.

<Note>
  This endpoint is completely **public**. No API key is required, making it incredibly easy to pull down into front-end dashboards.
</Note>

<ParamField query="period" type="string" default="24h">
  The time window to look back. Valid options: `1h`, `6h`, `24h`, `7d`, `30d`.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Maximum items to return per leaderboard list (1–25).
</ParamField>

<ParamField query="category" type="string">
  Isolate to a specific category: `crypto`, `politics`, `world`, `tech`, `finance`, `pop_culture`, `other`.
</ParamField>

## What you get back

We return three arrays of market data, each sorted by a different core metric:

| Leaderboard      | Sorted by               | When to use it                                                                           |
| ---------------- | ----------------------- | ---------------------------------------------------------------------------------------- |
| `most_alerts`    | Count (descending)      | Finding where the highest volume of individual suspicious trades are happening.          |
| `highest_signal` | Avg score (descending)  | Finding markets with the absolute strongest, most highly-coordinated insider conviction. |
| `biggest_trades` | Total USDC (descending) | Following the literal whale money.                                                       |

### Try it out

<RequestExample>
  ```bash cURL theme={null}
  curl "https://polychadsbot.xyz/api/v1/hot-markets?period=1h&limit=5"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://polychadsbot.xyz/api/v1/hot-markets",
      params={"period": "6h", "limit": 5, "category": "crypto"}
  )
  data = r.json()

  print("🔥 HOTTEST MARKETS:")
  for market in data["most_alerts"]:
      print(f"- {market['event_title']}: {market['alert_count']} alerts, ${market['total_usdc']}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://polychadsbot.xyz/api/v1/hot-markets?period=24h&limit=10"
  );
  const { most_alerts, highest_signal, biggest_trades } = await response.json();
  console.log("Whale markets:", biggest_trades);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "period": "24h",
    "most_alerts": [
      {
        "market_id": "0x1234...abcd",
        "event_title": "Will ETH hit $5000 by April?",
        "event_slug": "eth-5000-april",
        "category": "crypto",
        "alert_count": 12,
        "avg_signal": 68.5,
        "total_usdc": 45200.0,
        "latest_alert": "2026-03-01T10:15:22"
      }
    ],
    "highest_signal": [
      {
        "market_id": "0x5678...efgh",
        "event_title": "US strikes Iran by March 31?",
        "event_slug": "us-strikes-iran-by-march-31-2026",
        "category": "world",
        "alert_count": 4,
        "avg_signal": 85.0,
        "total_usdc": 18500.0,
        "latest_alert": "2026-03-01T09:42:10"
      }
    ],
    "biggest_trades": [
      {
        "market_id": "0x9abc...ijkl",
        "event_title": "Opinion FDV above $500M?",
        "event_slug": "opinion-fdv-above-500m",
        "category": "crypto",
        "alert_count": 6,
        "avg_signal": 72.3,
        "total_usdc": 62100.0,
        "latest_alert": "2026-03-01T10:08:44"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /hot-markets
openapi: 3.0.3
info:
  title: Polychads Alerts API
  version: '1.0'
  description: Real-time Polymarket insider trading alerts
servers:
  - url: https://polychadsbot.xyz/api/v1
security:
  - bearerAuth: []
paths:
  /hot-markets:
    get:
      summary: Get Hot Markets
      description: >-
        Markets ranked by insider activity — most alerts, highest signal,
        biggest trades.
      operationId: getHotMarkets
      parameters:
        - name: period
          in: query
          schema:
            type: string
            default: 24h
            enum:
              - 1h
              - 6h
              - 24h
              - 7d
              - 30d
          description: Time window
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 25
          description: Max items per list
        - name: category
          in: query
          schema:
            type: string
            enum:
              - crypto
              - politics
              - world
              - tech
              - finance
              - pop_culture
              - other
          description: Filter by category
      responses:
        '200':
          description: Three ranked lists of hot markets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotMarketsResponse'
components:
  schemas:
    HotMarketsResponse:
      type: object
      properties:
        period:
          type: string
        most_alerts:
          type: array
          items:
            $ref: '#/components/schemas/HotMarketItem'
        highest_signal:
          type: array
          items:
            $ref: '#/components/schemas/HotMarketItem'
        biggest_trades:
          type: array
          items:
            $ref: '#/components/schemas/HotMarketItem'
    HotMarketItem:
      type: object
      properties:
        market_id:
          type: string
        event_title:
          type: string
        event_slug:
          type: string
        category:
          type: string
        alert_count:
          type: integer
        avg_signal:
          type: number
        total_usdc:
          type: number
        latest_alert:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key — get one from @chadsapibot on Telegram

````