signatureSubscribe

signatureSubscribe 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 receive a notification when the transaction with the given signature reaches the specified commitment level. This is a subscription to a single notification that is automatically cancelled by the server once the signatureNotification is sent. Optionally, you can also receive notifications when the signature is first received by the RPC before processing begins. The transaction signature must be the first signature from the transaction.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Authorization header for API key authentication.

Example:

Authorization: your-api-key-here

Body

application/json

Request object for subscribing to signature notifications 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: signatureSubscribePossible values:

Responses

101

WebSocket notification for signature status

application/json

200

Subscription successfully created

application/json

Response containing the subscription ID for the signature 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 signature subscription. Note that this subscription will be automatically cancelled by the server once a notification is sent, so manual unsubscription is not necessary.

Example: 24006

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 signature confirmation
  const signature = "2EBVM6cB8vAAD93Ktr6Vd8p67XPbQzCJX47MpReuiCXJAtcjaxpvWpcg9Ege1Nr5Tk3a2GFrByT7WPBjdsTycY9b";
  
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'signatureSubscribe',
    params: [
      signature,
      {
        commitment: 'finalized',
        enableReceivedNotification: true
      }
    ]
  }));
};

ws.onmessage = function(event) {
  const data = JSON.parse(event.data);
  
  if (data.method === 'signatureNotification') {
    const { context, value } = data.params.result;
    const subscriptionId = data.params.subscription;
    
    if (value === 'receivedSignature') {
      console.log(`[Slot ${context.slot}] Transaction signature received`);
    } else if (value.err === null) {
      console.log(`[Slot ${context.slot}] Transaction confirmed successfully!`);
      console.log(`Subscription ${subscriptionId} automatically cancelled`);
    } else {
      console.log(`[Slot ${context.slot}] Transaction failed:`, value.err);
      console.log(`Subscription ${subscriptionId} automatically cancelled`);
    }
  } else if (data.result !== undefined) {
    console.log('Signature subscription ID:', data.result);
  }
};

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": {
        "err": null
      }
    },
    "subscription": 24006
  }
}