> ## 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 Latest Alerts

> The absolute freshest insider alpha, ordered newest first.

Don't want to mess with WebSockets but still need the latest action? Hit this endpoint to get the most recent alerts our engine has pumped out.

<ParamField query="limit" type="integer" default="10">
  How many of the latest alerts you want to pull. Max is 50.
</ParamField>

### Try it out

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

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

  r = requests.get(
      "https://polychadsbot.xyz/api/v1/alerts/latest",
      headers={"Authorization": "Bearer YOUR_KEY_HERE"},
      params={"limit": 2}
  )

  for alert in r.json():
      print(f"🚨 {alert['side']} {alert['outcome']} on '{alert['event_title']}' for ${alert['usdc_value']}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://polychadsbot.xyz/api/v1/alerts/latest?limit=2",
    { headers: { Authorization: `Bearer YOUR_KEY_HERE` } }
  );
  const alerts = await response.json();
  console.log(alerts);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": 2220,
      "alert_type": "fresh_accumulator",
      "wallet_address": "0x9B3b4e3bD0e9c72FF8b1A3c...",
      "event_title": "US strikes Iran by March 31?",
      "event_slug": "us-strikes-iran-by-march-31-2026",
      "side": "BUY",
      "outcome": "Yes",
      "entry_price": 0.19,
      "usdc_value": 1900.0,
      "signal_score": 80,
      "category": "world",
      "trade_count": 1,
      "created_at": "2026-02-27 11:35:26",
      "resolved": false,
      "won": null,
      "profit_usdc": null,
      "details": {
        "wallet_age_days": 2,
        "is_accumulating": true,
        "market_buy_count": 3,
        "market_total_bought": 4500.0,
        "market_avg_price": 0.22
      }
    }
  ]
  ```
</ResponseExample>


## OpenAPI

````yaml GET /alerts/latest
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:
  /alerts/latest:
    get:
      summary: Get Latest Alerts
      description: Returns the most recent insider alerts, sorted newest first.
      operationId: getLatestAlerts
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 50
          description: Number of alerts to return
      responses:
        '200':
          description: Array of alerts
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Alert'
        '401':
          description: Missing API key
        '429':
          description: Rate limited
components:
  schemas:
    Alert:
      type: object
      properties:
        id:
          type: integer
        alert_type:
          type: string
          enum:
            - fresh
            - fresh_accumulator
            - cluster
        wallet_address:
          type: string
        event_title:
          type: string
        event_slug:
          type: string
        market_id:
          type: string
        side:
          type: string
          enum:
            - BUY
            - SELL
        outcome:
          type: string
        entry_price:
          type: number
        usdc_value:
          type: number
        signal_score:
          type: integer
        trade_count:
          type: integer
        category:
          type: string
        created_at:
          type: string
        resolved:
          type: boolean
        won:
          type: boolean
          nullable: true
        profit_usdc:
          type: number
          nullable: true
        details:
          type: object
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key — get one from @chadsapibot on Telegram

````