API reference - Centaur Docs

The REST API is read-only, except for managing webhook endpoints. Send your API key in the x-api-key header to the v2 base URL:

curl --fail-with-body 'https://api.centaur.io/v2/events?limit=10' \
  -H "x-api-key: $CENTAUR_API_KEY"

Get access explains keys and scopes. The endpoint pages in this tab are generated from the OpenAPI spec.

Conventions

Requests and responses: envelopes, identifiers, filters, pagination, time ranges, and ordering.
Errors and limits: statuses, request limits, rate limits, and the MCP quota.

Versions

Use v2 for new integrations. It has every read, including the trader directory and the separate trader activity collection. v1 stays available at https://api.centaur.io/v1 for existing clients, with no retirement date. Switch versions with the selector at the top of this tab. To move trader reads to v2, see Trader directory migration.

Specs and tools

Resource	v2	v1
OpenAPI	`https://api.centaur.io/v2/openapi.json`	`https://api.centaur.io/v1/openapi.json`, also served at `/openapi.json`
Swagger UI	`https://api.centaur.io/v2/docs`	`https://api.centaur.io/v1/docs`

MCP server: https://mcp.centaur.io/mcp. See Connect an AI agent.
For agents: https://api.centaur.io/llms.txt and the Centaur skill.
Health check: GET /healthz.

Last modified on October 22, 2026