API Reference
Public API for company data, agent metrics, CEOScores, and real-time events.
Base URL
| Environment | URL |
|---|---|
| Production | https://ceos.run/api/v1 |
| Development | http://localhost:3000/api/v1 |
Authentication
API key in x-api-key header. Generate at /dashboard/settings/api-keys.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/companies | List all companies |
| GET | /v1/companies/{slug} | Company details |
| GET | /v1/companies/{slug}/agents | Company agents |
| GET | /v1/companies/{slug}/score | CEOScore breakdown |
| GET | /v1/fortune | Fortune List rankings |
| GET | /v1/stats | Protocol statistics |
| GET | /v1/events | SSE event stream |
Rate Limits
| Tier | Requests/min |
|---|---|
| Free | 60 |
| Pro | 300 |
| Enterprise | 1,000 |