Mental Health Radar

Acute Stress Signal Index (ASSI) — Global + US States

Thriving (1–20)

Stable (21–40)

OECD Base (41–60)

Severe (61–80)

Crisis (81–100)

Insufficient Data

7-Day Global Trend

Unified API Endpoints

Replace BASE_URL with your deployment URL (or http://localhost:8000 for local dev).

GET BASE_URL/api/scores

All entities (US states + global countries). Filter: ?entity_type=us_state or ?entity_type=country. Deprecated: ?region=us|global.

GET BASE_URL/api/scores/{entity}

Single-entity detail. Works for any US state or global country (e.g. Germany, California, south-africa).

GET BASE_URL/api/history

7-day rolling unified history. Each snapshot has an entity_type field and entities dict with per-entity composite scores.

GET BASE_URL/api/signals

Live/stale status for all 13 data signals. Each entry includes entity_types field.

Signal Coverage (13 signals)

Signal	Source	Cache TTL	Scope
Labor Market	BLS	24 hr	US states
Social Distress	Reddit	3 hr	US states
Overdose Rate	CDC	24 hr	US states
Disaster Activity	FEMA	6 hr	US states
Drug Shortages	FDA	24 hr	US states
Housing Stress	Eviction Lab	24 hr	US states
Gun Violence	GVA	24 hr	US states
Air Quality	EPA AirNow	3 hr	US states
Media Sentiment	GDELT	6 hr	US + Global
Search Anxiety	Google Trends	7 days	US + Global
Unemployment (ILO)	ILO ILOSTAT	24 hr	Global
Disasters (EM-DAT)	EM-DAT/ReliefWeb	6 hr	Global
Conflict (ACLED)	ACLED	6 hr	Global

Data Confidence Levels

high — 4–5 signals returned data (countries) / all signals active (US states)
partial — 1–3 signals available (shown with ⚠ badge)
low / Insufficient Data — no coverage-gating signals returned data; score withheld

Scoring Formula

anchored_score = clip(50 + z × 15, min=5, max=95) where z = (value − global_ref) / scale ASSI = Σ (domain_weight × domain_score) [12 domains] Final = clip(ASSI × (1 + BVI_modifier), 5, 95)

Local Development

uvicorn api.main:app --reload # FastAPI on :8000 python3 -m http.server 3000 --directory frontend # Open index.html

Version 1.2 — Globally-anchored Z-score framework · Unified pipeline (US + Global)

Overview

The same Acute Stress Signal Index (ASSI) formula applies to all entities. 50 represents the OECD developed-nation baseline. A country scoring 65 and a US state scoring 65 are both experiencing conditions 1 standard deviation above the developed-nation baseline on the signals available.

Z-Score Normalization

anchored_score = clip(50 + z × 15, min=5, max=95) where z = (value − global_ref) / scale GDELT ref: 2.5 (global mean inverted tone, Leetaru & Schrodt 2013) Trends ref: dynamic (current batch mean / SD) BLS ref: 200/100k (OECD Labour Force Statistics)

Domain Model

12 wellbeing domains weighted by literature evidence. Each signal declares which domains it affects and at what weight via the Signal Registry. Missing signals cause graceful re-normalization among present signals (no domain defaults to 50 unless no signals are available at all).

Risk Level Classification

Score Range	Risk Level	Color
1 – 20	Thriving	■ Green
21 – 40	Stable	■ Sky Blue
41 – 60	OECD Base	■ Amber
61 – 80	Severe	■ Orange
81 – 100	Crisis	■ Red
—	Insufficient Data	■ Grey

References

Leetaru & Schrodt (2013) — GDELT tone reference
WHO World Mental Health Atlas (2022) — global mental health baselines
OECD Health Statistics (2023) — developed-nation reference values
Singer et al. (2017) — Syndemics, The Lancet