PUBLIC API · NO AUTHENTICATION REQUIRED

Build on the evidence layer

Use the signal ledger for auditable emissions, the live-state endpoint for resilient dashboard data and the case-study endpoint for worked examples. The public API is read-only.

OPEN JSON →DOWNLOAD CSV ↓

Endpoints

GET /api/v1/signals?limit=50

Latest append-only signal emissions as JSON. Limit accepts 1–250 records.

GET /api/v1/signals.csv

Up to 250 latest signal records as a downloadable UTF-8 CSV.

GET /api/live-state

Current dashboard and news state with per-feed live, last-known-good or unavailable status.

GET /api/case-studies

Three historical reconstructions with source links and daily close context.

Signal fields

emittedAt

The first time Geopolitics Alpha durably recorded this exact signal identity.

sourceObservedAt

The publication or observation time supplied by the source when available.

directAssets

Public companies explicitly named in the report. Watchlist membership is not required.

exposureAssets

Related instruments selected through a labeled transmission rule.

marketSnapshot

Available quote context captured at signal emission, including provider labeling.

observations

Append-only price records such as the detection baseline. Missing horizons remain pending.

Integrity and limits

Ledger and price-observation tables reject update and delete operations.
Repeated ingestion uses deterministic identities and does not rewrite an earlier emission.
Live-state responses label whether each feed is live, last-known-good or unavailable.
Exposure mappings are research context, not causal proof, a forecast or a recommendation.
No rate limit is promised. Clients should cache responses and retry with backoff.