API Reference
Export

Export

⚠️

Rate limited: 1 export/hour on the free tier, 10/hour on Pro.

GET /v1/export/snapshots

Query parameters

ParamTypeNotes
networkstringRequired
fromISO timestampRequired
toISO timestampRequired
formatcsv | jsonDefault csv

Response: file download (CSV or JSON).


GET /v1/export/sp-history

Query parameters

ParamTypeNotes
addressstringRequired
networkstringRequired
fromISO timestamp
toISO timestamp
GET/v1/export/sp-history

Export a single provider's history. `address` is required.

Response: CSV file download.


GET /v1/activity/stream

Server-sent events (SSE), not a request/response call — the connection stays open and pushes named events as they happen: blob_registered, blob_activated, blob_deleted, sp_joined, sp_left, sp_health_change, epoch_transition, plus connected on open and periodic heartbeat keep-alives.

Events arrive in bursts on the backend's sync cadence (every few minutes), not instantly on registration — a quiet stream for a few minutes is expected, not a sign of a broken connection.

Query parameters

ParamTypeNotes
networkstringRequired
SSE/v1/activity/stream

Live event feed: new blobs registered/activated/deleted, SP join/leave/health changes, epoch transitions.