> ## 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 System Stats

> Pull down global statistics on the Polychads engine for the current day.

Curious about how active Polymarket insiders are right now? This endpoint returns the raw numbers on everything our engine has tracked today (resetting at UTC midnight).

<Note>
  This endpoint requires an API key, but it does **not** consume rate limits and accepts keys from any tier.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_KEY_HERE" \
    https://polychadsbot.xyz/api/v1/stats
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "total_alerts": 14205,
    "alerts_today": 241,
    "avg_signal_today": 68.2,
    "clusters_today": 14,
    "win_rate": 0.58,
    "total_resolved": 4820,
    "total_won": 2795
  }
  ```
</ResponseExample>

## Response Breakdown

| Field              | Type    | Description                                                                                           |
| ------------------ | ------- | ----------------------------------------------------------------------------------------------------- |
| `total_alerts`     | integer | The all-time number of suspicious trades tracked in our database.                                     |
| `alerts_today`     | integer | How many alerts have fired since UTC midnight.                                                        |
| `avg_signal_today` | float   | The average Signal Score (0-100) of today's alerts. High numbers mean heavy insider conviction today. |
| `clusters_today`   | integer | How many times we caught multiple fresh wallets coordinating buys simultaneously.                     |
| `win_rate`         | float   | The historical success rate (e.g., `0.58` = 58%) of alerts where the market has fully resolved.       |
| `total_resolved`   | integer | Of all the markets we've issued alerts for, how many have definitively closed.                        |
| `total_won`        | integer | Of those resolved markets, how many times the alerted trade was correct.                              |


## OpenAPI

````yaml GET /stats
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:
  /stats:
    get:
      summary: Get Stats
      description: System-wide alert statistics.
      operationId: getStats
      responses:
        '200':
          description: Stats object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Stats'
components:
  schemas:
    Stats:
      type: object
      properties:
        total_alerts:
          type: integer
        alerts_today:
          type: integer
        avg_signal_today:
          type: number
        clusters_today:
          type: integer
        win_rate:
          type: number
        total_resolved:
          type: integer
        total_won:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key — get one from @chadsapibot on Telegram

````