Substreams WebSockets service — stream decoded blocks, swaps & transfers in real time.
    Read-only preview
    You're browsing the public WebSockets reference. Sign in to open a live stream with your team's API key.
    Streams

    /ws/{streams}

    WebSocket upgrade (path mode)Single (/ws/<a>) or combined (/ws/<a>/<b>/...) channel subscription. Multi-channel wraps payloads in {"stream":"...","data":...}. Wire contract: /SKILL.md.

    GETWS
    wss://ws.pinax.network/ws/{streams}
    This is a WebSocket upgrade route — a GET that switches protocols (HTTP 101). Connect with a WebSocket client, not a plain HTTP request. Wire contract: SKILL.md.

    Required parameters

    NameInTypeDescription
    streamspathstringOne or more `<network>@<table>` selectors joined by `/`. `*` is a wildcard on either side.

    Optional parameters

    NameInTypeDescription
    from_timestampquerystringResume from this Unix epoch seconds value or `YYYY-MM-DD HH:MM:SS` UTC. Replays buffered blocks for explicit selectors.
    filterquerystringURL-encoded JSON `{field: value|[values]}`. Server-side row filter, fields AND, values OR.

    Responses

    StatusContent-TypeDescription
    101Switching Protocols — WebSocket open
    400Invalid selector / filter / from_timestamp
    503max_clients reached