programSubscribe

programSubscribe — Subscribe to program-owned account changes

post

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

/

Subscribe to a program to receive notifications when the lamports or data for an account owned by the given program changes. This method establishes a persistent WebSocket connection that will send real-time notifications whenever accounts owned by the specified program are created, modified, or deleted. You can filter results by data size, account owner, or custom criteria to only receive notifications for accounts that match your requirements. Parameters

1. programId (required) — Program pubkey, base-58.

2. config (optional) — Optional configuration object. Every field is optional; omit the entire object to use defaults.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Pass Authorization: <api-key> on each request.

Body

application/json

jsonrpcstring · enumRequired

JSON-RPC protocol version.

Example: 2.0Possible values:

idone ofRequired

Request identifier echoed back in the response.

Example: 1

stringOptional

or

integerOptional

methodstring · enumRequired

Must be programSubscribe.

Example: programSubscribePossible values:

Responses

200

Successful programSubscribe response.

application/json

Base envelope of every JSON-RPC 2.0 response.

jsonrpcstring · enumRequiredExample: 2.0Possible values:

idone ofRequired

Echoed request id.

Example: 1

stringOptional

or

integerOptional

resultinteger · int64Required

Subscription id. Save this value to call the matching unsubscribe method later.

Example: 24040

401

Authentication required or invalid.

application/json

403

Insufficient permissions for the request.

application/json

429

Rate limit exceeded for this tier.

application/json

500

Unexpected server error.

application/json

post/

cURL / websocatPythonJavaScriptRust

# cURL doesn't speak WebSocket — use `websocat` (or `wscat -c`).
# Install:  cargo install websocat   # or  npm install -g wscat
echo '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "programSubscribe",
  "params": [
    "TokenkegQfeZyiNwAJsyFbPVwwQnLjMi6tsmbMrWcbq",
    {
      "encoding": "jsonParsed",
      "filters": [
        {
          "dataSize": 165
        }
      ]
    }
  ]
}' | websocat wss://public.rpc.solanavibestation.com

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 24040
}