Console

POSTaccount_objects

XRP Ledger Mainnethttps://xrpl-mainnet.nodit.io/

Returns the ledger entries owned by an account in their raw format. It lets you inspect the objects associated with the account by type, such as offers, trust lines, Escrows and Checks.

Request Body
methodstringrequired
accountstringrequired

The account to look up.

typestring

The ledger entry type to return. Both canonical and short names can be used. (e.g.) offer, state, escrow, check, payment_channel, signer_list, ticket, nft_offer

deletion_blockers_onlyboolean

Whether to return only the entries that block account deletion.

limitinteger

The number of entries to return. Pass a value between 10 and 400.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

ledger_hashstring

The hash of the ledger version to use. Pass a 32-byte hex string.

ledger_indexinteger

Specifies the ledger version to use. Pass a ledger index as an integer, or use one of the shortcut strings below.

  • validated: Uses the most recent ledger version validated by the network.
  • closed: Uses the most recent ledger version the server has closed. It may not be validated.
  • current: Uses the in-progress ledger version the server is currently building.

The ledger index of the version to use.

Responses
accountstring

The account the request was made from the perspective of.

LedgerEntryTypestring

The type of the ledger entry.

indexstring

The ID that identifies the ledger entry.

PreviousTxnIDstring

The ID of the transaction that most recently modified this entry.

PreviousTxnLgrSeqinteger

The ledger index of the ledger containing the transaction that most recently modified this entry.

limitinteger

The limit value used in the request.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

ledger_hashstring

The hash of the ledger version used. Returned when a validated ledger version was queried.

ledger_indexinteger

The ledger index of the version used. Returned when a validated ledger version was queried.

ledger_current_indexinteger

The ledger index of the in-progress ledger. Returned when the current ledger was queried.

validatedboolean

Whether the response was derived from a validated ledger version.

X-API-KEY
RequestCU50
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "account_objects",
  "params": [
    {
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
      "ledger_index": "validated",
      "limit": 200
    }
  ]
}'
Response
Example · 200
{
  "result": {
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
    "account_objects": [
      {
        "LedgerEntryType": "Offer",
        "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
        "Flags": 0,
        "Sequence": 40,
        "PreviousTxnID": "6A8C0E2D4F6B8A0C1E3D5F7A9B0C2E4D6F8A0B1C3E5D7F9A0B2C4E6D8F0A1B3C",
        "PreviousTxnLgrSeq": 98764000,
        "index": "7B9D0F2A4C6E8B0D1F3A5C7E9B0D2F4A6C8E0B1D3F5A7C9E0B2D4F6A8C0E1B3D"
      }
    ],
    "ledger_hash": "17ACB57A0F73B5160713E81FE72B2AC9F6064541004E272BD09F257D57C30C02",
    "ledger_index": 98765432,
    "validated": true
  }
}

Last updated