account_lines - XRPL

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

This method returns information about an account's trust lines, which track balances of issued currencies.

Parameters

Parameter	Type	Required	Description
account	string	Yes	Account address
peer	string	No	Filter by counterparty
ledger_hash	string	No	Ledger hash
ledger_index	string/number	No	Ledger index or shortcut
limit	number	No	Maximum results
marker	object	No	Pagination marker

Request Examples

cURL

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

JavaScript (Axios)

Python

Rust

Response Example

{
    "result": {
        "account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
        "ledger_current_index": 63631836,
        "lines": [
            {
                "account": "rrh7rf1gV2pXAoqA8oYbpHd8TKv5ZQeo67",
                "balance": "100",
                "currency": "USD",
                "limit": "1000",
                "limit_peer": "0",
                "no_ripple": true
            }
        ],
        "status": "success"
    }
}

Response Parameters

Parameter	Type	Description
account	string	Counterparty address
balance	string	Current balance
currency	string	Currency code
limit	string	Trust limit
ledger_current_index	integer	Current ledger index

Use Cases

• View token balances

• Check trust line settings

• Monitor issued currencies

Error Handling

Error Code	Description
actNotFound	Account not found
invalidParams	Invalid parameters

SDK Integration

xrpl.js

xrpl.js example

const xrpl = require('xrpl');

async function getLines() {
    const client = new xrpl.Client('wss://xrplcluster.com');
    await client.connect();
    
    const response = await client.request({
        command: 'account_lines',
        account: 'rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH'
    });
    
    response.result.lines.forEach(line => {
        console.log(`${line.currency}: ${line.balance}`);
    });
    
    await client.disconnect();
}

getLines();

xrpl-py