account_tx - XRPL

Example code for the account_tx JSON RPC method. Complete guide to using account_tx JSON-RPC in the GetBlock Web3 documentation.

This method retrieves a list of transactions that involved the specified account.

Parameters

Parameter

Type

Required

Description

account

string

Yes

Account address

ledger_index_min

number

Earliest ledger

ledger_index_max

number

Latest ledger

binary

boolean

Return binary format

forward

boolean

Sort oldest first

limit

number

Maximum results

marker

object

Pagination marker

Request Example

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_tx",
    "params": [{
        "account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
        "limit": 10
    }],
    "id": "getblock.io"
}'

example.js

const axios = require('axios');

const url = 'https://xrp.getblock.io/mainnet/';
const headers = {
    'x-api-key': 'YOUR-API-KEY',
    'Content-Type': 'application/json'
};

const payload = {
    jsonrpc: '2.0',
    method: 'account_tx',
    params: [{
        account: 'rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH',
        limit: 10
    }],
    id: 'getblock.io'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));

example.py

import requests

url = "https://xrp.getblock.io/mainnet/"
headers = {
    "x-api-key": "YOUR-API-KEY",
    "Content-Type": "application/json"
}

payload = {
    "jsonrpc": "2.0",
    "method": "account_tx",
    "params": [{
        "account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
        "limit": 10
    }],
    "id": "getblock.io"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

main.rs

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    
    let payload = json!({
        "jsonrpc": "2.0",
        "method": "account_tx",
        "params": [{
            "account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "limit": 10
        }],
        "id": "getblock.io"
    });

    let response = client
        .post("https://xrp.getblock.io/mainnet/")
        .header("x-api-key", "YOUR-API-KEY")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);
    
    Ok(())
}

Response Example

{
    "result": {
        "account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
        "ledger_index_max": 102053170,
        "ledger_index_min": 100807399,
        "limit": 10,
        "status": "success",
        "transactions": [],
        "validated": true
    }
}

Response Parameters

Parameter

Type

Description

transactions

array

Transaction list

object

Transaction data

Use Cases

Build transaction history
Track payments
Monitor account activity

Error Handling

Error Code

Description

actNotFound

Account not found

invalidParams

Invalid parameters

SDK Integration

xrpl.js example

const xrpl = require('xrpl');

async function getTx() {
    const client = new xrpl.Client('wss://xrplcluster.com');
    await client.connect();
    
    const response = await client.request({
        command: 'account_tx',
        account: 'rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH',
        limit: 10
    });
    
    console.log('Transactions:', response.result.transactions.length);
    await client.disconnect();
}

getTx();

xrpl-py example

from xrpl.clients import JsonRpcClient
from xrpl.models.requests import AccountTx

client = JsonRpcClient("https://xrp.getblock.io/mainnet/")
request = AccountTx(account="rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH", limit=10)
response = client.request(request)
print(response.result)

Previousaccount_objects - XRPL Nextpath_find - XRPL

Last updated 5 days ago

Was this helpful?

hashtagParameters

hashtagRequest Example

hashtagResponse Example

hashtagResponse Parameters

hashtagUse Cases

hashtagError Handling

hashtagSDK Integration

Parameters

Request Example

Response Example

Response Parameters

Use Cases

Error Handling

SDK Integration