Technical whitepaper

Cassandra JSON API

Machine-readable CRS scores, factor readings, analog resolution payloads, and edition metadata. Decision-support data only. No execution endpoints.

Authentication

API tier subscribers receive an API key via account settings. Pass it on every request:

Authorization: Bearer <api_key>
X-Cassandra-Tier: agent

Unauthenticated requests receive the free tier: CRS + band with a two-day delay. Keys are rate-limited per plan.

Base URL

https://crash.netie.ai/api

Local development: http://localhost:8080/api

Endpoints

GET /latest

Current CRS score, band, fragility, trigger, phase, coverage, and as-of date.

{
  "crs": 39.2,
  "band": "Aware",
  "fragility": 0.58,
  "trigger": 0.41,
  "phase": "distribution",
  "phase_confidence": 0.72,
  "coverage": 0.8,
  "asof": "2026-06-24",
  "band_halfwidth": 1.2,
  "confidence": 0.65,
  "factors": { "L": 0.44, "V": 0.51, "S": 0.38, "B": 0.62, "C": 0.47 }
}

GET /scores/history?limit=30

Trailing daily CRS rows for charting and backtests.

GET /report/highlights

Edition headline, direction, sentiment, analog date, and sourced news snippets.

GET /report/edition?asof=YYYY-MM-DD

Full persisted edition snapshot for a trading day.

GET /analog/resolution?ticker=MU

API tier: up to five historical analogs (1990–2026) with next-day/week/month outcomes and source URLs. One ticker per day.

Rate limits

Tier	Requests	Refresh
Free (delayed)	60 / hour	2-day lag
Report	120 / hour	Edition cadence
Pro	300 / hour	Intraday on trading days
API	1,000 / hour	3× daily + webhook

Example request

curl -s -H "Authorization: Bearer $CASSANDRA_API_KEY" \
  "https://crash.netie.ai/api/latest" | jq .crs, .band, .asof

Expected: numeric CRS, band label, and ISO date string. Missing fields mean thin coverage. Check coverage before acting.

CRS is computed in Python, never by an LLM. Analog outcomes are historical records with linked sources, not forecasts. This API does not place trades.