account_objects RPC Method

For a higher-level view specifically focused on an account's trust lines and balances, it is recommended to use the account_lines method.

Parameters

account

string

REQUIRED

The XRP Ledger account for which objects are to be retrieved

ledger_index

string

The ledger index to query the objects from

ledger_hash

string

The ledger hash to query the objects from

type

string

Filters the returned objects by type

deletion_blockers_only

boolean

A boolean object that specifies whether to only include objects that are preventing the account from being deleted

marker

integer

The value from a previous paginated response

limit

integer

Limits the number of objects returned

Returns

result

object

The method returns a JSON object with the following properties:

account

string

The XRP Ledger account

account_objects

array

A list of account objects owned by the account

ledger_hash

string

The hash of the ledger containing the objects

ledger_index

integer

The index of the ledger containing the objects

validated

boolean

A boolean flag ndicating if the information is from a validated ledger

status

string

The status of the request

marker

string

The value from a previous paginated response

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 '{
5
    "method": "account_objects",
6
	"params": [{
7
        "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
8
        "ledger_index": "validated",
9
        "type": "state",
10
        "deletion_blockers_only": false,
11
        "limit": 10
12
    }],"id":1,"jsonrpc":"2.0"}'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free