REST API
API reference
Stable version 1 routes for signals, research updates, and premium anomaly workflows.
Base URL and authentication
https://www.signalbench.dev/api/v1Send your API key in the x-api-key header. Rate limits and paid capabilities follow your current plan.
Endpoints
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET | /agent/manifest | Free | Discover available routes |
| GET | /signals | Free | List signals and latest readings |
| GET | /signals/{signal_id} | Free | Read signal detail and recent history |
| GET | /digest/current | Free | Read the latest published changes |
| GET | /alerts/current | Standard | Read current alert events |
| GET | /regimes/current | Standard | Read the current regime response |
| GET | /relationships | Standard | Read relationship windows |
| GET | /surprise/current | Standard | Read current release surprise |
| GET | /surprise/history | Standard | Read release surprise history |
| GET | /anomalies/current | Premium | Read the current anomaly snapshot when enabled |
| GET | /anomalies/change-points | Premium | Read recent change points when enabled |
| GET | /lead-lag | Premium | Read lead and lag pairs when enabled |
Errors
| Status | Meaning |
|---|---|
| 401 | API key is missing or invalid |
| 403 | The current plan does not include the route |
| 404 | The requested resource does not exist |
| 429 | The rate limit was reached |
| 500 | The request could not be completed |