Auto-generated. This article is rebuilt from FastAPI route introspection by scripts/build_api_kb.py. Edit the route docstring in app/ and re-run the script — do not edit this file directly.

GET /api/v1/agents/stream

Handler: app.signals.routes.get_agents_stream
Methods: GET

Description

Server-Sent Events stream of regime changes and critical alert fire/resolve.

Event types:

• snapshot — current regime + active critical alert IDs, sent on connect.
• regime_change — {from, to, trade_date}.
• critical_fired — {alert_id, first_fired_at}.
• critical_resolved — {alert_id}.
• heartbeat — emitted every ~30s of silence so clients can detect dead connections.
• error — transient error without terminating the stream.

The stream polls the signals DB every 5 seconds. Clients should reconnect with exponential backoff; use the snapshot event to resynchronise.

Bounded by _STREAM_MAX_CONNECTIONS concurrent connections (503 over the cap) and _STREAM_MAX_LIFETIME_SECONDS per connection (API audit P1) — the stream emits a close event and ends at the lifetime cap so the client reconnects.

Curl

curl -s https://bigclawd.com/api/v1/agents/stream