API Reference

AIR API Reference

Public REST API. Build your own dashboards, trading signals, research tools, Discord bots, or chart embeds on top of live AI risk data. All responses are JSON unless noted.

BASE URL: https://air.20k.gg

Authentication

Public read endpoints need no auth. For higher rate limits and pro-gated endpoints, pass your API key in the Authorization header.

curl -H "Authorization: Bearer air_your_key_here" \
     https://air.20k.gg/api/timeline

Generate API keys from your Pro account settings. Each Pro subscriber can have up to 5 active keys.

Rate limits

Requests per minute. Limits apply per IP (anonymous) or per API key (authenticated). Current limits returned in X-RateLimit-* response headers.

Anonymous

120 / min

Free. No key required.

Pro Key

300 / min

Included with Pro at $5/mo.

Developer Key

1000 / min

Contact for pricing.

Spectrum

GET/api/spectrumFREE

Current AI risk spectrum position (-100 to +100), confidence, and recent history. Free tier returns last 8 history points.

GET/api/airxFREE

AIRX index (0-100 AI anxiety score) with band, trend, and color. Derived from live spectrum. Updates every minute.

GET/api/spectrum/at/:dateFREE 7DPRO FULL

Snapshot of spectrum position and top events on a specific date. Format: YYYY-MM-DD. Free tier is limited to the last 7 days.

Events and articles

GET/api/timelineFREE 8PRO 100

Scored events with score (-20 to +20), confidence, categories. Pro tier returns up to 100 events with full AI reasoning text.

GET/api/articlesFREE 25PRO 100

Raw ingested articles, most recent first. Includes source, categories, URL.

GET/api/incidentsFREE 5PRO 30

Critical incidents flagged from ingested articles.

GET/api/categoriesFREE TOP 5PRO 17

Per-category spectrum positions. Free shows top 5 by impact, Pro shows all 17.

Labs

GET/api/labsFREE 6PRO 19

AI lab safety ratings, trend, avg score, recent events.

GET/api/labs/:idFREE 30DPRO ALL

Single lab detail with daily score series. Query param ?window=30d|90d|all. Free tier limited to 30 days.

GET/api/labs/vs/:id1/:id2FREE 30D

Head-to-head lab comparison with overlay data for charting.

Daily brief and narratives

GET/api/brief/latestFREE

The latest daily brief (200-word summary of last 24h).

GET/api/brief/:dateFREE

Brief for a specific date. Format: YYYY-MM-DD.

GET/api/narratives/latestFREE

This week's clustered narratives.

GET/api/narratives/:weekKeyFREE

Narratives for a specific ISO week. Format: YYYY-W##.

Bulk export (Pro)

GET/api/export/scoresPRO

Full score export as CSV. Query params: from=YYYY-MM-DD, to=YYYY-MM-DD, format=csv|json. Defaults to all-time CSV.

curl -H "Authorization: Bearer air_your_key" \
     "https://air.20k.gg/api/export/scores?from=2026-01-01&to=2026-04-21" \
     -o air-scores.csv

Embed

GET/embed/airx.svgFREE

Live SVG badge showing current AIRX score. Query params: theme=dark|light, size=small|medium|large. See the embed page for copy-paste examples.

Build something with AIR

Subscribe to Pro to get an API key and higher rate limits. Running a high-volume service? Contact us for Developer tier at 1000 req/min.

Get Pro at $5/mo →