Skip to content

Authentication

Most endpoints are publicly accessible. Authenticated endpoints require a JWT token in the Authorization header:

Authorization: Bearer <your-jwt-token>

Obtain a token via POST /api/auth/login or POST /api/auth/signup.

Endpoints

GET/api/dashboard/overview

Returns aggregate dashboard metrics and per-slot coverage summaries for the current loop.

Response
{
  "loop": 3,
  "timestamp": "2026-03-02T10:19:55",
  "slots": [...],
  "aggregate": {
    "total_slots": 12,
    "on_target": 3,
    "overcovering": 3,
    "undercovering": 6,
    "mean_coverage": 0.821
  }
}
GET/api/dashboard/slot/{slot_id}

Returns detailed metrics for a single slot including iteration history, features, and conformal method.

Response
{
  "slot_id": "oil-price-regression-3m",
  "problem_type": "regression",
  "coverage": 0.86,
  "iterations": [...],
  "conformal_method": "StandardCP",
  "features_used": ["cpi_yoy", "fed_funds_rate", ...],
  "model_type": "XGBoost"
}
POST/api/waitlist

Submit an email to the waitlist for early access notifications.

Response
{
  "success": true,
  "message": "Thanks for joining the waitlist!",
  "email": "user@example.com"
}
GET/api/waitlist/count

Returns the total number of waitlist entries.

Response
{ "count": 142 }
POST/api/auth/signup

Create a new account with email and password.

Response
{
  "token": "eyJ...",
  "user": { "id": "...", "email": "...", ... }
}
POST/api/auth/login

Authenticate with email and password. Returns JWT token.

Response
{
  "token": "eyJ...",
  "user": { "id": "...", "email": "...", ... }
}
GET/health

Health check endpoint. Returns service status and database connectivity.

Response
{
  "status": "healthy",
  "database": "connected",
  "version": "1.0.0"
}
[REBELTERMINAL]~/docs>type anywhere to navigate · Press ` or Cmd+J to open