API Documentation

The SHORT RADAR REST API serves scores, signals, macro data and triggers as JSON. API keys are available from PRO (Settings → API); some endpoints are public.

Authentication

Create an API key in the portal (Settings → API) and send it as a Bearer token. Keys start with bb_ and are bound to your tier limit.

curl -H "Authorization: Bearer bb_YOUR_API_KEY" \
  https://dash.shortradar.app/api/v1/score

Web sessions (JWT) and API keys have separate limits — portal usage is never throttled by API usage.

Limits per tier (per API key)

Tier	Calls/day	Calls/minute
FREE	10	5
PRO	1,000	60
ELITE	10,000	120
INSTITUTIONAL	∞	1,000

Responses include X-RateLimit-Remaining and X-RateLimit-Scope: api-key. Exceeding limits returns HTTP 429.

Endpoints

`GET` `/api/v1/score` Current Burry Score (FREE: headline; PRO+: components).	FREE
`GET` `/api/v1/score/history?days=30` Score history. FREE: 7-day delay · PRO: 30 days live · ELITE: 365 days.	FREE*
`GET` `/api/v1/score/benchmarks` Both scores next to official stress indices (OFR, StL Fed, ECB CISS, Sahm).	public
`GET` `/api/v1/eu-score` Current EU crisis score (European Systemic Crisis Lens).	FREE
`GET` `/api/v1/signals?limit=10` Active short signals. PRO: top 10 · ELITE: all incl. squeeze score.	PRO
`GET` `/api/v1/signals/track-record` Public track record (aggregates + closed signals; .csv variant available).	public
`GET` `/api/v1/macro` 17 macro indicators incl. OFR FSI, discount window, ECB CISS.	PRO
`GET` `/api/v1/sectors` Sector scores of both lenses.	FREE
`GET` `/api/v1/triggers?hours=48` Triggers fired in the last N hours.	PRO
`GET` `/api/v1/ml/predict/crisis` ML crisis forecast (LSTM) + regime.	ELITE
`GET` `/api/v1/brief/latest` Daily "what changed" brief (FREE: teaser).	FREE*
`GET` `/api/v1/status` System status + 90-day uptime.	public

"FREE*" = login/key required, content depends on tier. "public" = no auth.

Example response (GET /api/v1/score)

{
  "score": 27.3,
  "label": "Moderate",
  "phase": "MONITORING",
  "timestamp": "2026-07-20T07:00:00+00:00"
}

Fair use & attribution

Personal use and internal analysis are allowed on all paid tiers. Public display of the data requires attribution ("Data: shortradar.app" with a link).

Reselling or redistributing raw data requires an INSTITUTIONAL agreement. Questions: via /hilfe.