programSubscribe

On Solana, every smart contract is a program that owns a set of data accounts, and programSubscribe opens a PubSub subscription that pushes a notification whenever any account owned by a given program changes. Each notification carries the changed account's pubkey and its new state — lamport balance and program data — so you can watch an entire program's account set at once instead of subscribing to addresses one by one. The matching JSON-RPC endpoint is https://solana.therpc.io/YOUR_API_KEY, and you stop the stream by passing the returned subscription id to programUnsubscribe.

Use cases

• Stream live updates for every account of a DeFi or token program — the SPL Token program, a Raydium pool program, or a Marinade staking program.
• Track order-book entries, vault balances, or open positions in real time as the program rewrites them.
• Build a live indexer that reacts to each program account write, keeping your database in lockstep with on-chain state.

Parameters

Response

Example request

1# Open a WebSocket connection (e.g. with wscat) and send the subscribe request:
2wscat -c wss://solana.therpc.io/YOUR_API_KEY
3# then send:
4> {"jsonrpc":"2.0","id":1,"method":"programSubscribe","params":["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",{}]}

Errors & troubleshooting

Common pitfalls

• A busy program such as SPL Token owns millions of accounts and will flood the socket — always pass filters (dataSize and/or memcmp, exactly as with getProgramAccounts) to narrow the stream to the accounts you care about.
• This is a WebSocket-only method — keep the numeric subscription id it returns and call programUnsubscribe with it to stop and free the slot.

Supported networks

• Mainnet
• Devnet

See also

• getProgramAccounts
• accountSubscribe