Quickstart

Prerequisites

You'll need an EdgeOrigin API key and any HTTP client. Your account team can provision a sandbox key with sample streams in under an hour.

Authenticate

Pass your API key as a bearer token on every request:

export EDGEORIGIN_API_KEY="eo_live_..."
curl https://api.edgeorigin.com/v1/streams \
  -H "Authorization: Bearer $EDGEORIGIN_API_KEY"

Your first query

Pull recent records from a stream. Each record is timestamped and carries the signal values our models assigned it in flight, plus its provenance:

curl "https://api.edgeorigin.com/v1/records?stream=global-news&since=-15m" \
  -H "Authorization: Bearer $EDGEORIGIN_API_KEY"

# -> [{ "id": "...", "ts": "2026-07-14T12:00:03Z",
#       "urgency": 0.94, "authenticity": 0.99, "data_quality": 0.96,
#       "source": "...", "payload": { ... } }]

Subscribe to the stream

For real-time delivery, open a streaming connection and receive records as they arrive:

const es = new EventSource(
  "https://api.edgeorigin.com/v1/stream/global-news",
  { headers: { Authorization: "Bearer " + process.env.EDGEORIGIN_API_KEY } }
);
es.onmessage = (e) => console.log(JSON.parse(e.data));