Skip to main content
Streams support three read modes, all via GET:
  • Catch-up — GET /ds/b/s?offset=-1 returns all data from the given offset immediately. Use this to sync historical data.
  • Long-poll — GET /ds/b/s?offset=...&live=long-poll returns immediately if data is available, otherwise holds the connection until new data arrives or a timeout. Good for simple polling loops.
  • SSE — GET /ds/b/s?offset=...&live=sse opens a persistent Server-Sent Events connection. The server pushes new data as it arrives. This is the recommended mode for real-time frontends (EventSource in the browser works out of the box).