Console

POSTaccount_tx

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

Returns the list of validated transactions that involve an account. You can narrow the search by specifying a ledger index range, and paginate with marker.

Request Body
methodstringrequired
accountstringrequired

The account to look up.

ledger_index_mininteger

The ledger index to start searching from. Pass -1 to search from the oldest ledger version the server holds.

ledger_index_maxinteger

The ledger index to stop searching at. Pass -1 to search up to the newest ledger version the server holds.

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.

binaryboolean

Whether to return the transaction and its metadata as hex strings.

forwardboolean

Whether to return the oldest transactions first.

limitinteger

The number of transactions to return.

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.

tx_typestring

The transaction type to return. It is case-insensitive. This parameter is supported only by Clio servers.

Responses
accountstring

The account the request was made from the perspective of.

ledger_index_mininteger

The oldest ledger index actually searched.

ledger_index_maxinteger

The most recent ledger index actually searched.

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.

close_time_isostring

The time the ledger containing the transaction closed, in ISO 8601 format.

hashstring

The unique hash that identifies the transaction.

ledger_hashstring

The hash of the ledger containing the transaction.

ledger_indexinteger

The ledger index of the ledger containing the transaction.

tx_jsonobject

The transaction data. Returned when binary is false.

tx_blobstring

The transaction, hex-encoded. Returned when binary is true.

metaobject

The metadata describing the results of the transaction. Returned when binary is false.

meta_blobstring

The metadata, hex-encoded. Returned when binary is true.

validatedboolean

Whether the transaction is included in a validated ledger version.

validatedboolean

Whether the response was derived from a validated ledger version.

X-API-KEY
RequestCU150
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "account_tx",
  "params": [
    {
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
      "ledger_index_min": -1,
      "ledger_index_max": -1,
      "binary": false,
      "forward": false,
      "limit": 10
    }
  ]
}'
Response
Example · 200
{
  "result": {
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
    "ledger_index_max": 98765432,
    "ledger_index_min": 32570,
    "limit": 10,
    "marker": {
      "ledger": 98765000,
      "seq": 3
    },
    "transactions": [
      {
        "close_time_iso": "2026-09-02T04:00:00Z",
        "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7",
        "ledger_hash": "17ACB57A0F73B5160713E81FE72B2AC9F6064541004E272BD09F257D57C30C02",
        "ledger_index": 98765000,
        "meta": {
          "TransactionIndex": 3,
          "TransactionResult": "tesSUCCESS",
          "delivered_amount": "1000000"
        },
        "tx_json": {
          "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
          "Amount": "1000000",
          "Destination": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
          "Fee": "12",
          "Sequence": 41,
          "TransactionType": "Payment"
        },
        "validated": true
      }
    ],
    "validated": true
  }
}

Last updated