xrp

XRP (XRP)

Method: POST account_info

dropdown
POST

account_info

The account_info command retrieves information about an account, its activity, and its XRP balance.

All information retrieved is relative to a particular version of the ledger.

Parameters

account - String

The unique identifier of an account, typically the account's Address.

The request returns channels where this account is the channel's owner/source.

ledger_hash - String

(Optional) A 20-byte hex string for the ledger version to use.

ledger_index - String or Unsigned Integer

(Optional) The ledger index of the ledger to use, or a shortcut string to choose a ledger automatically.

queue - Boolean

(Optional) If true, and the FeeEscalation amendment is enabled, also returns stats about queued transactions associated with this account.

Can only be used when querying for the data from the current open ledger.

Not available from servers in Reporting Mode.

signer_lists - Boolean

(Optional) If true, and the MultiSign amendment is enabled, also returns any SignerList objects associated with this account.

strict - Boolean

(Optional) If true, then the account field only accepts a public key or XRP Ledger address.

Otherwise, account can be a secret or passphrase (not recommended).

The default is false.

Request

curl --location --request POST 'https://xrp.getblock.io/mainnet/' 
--header 'x-api-key: YOUR-API-KEY' 
--header 'Content-Type: application/json' 
--data-raw '{"jsonrpc": "2.0",
"method": "account_info",
"params": [{"account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH"}],
"id": "getblock.io"}'


Response

{
    "result": {
        "account_data": {
            "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "Balance": "1050862988",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "7DCDDEAA9774AC855056A9F59B11BCD3F8614F9E8DCE0169A276900A7F849106",
            "PreviousTxnLgrSeq": 61168087,
            "Sequence": 45,
            "index": "B1CB040A17F9469BC00376EC8719535655824AD16CB5F539DD5765FEA88FDBE3"
        },
        "ledger_current_index": 63631836,
        "status": "success",
        "validated": false
    }
}