REST endpoints

API Reference

The current API surface for agent clients, scripts, notebooks, and backend services.

Base URL

https://www.signalbench.dev/api/v1

All public endpoints require an x-api-key header when API authentication is enabled.

Endpoints

Method	Path	Purpose
GET	/agent/manifest	Endpoint discovery for agent clients
GET	/signals	Signal catalog and latest values
GET	/signals/{signal_id}	Signal detail, history, explainability, validation
GET	/digest/current	What changed since the last run
GET	/alerts/current	Current alert events
GET	/regimes/current	Composite regime summary
GET	/relationships	Cross-market relationship windows
GET	/health	Repository freshness and operational status

Errors

{
  "error": {
    "code": "unauthorized",
    "message": "x-api-key header is required."
  }
}

Common statuses are 401 for missing or invalid keys, 403 for insufficient tier, 404 for unknown resources, 429 for rate limits, and 500 for internal errors.