Skip to main content

account_lines RPC Method

Retrieves information about trust lines associated with an XRP Ledger account, including the balances in all non-XRP currencies and assets

Updated on
Oct 4, 2023

account_lines RPC Method

Parameters

account
string
The XRP Ledger account for which trust line information is to be retrieved
ledger_index
string
The ledger index to retrieve the information from
ledger_hash
string
The hash of the ledger containing the information
peer
string
The address of second account. If provided, it only show lines of trust connecting the two accounts
limit
string
Limit the number of trust lines to retrieve
marker
string
The value from a previous paginated response

Returns

result
object
The method returns a JSON object with the following properties:
account
string
The XRP Ledger account
ledger_hash
string
The hash of the ledger containing the trust line information
ledger_index
integer
The index of the ledger containing the trust line information
limit
integer
The maximum number of trust lines returned
lines
array
A list of trust lines associated with the account
account
string
The account associated with the trust line
balance
string
The balance held against the trust line
currency
string
The trusted currency
limit
string
The maximum amount of the given currency that this account is willing to owe the peer account
limit_peer
string
The maximum amount of currency that the counterparty account is willing to owe the perspective account
quality_in
integer
The rate at which the account values incoming balances on this trust line, as a ratio of this value per 1 billion units, with 0 treated as a 1:1 ratio
quality_out
integer
The ratio at which the account values outgoing balances on this trust line, measured in units per 1 billion units
validated
boolean
Indicates if the information is from a validated ledger
status
string
The status of the request
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_lines",
6
	"params": [{
7
        "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
8
    }],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free