Subscribe to an account to receive notifications when the lamports or data for a
given account public key changes.
Parameters
- String, [Required] Account Pubkey, as base-58 encoded string.
- Object, [Optional] Configuration object containing the following fields:
- commitment: String, [Optional]
- encoding: String, [Optional]
Encoding format for Account data
values={["base58", "base64", "base64+zstd", "jsonParsed"]}- `base58` is slow.
- `jsonParsed` encoding attempts to use program-specific state parsers to return more human-readable and explicit account state data.
- If `jsonParsed`is requested but a parser cannot be found, the field falls back to binary encoding, detectable when the `data`field is type`string`.
Responses
<number> - Subscription id (needed to unsubscribe)
Examples
Example Requests
{
"jsonrpc": "2.0",
"id": 1,
"method": "accountSubscribe",
"params": [
"CM78CPUeXjn8o3yroDHxUtKsZZgoy4GPkPPXfouKNH12",
{
"encoding": "jsonParsed",
"commitment": "finalized"
}
]
}
Example Responses
{ "jsonrpc": "2.0", "result": 23784, "id": 1 }
Notification Format
The notification format is the same as seen in the getAccountInfo RPC HTTP method.
Base58 encoding
{
"jsonrpc": "2.0",
"id": 1,
"method": "accountNotification",
"params": {
"result": {
"context": {
"slot": 5199307
},
"value": {
"data": [
"11116bv5nS2h3y12kD1yUKeMZvGcKLSjQgX6BeV7u1FrjeJcKfsHPXHRDEHrBesJhZyqnnq9qJeUuF7WHxiuLuL5twc38w2TXNLxnDbjmuR",
"base58"
],
"executable": false,
"lamports": 33594,
"owner": "11111111111111111111111111111111",
"rentEpoch": 635,
"space": 80
}
},
"subscription": 23784
}
}
Parsed-JSON encoding
{
"jsonrpc": "2.0",
"id": 1,
"method": "accountNotification",
"params": {
"result": {
"context": {
"slot": 5199307
},
"value": {
"data": {
"program": "nonce",
"parsed": {
"type": "initialized",
"info": {
"authority": "Bbqg1M4YVVfbhEzwA9SpC9FhsaG83YMTYoR4a8oTDLX",
"blockhash": "LUaQTmM7WbMRiATdMMHaRGakPtCkc2GHtH57STKXs6k",
"feeCalculator": {
"lamportsPerSignature": 5000
}
}
}
},
"executable": false,
"lamports": 33594,
"owner": "11111111111111111111111111111111",
"rentEpoch": 635,
"space": 80
}
},
"subscription": 23784
}
}