> ## 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.

# API Overview

> All available REST endpoints

## Base URL

```
https://polychadsbot.xyz/api/v1
```

All requests require a Bearer token. See [Authentication](/authentication).

## Endpoints

| Method   | Endpoint         | Description                        |
| -------- | ---------------- | ---------------------------------- |
| `GET`    | `/alerts/latest` | Most recent alerts                 |
| `GET`    | `/alerts`        | Paginated history with filters     |
| `GET`    | `/alerts/:id`    | Single alert by ID                 |
| `GET`    | `/hot-markets`   | Markets ranked by insider activity |
| `GET`    | `/stats`         | System-wide stats                  |
| `GET`    | `/me`            | Your key info and usage            |
| `POST`   | `/webhooks`      | Register a webhook (Enterprise)    |
| `GET`    | `/webhooks`      | List your webhooks (Enterprise)    |
| `DELETE` | `/webhooks/:id`  | Remove a webhook (Enterprise)      |

## Responses

Everything is JSON. Success returns `200`. Errors return the appropriate status code with a `detail` field:

```json theme={null}
{
  "detail": "Rate limit exceeded. pro tier: 300 req/min."
}
```

## Pagination

`/alerts` uses page-based pagination. Max `page_size` depends on your tier.

```json theme={null}
{
  "alerts": [...],
  "total": 2226,
  "page": 1,
  "page_size": 50,
  "has_more": true
}
```

| Tier       | Max page\_size |
| ---------- | -------------- |
| Free       | 20             |
| Pro        | 50             |
| Enterprise | 100            |