Skip to main content
API referenceChain

Chain Stream

Last updated

GET
/api/v1/chain/stream

Subscribe to decoded chain activity as it is captured (#4982, ADR 0015). Server-sent events by default; send a WebSocket Upgrade header on this same path for the WS transport. No auth: this is the same public read-only data /api/v1/chain-events serves, pushed instead of polled. A filter naming only unpublished topics yields a well-formed stream that never emits (currently published: blocks); the stream says so once, at connect.

Query Parameters

topics?array<>

Comma-separated source tables to subscribe to. Omitted means every topic. Unrecognized names are dropped from the filter, and a filter that is ENTIRELY unrecognized matches nothing rather than falling back to everything -- a typo'd topic must not subscribe you to the full firehose.

netuid?integer

Only deliver events for this subnet. Applies only to topics whose rows carry a netuid (account_events); un-scoped topics such as blocks pass through unfiltered. A malformed value degrades to no filter rather than an error.

Range0 <= value <= 65535

Response Body

text/event-stream

curl -X GET "https://example.com/api/v1/chain/stream"
"string"