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

curl https://docs-demo.xrp-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method": "account_info",
	"params": [{
        "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
        "strict": true,
        "ledger_index": "current",
        "queue": true
    }],"id":1,"jsonrpc":"2.0"}'

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "method": "account_info",
  "params": [
    {
      "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "strict": true,
      "ledger_index": "current",
      "queue": true
    }
  ],
  "id": 1,
  "jsonrpc": "2.0"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.xrp-mainnet.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.xrp-mainnet.quiknode.pro/"

payload = json.dumps({
  "method": "account_info",
  "params": [
    {
      "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "strict": True,
      "ledger_index": "current",
      "queue": True
    }
  ],
  "id": 1,
  "jsonrpc": "2.0"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "account_info",
  "params": [
    {
      "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
      "strict": true,
      "ledger_index": "current",
      "queue": true
    }
  ],
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free