accountSubscribe

accountSubscribe opens a Solana PubSub subscription that pushes a notification every time a single account changes — either its SOL balance (held in lamports, where 1 SOL = 1,000,000,000 lamports) or the raw data the owning program stores in it. You give it a base-58 pubkey and the node streams the new account state to you over a WebSocket connection, so you never have to re-poll getAccountInfo. The matching JSON-RPC endpoint is https://solana.therpc.io/YOUR_API_KEY, and you cancel the stream by passing the returned subscription id to accountUnsubscribe.

Use cases

• Watch an SPL Token or Token-2022 account, or a program-derived address (PDA), and see balance or data changes the instant they land.
• Drive a real-time wallet or position UI in a Phantom-style app without ever looping over getAccountInfo.
• React the moment a program — a Raydium pool or a Marinade stake account, for example — writes new bytes into the account you are tracking.

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":"accountSubscribe","params":["9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",{}]}

Errors & troubleshooting

Common pitfalls

• This is a WebSocket-only method — open a wss PubSub connection to subscribe; you cannot call it as a one-shot HTTP request the way you would getAccountInfo.
• Hold onto the numeric subscription id that the call returns and pass it to accountUnsubscribe when you are done, so the node frees the subscription slot.
• The base58 encoding option fails for account data larger than 128 bytes — set encoding to base64 (or jsonParsed for readable token state) when watching larger accounts.

Supported networks

• Mainnet
• Devnet

See also

• getAccountInfo
• programSubscribe