Skip to main content

Authentication model

  • /health and / are public.
  • Every /v1/* endpoint requires Authorization: Bearer <token>.
  • Tokens are validated against your API key records.
Missing token response:
Invalid token response:

Validation errors (400)

Query parameter validation errors return:
Examples:
  • provider must be kalshi or polymarket
  • status must be open or closed
  • expand (events endpoint) must be exactly markets

Server errors (500)

Unhandled errors return:

Caching behavior

For successful GET /v1/* responses, the API returns:
For 401 and 403 responses on /v1/*, the API returns: