accountSubscribe

accountSubscribe WebSocket Method

post

wss://public.rpc.solanavibestation.comwss://basic.rpc.solanavibestation.comwss://ultra.rpc.solanavibestation.comwss://elite.rpc.solanavibestation.comwss://epic.rpc.solanavibestation.comwss://basic.swqos.solanavibestation.comwss://ultra.swqos.solanavibestation.comwss://elite.swqos.solanavibestation.com

/

Subscribe to an account to receive notifications when the lamports or data for a given account public key changes. Returns a subscription ID that can be used to unsubscribe. This method establishes a persistent WebSocket connection that will send real-time notifications whenever the specified account's state changes on the blockchain.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Authorization header for API key authentication.

Example:

Authorization: your-api-key-here

Body

application/json

Request object for subscribing to account changes via WebSocket

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

idone ofRequired

Request identifier that will be returned in the response

Example: 1

stringOptional

or

numberOptional

methodstring · enumRequired

The WebSocket method name

Example: accountSubscribePossible values:

Responses

101

WebSocket notification for account changes

application/json

200

Subscription successfully created

application/json

Response containing the subscription ID for the account subscription

jsonrpcstring · enumRequired

JSON-RPC protocol version

Example: 2.0Possible values:

idone ofRequired

Request identifier matching the original request

Example: 1

stringOptional

or

numberOptional

resultintegerOptional

Unique subscription ID for this account subscription. Use this ID to unsubscribe from notifications using the accountUnsubscribe method.

Example: 23784

400

Bad Request - Invalid parameters

application/json

401

Unauthorized

text/plain

403

Forbidden

text/plain

429

Too Many Requests

text/plain

500

Internal Server Error

text/plain

post

/

WebSocket (Browser)Node.js WebSocketSolana Web3.jsRustPython

const ws = new WebSocket('wss://public.rpc.solanavibestation.com');

ws.onopen = function() {
  // Subscribe to account changes
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'accountSubscribe',
    params: [
      'CM78CPUeXjn8o3yroDHxUtKsZZgoy4GPkPPXfouKNH12',
      { commitment: 'finalized', encoding: 'jsonParsed' }
    ]
  }));
};

ws.onmessage = function(event) {
  const data = JSON.parse(event.data);
  
  if (data.method === 'accountNotification') {
    console.log('Account changed:', data.params);
  } else if (data.result) {
    console.log('Subscription ID:', data.result);
  }
};

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