Supra

Supra Web Socket API

Block-streaming WebSocket subscription Api

Documentation GitHub OpenAPI

Operations 1

GET /rpc/v4/ws Supra JSON-RPC WebSocket subscriptions (v4) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/supra-websocket-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Supra RPC Node Web Socket API
  description: '0.5.0

    tag:supra_rpc_v11.5.2

    commit_hash:5e9ea652

    build_time:2026-08-25 08:38:29 +00:00

    build_env:rustc 1.97.1 (8bab26f4f 2026-07-14),1.97.1-x86_64-unknown-linux-gnu'
  contact:
    name: Supra Labs
    url: https://supra.com
  version: 5e9ea652457cd48aba6b1505bdd59da27fec13f6
servers:
- url: /
tags:
- name: Websocket
  description: Block-streaming WebSocket subscription Api
paths:
  /rpc/v4/ws:
    get:
      tags:
      - Websocket
      summary: Supra JSON-RPC WebSocket subscriptions (v4)
      description: 'Opens a WebSocket connection over which clients may subscribe to Supra-formatted API data.

        Serves data for all VMs.


        This is a `GET` request that upgrades to a WebSocket. Over the socket, a minimal JSON-RPC

        2.0 subscription protocol is spoken (note: OpenAPI documents the upgrade handshake only,

        not the pushed message stream):


        - `supra_subscribe ["newBlocks", {"includeTransactions": , "includeProof": }]`

        streams the full `BlockV4` for each newly committed block (defaults: `includeTransactions =

        true`, `includeProof = false`).

        - `supra_subscribe ["newBlockHeaders"]` streams the `BlockHeaderInfo` only.

        - `supra_unsubscribe [""]` cancels a subscription.


        The subscribe response is `{"jsonrpc":"2.0","result":"","id":}`.

        Notifications arrive as `{"jsonrpc":"2.0","method":"supra_subscription","params":

        {"subscription":"","result":}}`, reusing the same

        serialization as the REST block endpoint so a single deserializer serves push and poll.


        When the node configures `websocket_auth_tokens`, clients must send

        `Authorization: Bearer `. Connection and subscription limits are enforced per token.'
      operationId: supra_block_ws
      responses:
        '101':
          description: Switching protocols; the connection is upgraded to a WebSocket.
        '429':
          description: Connection or subscription limit reached.
          headers:
            Retry-After:
              schema:
                type: integer
                format: u-int32
                minimum: 0
              description: Seconds to wait before retrying.
            X-WebSocket-Reject-Reason:
              schema:
                type: string
              description: Reason the connection was rejected.
        '503':
          description: The Supra WebSocket endpoint is disabled on this node.