Skip to main content

account_info RPC Method

Retrieving information about an XRP Ledger account, such as its balance, sequence number, and other account details

Updated on
Oct 4, 2023

account_info RPC Method

Parameters

account
string
REQUIRED
The XRP Ledger account for which information is to be retrieved
strict
boolean
A boolean value indicating whether strict validation should be applied
ledger_index
string
The ledger index to retrieve the account information from
queue
boolean
A boolean value indicating whether to include information about the account's transaction queue
ledger_hash
string
The hash of the ledger containing the payment channel information
signer_lists
boolean
If true and the MultiSign amendment is enabled, also returns any SignerList objects associated with this account

Returns

result
object
The method returns a JSON object with the following properties:
account_data
object
The details of the account data
Account
string
The XRP Ledger account
Balance
string
The account balance
Flags
integer
Flags associated with the account
LedgerEntryType
string
The type of ledger entry
OwnerCount
integer
The number of accounts that own this account
PreviousTxnID
string
The ID of the previous transaction involving this account
PreviousTxnLgrSeq
integer
The ledger sequence of the previous transaction involving this account
RegularKey
string
The regular key associated with the account
Sequence
integer
The sequence number of the account
index
string
The index of the account
signer_lists
array
An array of SignerList ledger objects associated with this account for Multi-Signing. Omitted unless the request specified 'signer_lists' and at least one 'SignerList' is associated with the account
ledger_current_index
integer
The index of the current ledger. Omitted if 'ledger_index' is provided instead
ledger_index
integer
The ledger index of the ledger version used when retrieving this information. Omitted if 'ledger_current_index' is provided instead
queue_data
object
An array that contains information about the account's transaction queue. Omitted unless 'queue' specified as true and querying the current open ledger
txn_count
integer
The number of transactions in the account's queue
auth_change_queued
boolean
Whether a transaction in the queue changes the authorization mechanism for transactions associated with a specific address
lowest_sequence
integer
The lowest sequence number among transactions queued by this address
highest_sequence
integer
The highest sequence number among transactions queued by this address
max_spend_drops_total
string
The maximum amount of XRP, expressed as an integer value in drops, that could be debited from a specific address if every transaction in the queue consumes the maximum amount of XRP possible
transactions
array
The information about each queued transaction from this address
auth_change
boolean
A boolean value indicating whether this transaction changes this address's ways of authorizing transactions
fee
string
The transaction cost, in XRP drops
fee_level
string
The transaction cost relative to minimum cost of transaction in fee levels
max_spend_drops
string
The maximum amount of XRP, in drops, this transaction could send or destroy
seq
integer
The sequence number
validated
string
Indicates if the information is from a validated ledger
status
string
The status of the request
warnings
array
A list of warnings
id
integer
The ID of the warning
message
string
The warning message
Request
1
curl https://docs-demo.xrp-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method": "account_info",
5
	"params": [{
6
        "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
7
        "strict": true,
8
        "ledger_index": "current",
9
        "queue": true
10
    }],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free