Solana WebSocket API (Pub/Sub) — /ws/sol

/ws/sol is one WebSocket connection that multiplexes all nine Solana JSON-RPC Pub/Sub method families. Every frame is a JSON-RPC 2.0 message; the method field disambiguates a subscribe request, an unsubscribe request, and a server-pushed notification.

The lifecycle is: open the socket, send a *Subscribe request, and the server replies with a SubscribeAck carrying an integer result — the subscription id. From then on the server pushes *Notification frames whose params.subscription matches that id, until you send the matching *Unsubscribe (or the socket closes). Keep the subscription id — it is the only handle you have to stop a stream.

Each method family carries a minimum tier requirement. accountSubscribe and signatureSubscribe are available on the Free trial; logsSubscribe, programSubscribe, slotSubscribe, and rootSubscribe require basic; and blockSubscribe, voteSubscribe, and slotsUpdatesSubscribe require pro. Subscribing to a method above your tier closes the connection with WS close code 4003 (forbidden) — see Errors.

A subscribe frame is a JSON-RPC 2.0 request: {jsonrpc, id, method, params}.

The first server frame is the SubscribeAck, whose result is the subscription id:

Subsequent frames are server-pushed *Notification envelopes. An accountNotification looks like:

{
  "jsonrpc": "2.0",
  "method": "accountNotification",
  "params": {
    "subscription": 24040,
    "result": {
      "context": { "slot": 348392041 },
      "value": {
        "lamports": 10000000000,
        "owner": "11111111111111111111111111111111",
        "data": ["", "base64"],
        "executable": false,
        "rentEpoch": 361
      }
    }
  }
}

The lowest plan that may open each subscription; every higher plan includes it.

A subscribe above your plan is refused: the server sends an error frame with required_tier and closes the socket with code 4003 (see Errors).

If a subscription stops delivering without a close, see why a subscription goes silent. For all Solana streaming options side by side, see the Solana streams overview; need filters across many accounts? Yellowstone gRPC. How Pub/Sub differs from Geyser-based gRPC: the Solana Geyser plugin explained.

Application errors are delivered as a final WSError frame immediately before the socket closes with one of the canonical WebSocket close codes. The frame mirrors the HTTP error envelope so SDKs can reuse the same error classes — see the shared errors reference for the full envelope.

Example WSError frame sent before a 4003 close:

{
  "error": "forbidden",
  "message": "method requires a higher tier",
  "current_tier": "free",
  "required_tier": "pro",
  "method": "blockSubscribe",
  "category": "sol_ws_pubsub",
  "upgrade_url": "https://triport.io/billing/upgrade?tier=pro"
}

JavaScript (fetch)

The browser WebSocket API can't set custom headers, so authenticate with the ?api-key= query form:

const ws = new WebSocket(
  `wss://triport.io/ws/sol?api-key=${process.env.TRIPORT_API_KEY}`
);


const subs = new Map(); // subscription id -> label


ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "accountSubscribe",
    params: [
      "SysvarC1ock11111111111111111111111111111111",
      { commitment: "finalized", encoding: "jsonParsed" },
    ],
  }));
});


ws.addEventListener("message", (ev) => {
  const msg = JSON.parse(ev.data);
  if (msg.id === 1 && typeof msg.result === "number") {
    subs.set(msg.result, "clock-account");
    console.log("subscribed, id =", msg.result);
  } else if (msg.method === "accountNotification") {
    console.log("account changed at slot", msg.params.result.context.slot);
  }
});

• Hold onto the subscription id. The ack's result is the only handle for unsubscribing; route notifications by params.subscription when you have several active subscriptions on one socket.
• Multiple subscriptions, one socket. A single /ws/sol connection can carry many subscriptions across different method families — open one socket per client, not one per subscription.
• Tier gating is per method. A free connection can run accountSubscribe and signatureSubscribe indefinitely, but a blockSubscribe on the same socket triggers a 4003 close. Check required_tier in the error frame to build an upgrade prompt without a second API call.
• Commitment trade-off. processed arrives first but may be rolled back; finalized is the strongest guarantee. The default is confirmed.
• Related channels: the other Solana connection options are the Firehose (WebSocket) at wss://triport.io/ws/sol-stream, gRPC (Yellowstone) at https://grpc.triport.io and the shred stream at wss://triport.io/ws/sol-preexec (all Pro). The streaming overview lists every channel: Streaming overview.