API Overview

Base URL

https://polychadsbot.xyz/api/v1

All requests require a Bearer token. See Authentication.

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)

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

{
  "detail": "Rate limit exceeded. pro tier: 300 req/min."
}

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

{
  "alerts": [...],
  "total": 2226,
  "page": 1,
  "page_size": 50,
  "has_more": true
}