Skip to main content

unsubscribe RPC Method

Instruct the server to cease sending messages related to a specific subscription or a group of subscriptions

Updated on
Oct 4, 2023

unsubscribe RPC Method

Parameters

streams
array
An array of string names of generic streams to unsubscribe from, including ledger, server, transactions, and transactions_proposed
accounts
array
Array of unique account addresses to stop receiving updates for, in the XRP Ledger's base58 format
accounts_proposed
array
Like accounts, but for accounts_proposed subscriptions that included not-yet-validated transactions
books
array
An array of objects defining order books to unsubscribe from

Returns

id
string
The unique identifier for the unsubscription request
status
string
The status of the unsubscription request
type
string
The type of response being received
result
string
The actual response data returned by the API
warnings
array
A list of warnings
id
integer
The ID of the warning
message
string
The warning message
Request
1
wscat -c \
2
# wait for connection
3
{"id":1,"command":"unsubscribe","ledger_index": "current", "streams": ["ledger","server","transactions","transactions_proposed"],"accounts": ["rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"],"accounts_proposed": ["rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"],"books": [{"taker_pays": {"currency": "XRP"},"taker_gets": {"currency": "USD","issuer": "rUQTpMqAF5jhykj4FExVeXakrZpiKF6cQV"},"both": true}]}
4
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free