Streaming

Live stream

Server-Sent Events — one 'tick' event per committed block when live; comment keep-alives otherwise. The key is passed as a query token because EventSource can't set headers.

GET/stream

Requires an API key — Authorization: Bearer <API_KEY>. Costs 1 credit per call to open the stream; rate limits apply per plan.

A browser EventSource can't send headers, so the stream takes your key as a ?token= query parameter. Prefer the stream over polling for live updates.

Headers

Authorizationstringrequired

Bearer <API_KEY> — create a key in your dashboard.

Query parameters

tokenstringrequired

Your API key (EventSource can't set an Authorization header).

Events

event: tickSSEoptional

data: { b: block, tok, tr, sw, po }.

Errors

401Missing or invalid API key.

429Plan rate limit exceeded — back off per Retry-After.

GET/stream

API keytokenrequired

The live stream is a long-lived SSE connection — open it in your own client; see the sample.

Request

const es = new EventSource("https://data.amonhen.com/app/api/stream?token=<API_KEY>");
es.addEventListener("tick", (e) => console.log(JSON.parse(e.data)));

Response · example

event: tick
data: {"b":92744138,"tok":136832,"tr":87892902,"sw":14363164,"po":13062}