XRP Ledger
App · 19 actions
Read the XRP Ledger through its public servers: account balances and settings, transactions and ledgers, tokens and trust lines, NFTs and their offers, order books, AMM pools, price oracles and network fees, and start workflows when an account transacts or is paid. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Check deposit authorization | Check whether one account may send payments straight to another, which matters when the recipient has turned on deposit authorization. |
| Check rippling settings | Check an account's rippling settings against what a token issuer or a regular holder should have, and get each problem with the transaction that would fix it. |
| Get account | Get an XRP Ledger account's XRP balance, how much of it can be spent after the reserve, its settings (such as whether payments to it need a destination tag), its domain and its last transaction. |
| Get AMM pool | Get the automated market maker (AMM) pool for two currencies: how much of each it holds, the price that implies, its trading fee, LP tokens and auction slot, and the fee votes. |
| Get issued token totals | For a token issuer, get how much of each of its tokens others hold in total, what its hot wallets hold and which balances it has frozen. |
| Get ledger | Get a ledger (the latest validated one, or one by number or hash): when it closed, how many transactions it holds and how much XRP exists, and optionally every transaction in it. |
| Get network status | Get the XRP Ledger's latest validated ledger and how long ago it closed, the base transaction fee, the account reserves and the server's state. |
| Get NFT | Look up one NFT by its id: who holds it now, who minted it, its collection and serial number, its URI, its royalty and whether it has been burned. |
| Get order book | See the offers on the XRP Ledger's decentralized exchange selling one currency for another, best price first: how much each has for sale, what it asks and the price. |
| Get price oracle | Read the prices a price oracle publishes on the XRP Ledger, such as DIA's XRP, BTC, ETH and stablecoin prices in US dollars, and when it last updated them. |
| Get transaction | Look up one transaction by its hash: what it did, the amount delivered, the fee, whether it succeeded, its ledger and date, and how it changed every balance it touched. |
| Get transaction fees | Get what a transaction costs right now: the minimum, median and open ledger fees, and how full the current ledger and the queue are. |
| List account NFTs | List the NFTs an account holds, with each one's issuer, collection (taxon), serial number, URI, royalty and transfer rules. |
| List account objects | List what an account owns on the ledger, such as escrows, payment channels, checks, offers, NFT offers, tickets and trust lines, optionally only one kind. |
| List account offers | List an account's open offers on the XRP Ledger's decentralized exchange: what each sells, what it asks in return and at what price. |
| List account transactions | List an account's validated transactions, newest first, optionally between two dates and of one type: what each did in a sentence, the amount delivered, the fee, the result and any memos. |
| List NFT offers | List the open offers to sell or buy one NFT: who made each, the price, and any expiry or restriction to one buyer. |
| List NFTs by issuer | List the NFTs an account has minted, optionally from one collection (taxon), with who holds each one now. |
| List trust lines | List the tokens an account holds (or, for a token issuer, who holds its tokens): each trust line's token, counterparty, balance and limit, and its freeze and rippling settings. |
Check deposit authorization
Check whether one account may send payments straight to another, which matters when the recipient has turned on deposit authorization.
Inputs
- Sender
source_accounttextRequired - The address that would send. It starts with r.
- Recipient
destination_accounttextRequired - The address that would receive. It starts with r.
Outputs
authorizedtrue/false- True when the sender may pay the recipient directly.
destination_accounttext- The recipient.
ledger_indexnumber- The validated ledger the answer was read from.
source_accounttext- The sender.
Example output
{
"authorized": true,
"destination_account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"ledger_index": 107824513,
"source_account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah"
}Check rippling settings
Check an account's rippling settings against what a token issuer or a regular holder should have, and get each problem with the transaction that would fix it.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- Account is
roletext - What the account is, which decides the right settings.One of:
user(A regular account that holds tokens),gateway(A token issuer). Default:user.
Outputs
accounttext- The account's address.
countnumber- How many problems there are.
ledger_indexnumber- The validated ledger the answer was read from.
problemslist- Each setting that is wrong for the role, as a sentence.
roletext- 'gateway' or 'user', as checked.
suggested_transactionslist- The unsigned transactions that would fix them, one per problem.
Example output
{
"account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
"count": 1,
"ledger_index": 107824513,
"problems": [
"You should immediately set your default ripple flag"
],
"role": "gateway",
"suggested_transactions": [
{
"Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
"Fee": 10,
"Sequence": 288012729,
"SetFlag": 8,
"TransactionType": "AccountSet"
}
]
}Get account
Get an XRP Ledger account's XRP balance, how much of it can be spent after the reserve, its settings (such as whether payments to it need a destination tag), its domain and its last transaction.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
Outputs
accounttext- The account's address.
available_xrpnumber- The XRP it can spend: its balance less the reserve.
balance_dropstext- The same balance in drops (1 XRP is 1,000,000 drops).
balance_xrpnumber- The XRP it holds.
default_rippletrue/false- True when rippling is on by default, as a token issuer needs.
deposit_authtrue/false- True when only accounts it has authorized may pay it.
domaintext- The domain it claims, e.g. 'bitstamp.net'.
explorer_urltext- The account's page on the XRPL Explorer (livenet.xrpl.org).
global_freezetrue/false- True when it has frozen every token it issues.
last_transaction_hashtext- The hash of the last transaction that changed it.
last_transaction_ledgernumber- The ledger of that transaction.
ledger_indexnumber- The validated ledger the answer was read from.
master_key_disabledtrue/false- True when its master key can no longer sign.
minted_nftsnumber- How many NFTs it has minted.
nft_mintertext- The account allowed to mint NFTs for it, if any.
owner_countnumber- How many objects it owns (trust lines, offers, NFT pages...).
regular_keytext- The address of the second key that can sign for it, if any.
requires_destination_tagtrue/false- True when payments to it must carry a destination tag.
reserve_xrpnumber- The XRP it must keep and can't spend: the base reserve plus a reserve for each object it owns.
sequencenumber- The sequence number its next transaction must use.
settingslist- Every setting turned on, in words, e.g. 'Requires a destination tag'.
tick_sizenumber- For an issuer, the significant digits its exchange rates keep.
transfer_fee_percentnumber- For an issuer, the fee it charges when its tokens change hands, in percent.
Example output
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"available_xrp": 412525.891965,
"balance_drops": "412602491965",
"balance_xrp": 412602.491965,
"default_ripple": true,
"deposit_auth": false,
"domain": "bitstamp.net",
"explorer_url": "https://livenet.xrpl.org/accounts/rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"global_freeze": false,
"last_transaction_hash": "905E3E0E0F2A7FE59F8C442312ADFC826B3C7E1DF787B922B1D8231716F9CEC9",
"last_transaction_ledger": 107824367,
"ledger_index": 107824506,
"master_key_disabled": true,
"minted_nfts": 0,
"nft_minter": null,
"owner_count": 378,
"regular_key": "rUUs1jns6tdUQwAABDJyHMUHvdGNvNADvJ",
"requires_destination_tag": true,
"reserve_xrp": 76.6,
"sequence": 4827,
"settings": [
"Requires a destination tag",
"Asks not to be sent XRP",
"Master key disabled",
"Rippling on by default"
],
"tick_size": null,
"transfer_fee_percent": 0.15
}Get AMM pool
Get the automated market maker (AMM) pool for two currencies: how much of each it holds, the price that implies, its trading fee, LP tokens and auction slot, and the fee votes.
Inputs
- First currency
asset1textRequired - One of the pool's currencies. XRP, or a token as CODE:ISSUER (its code and the address that issues it), e.g. RLUSD:rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De.
- Second currency
asset2textRequired - The pool's other currency. XRP, or a token as CODE:ISSUER (its code and the address that issues it), e.g. RLUSD:rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De.
Outputs
amm_accounttext- The pool's own address.
asset1object- How much of the first currency the pool holds.
asset1_frozentrue/false- True when the first currency is frozen.
asset2object- How much of the second currency the pool holds.
asset2_frozentrue/false- True when the second currency is frozen.
auction_slot_expires_attext- When the slot expires, ISO 8601 in UTC.
auction_slot_fee_percentnumber- The slot holder's discounted fee, in percent.
auction_slot_holdertext- Who holds the auction slot, which trades at a discount.
ledger_indexnumber- The validated ledger the answer was read from.
lp_tokenobject- The LP tokens in issue, which liquidity providers hold.
pricenumber- The pool's price: second currency per one unit of the first.
trading_fee_percentnumber- The fee a trade against the pool pays, in percent.
voteslist- The liquidity providers' votes on the trading fee.
Example output
{
"amm_account": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
"asset1": {
"currency": "XRP",
"drops": "1832611425719",
"issuer": null,
"mpt_issuance_id": null,
"value": 1832611.425719
},
"asset1_frozen": false,
"asset2": {
"currency": "RLUSD",
"drops": null,
"issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
"mpt_issuance_id": null,
"value": 2431373.099831653
},
"asset2_frozen": false,
"auction_slot_expires_at": "2026-03-02T17:05:00Z",
"auction_slot_fee_percent": 0.02,
"auction_slot_holder": "r4uKh2rHuarMZdAgSBYqqicX7MxPBegttw",
"ledger_index": 107824512,
"lp_token": {
"currency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
"drops": null,
"issuer": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
"mpt_issuance_id": null,
"value": 1788142326.731384
},
"price": 1.3267259309363615,
"trading_fee_percent": 0.205,
"votes": [
{
"account": "rJ4XeEzorvsQp6un4h9CjtANEsB3Qcc8iA",
"trading_fee_percent": 0.3,
"vote_weight": 2936.0
}
]
}Get issued token totals
For a token issuer, get how much of each of its tokens others hold in total, what its hot wallets hold and which balances it has frozen.
Inputs
- Account
accounttextRequired - The token issuer's address. It starts with r.
- Hot wallets
hot_walletstext - The issuer's own operational addresses, separated by commas, so their holdings are counted apart. Leave empty if it has none.
Outputs
accounttext- The account's address.
assetslist- Tokens of other issuers it holds itself.
frozen_balanceslist- Balances of its tokens it has frozen.
hot_wallet_balanceslist- What each hot wallet you named holds of its tokens.
ledger_indexnumber- The validated ledger the answer was read from.
obligationslist- Each token it issues, with the total held by others (less its hot wallets).
Example output
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"assets": [],
"frozen_balances": [
{
"account": "rEDtyWDqWs9q1aZY82bjoetpADy7iviqhz",
"currency": "BTC",
"value": 12.31459690692563
}
],
"hot_wallet_balances": [],
"ledger_index": 107824511,
"obligations": [
{
"currency": "AUD",
"value": 8692.124775162521
}
]
}Get ledger
Get a ledger (the latest validated one, or one by number or hash): when it closed, how many transactions it holds and how much XRP exists, and optionally every transaction in it.
Inputs
- Ledger
ledgertext - A ledger number or hash. Leave empty for the latest validated ledger.
- Include transactions
include_transactionstrue/false - Also list every transaction in the ledger.Default:
false.
Outputs
close_timetext- When it closed, ISO 8601 in UTC.
ledger_hashtext- The ledger's hash.
ledger_indexnumber- The ledger's number.
parent_hashtext- The previous ledger's hash.
total_dropstext- The same in drops.
total_xrpnumber- All the XRP in existence after it (fees destroy a little each ledger).
transaction_countnumber- How many transactions it holds.
transactionslist- Its transactions, when 'Include transactions' is on.
validatedtrue/false- True when it is validated, so final.
Example output
{
"close_time": "2026-10-21T16:58:11Z",
"ledger_hash": "041DCA2A520CE9463EC2BA3022EE93FACB849594327F6D03D19651B17D1AE51E",
"ledger_index": 107809419,
"parent_hash": "A1E921CD10912039776979968F2186A4D82C6E99227EF4F7325DDF3E41973861",
"total_drops": "99985587574707208",
"total_xrp": 99985587574.70721,
"transaction_count": 48,
"transactions": [
{
"account": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb",
"amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"date": "2026-10-21T16:58:11Z",
"delivered_amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"destination": "rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"destination_tag": null,
"fee_drops": "15",
"fee_xrp": 1.5e-05,
"hash": "6ADD48260EC9852804850AF878E848A3C30F7F9CC902D8433294F93343F084B6",
"ledger_index": 107809419,
"memos": [
"Horizon Booster Fee"
],
"result": "tesSUCCESS",
"sequence": 107881796,
"source_tag": 222,
"succeeded": true,
"summary": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb paid 0.000502 XRP to rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"type": "Payment"
}
],
"validated": true
}Get network status
Get the XRP Ledger's latest validated ledger and how long ago it closed, the base transaction fee, the account reserves and the server's state.
Inputs
None.
Outputs
available_ledgerstext- The ledgers the server holds, e.g. '32570-107824513'.
base_fee_xrpnumber- The fee a plain transaction pays when the network is quiet, in XRP.
base_reserve_xrpnumber- The XRP every account must keep, at least.
ledger_age_secondsnumber- How many seconds ago it closed.
ledger_hashtext- Its hash.
ledger_indexnumber- The latest validated ledger.
load_factornumber- How busy the server is: 1 is normal; fees rise with it.
network_idnumber- The network: 0 is the XRP Ledger mainnet.
owner_reserve_xrpnumber- The extra XRP an account keeps for each object it owns.
server_statetext- The server's state, 'full' when in step with the network.
server_timetext- The server's clock, ISO 8601 in UTC.
server_versiontext- The server software's version.
Example output
{
"available_ledgers": "32570-107824513",
"base_fee_xrp": 1e-05,
"base_reserve_xrp": 1.0,
"ledger_age_seconds": 0,
"ledger_hash": "8F983A16C09B4BC0438D9DD18206FC8CA58D9ADDB4EFAAE48D1C727C5490D07C",
"ledger_index": 107824513,
"load_factor": 1.0,
"network_id": 0,
"owner_reserve_xrp": 0.2,
"server_state": "full",
"server_time": "2026-10-22T09:30:30Z",
"server_version": "3.4.1"
}Get NFT
Look up one NFT by its id: who holds it now, who minted it, its collection and serial number, its URI, its royalty and whether it has been burned.
Inputs
- NFT ID
nft_idtextRequired - The NFT's 64-character id. List account NFTs shows them.
Outputs
burnabletrue/false- True when the issuer may burn (destroy) it.
is_burnedtrue/false- True when it has been burned.
issuertext- The account that minted it.
ledger_indexnumber- The validated ledger the answer was read from.
mutabletrue/false- True when the issuer may change its URI.
nft_idtext- The NFT's id.
only_xrptrue/false- True when it can only be bought and sold for XRP.
ownertext- The account that holds it now.
serialnumber- Its serial number among the issuer's NFTs.
taxonnumber- The issuer's collection number for it.
transfer_fee_percentnumber- The royalty the issuer takes on each resale, in percent.
transferabletrue/false- True when holders other than the issuer may sell it on.
uritext- Its URI (usually where its metadata or image is), decoded.
Example output
{
"burnable": false,
"is_burned": false,
"issuer": "rpbjkoncKiv1LkPWShzZksqYPzKXmUhTW7",
"ledger_index": 107772627,
"mutable": false,
"nft_id": "00081B581189F5687DBB7516339D6CCB5593D96622AD82DF536971BA000004F3",
"only_xrp": false,
"owner": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"serial": 1267,
"taxon": 52,
"transfer_fee_percent": 7.0,
"transferable": true,
"uri": null
}Get order book
See the offers on the XRP Ledger's decentralized exchange selling one currency for another, best price first: how much each has for sale, what it asks and the price.
Inputs
- Buy
buytextRequired - The currency you want to buy. XRP, or a token as CODE:ISSUER (its code and the address that issues it), e.g. RLUSD:rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De.
- Pay with
pay_withtextRequired - The currency you would pay. XRP, or a token as CODE:ISSUER (its code and the address that issues it), e.g. RLUSD:rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De.
- Number of results
limitnumber - How many offers to return, 1 to 100. Defaults to 20.From 1 to 100.
Outputs
best_pricenumber- The best (lowest) price on offer. Empty when nobody is selling.
buytext- The currency bought, as given.
countnumber- How many offers came back.
ledger_indexnumber- The validated ledger the answer was read from.
offerslist- The offers, best price first.
pay_withtext- The currency paid, as given.
Example output
{
"best_price": 1.3262897932544577,
"buy": "XRP",
"count": 1,
"ledger_index": 107824512,
"offers": [
{
"expires_at": null,
"offer_id": "23E5AAC9AF93F119EDA3C693CAC23123879A5DD806DF87BC0BED975A222CBA4E",
"owner": "rrhXifoGRLKEfjkjBA9QM6x9MGfJVLDy5p",
"price": 1.3262897932544577,
"sells": {
"currency": "XRP",
"drops": "552976",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.552976
},
"sequence": 104768170,
"wants": {
"currency": "RLUSD",
"drops": null,
"issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
"mpt_issuance_id": null,
"value": 0.733406424714677
}
}
],
"pay_with": "RLUSD:rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De"
}Get price oracle
Read the prices a price oracle publishes on the XRP Ledger, such as DIA's XRP, BTC, ETH and stablecoin prices in US dollars, and when it last updated them.
Inputs
- Account
accounttextRequired - The address that publishes the oracle. It starts with r.
- Document ID
document_idnumberRequired - The oracle's document id on that account (DIA's is 42).From 0 to 4294967295.
Outputs
accounttext- The account's address.
asset_classtext- What it prices, e.g. 'currency'.
countnumber- How many prices it publishes.
document_idnumber- The oracle's document id on that account.
last_updatedtext- When it last updated, ISO 8601 in UTC.
ledger_indexnumber- The validated ledger the answer was read from.
priceslist- Each price it publishes.
providertext- Who provides the prices, e.g. 'diadata'.
uritext- A link the oracle gives for more about it.
Example output
{
"account": "rP24Lp7bcUHvEW7T7c8xkxtQKKd9fZyra7",
"asset_class": "currency",
"count": 1,
"document_id": 42,
"last_updated": "2026-10-22T09:06:38Z",
"ledger_index": 107824513,
"prices": [
{
"base": "XRP",
"price": 1.32554817,
"quote": "USD",
"scale": 8
}
],
"provider": "diadata",
"uri": null
}Get transaction
Look up one transaction by its hash: what it did, the amount delivered, the fee, whether it succeeded, its ledger and date, and how it changed every balance it touched.
Inputs
- Transaction hash
transactiontextRequired - The transaction's 64-character hash (or its 16-character CTID, starting with C).
Outputs
accounttext- The address that sent (signed) the transaction.
amountobject- The amount it names: what a payment sends, an escrow or channel holds, a check allows or an NFT offer asks.
balance_changeslist- Every balance it changed, one row per account and currency.
datetext- When that ledger closed, ISO 8601 in UTC.
delivered_amountobject- For a payment that succeeded, what actually arrived. Use this rather than the amount: a partial payment can deliver less.
destinationtext- The address it was sent to, for payments, checks and escrows.
destination_tagnumber- The destination tag: the number an exchange or service uses to tell its customers apart.
explorer_urltext- The transaction's page on the XRPL Explorer.
fee_dropstext- The fee paid, in drops.
fee_xrpnumber- The fee paid, in XRP.
hashtext- The transaction's hash, its id.
ledger_indexnumber- The ledger it was validated in.
memoslist- The text of each memo attached, decoded (hex when not text).
resulttext- The result code: 'tesSUCCESS' when it succeeded, else a code such as 'tecPATH_DRY'.
sequencenumber- The sender's sequence number it used.
source_tagnumber- The source tag the sender set, if any.
succeededtrue/false- True when the result is tesSUCCESS.
summarytext- What it did, in a sentence, e.g. 'rA... paid 25 XRP to rB...'.
typetext- The kind of transaction, e.g. 'Payment', 'OfferCreate' or 'TrustSet'.
validatedtrue/false- True when it is in a validated ledger, so final.
Example output
{
"account": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb",
"amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"balance_changes": [
{
"account": "rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"change": 0.000502,
"currency": "XRP",
"issuer": null
},
{
"account": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb",
"change": -0.000517,
"currency": "XRP",
"issuer": null
}
],
"date": "2026-10-21T16:58:11Z",
"delivered_amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"destination": "rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"destination_tag": null,
"explorer_url": "https://livenet.xrpl.org/transactions/6ADD48260EC9852804850AF878E848A3C30F7F9CC902D8433294F93343F084B6",
"fee_drops": "15",
"fee_xrp": 1.5e-05,
"hash": "6ADD48260EC9852804850AF878E848A3C30F7F9CC902D8433294F93343F084B6",
"ledger_index": 107809419,
"memos": [
"Horizon Booster Fee"
],
"result": "tesSUCCESS",
"sequence": 107881796,
"source_tag": 222,
"succeeded": true,
"summary": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb paid 0.000502 XRP to rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"type": "Payment",
"validated": true
}Get transaction fees
Get what a transaction costs right now: the minimum, median and open ledger fees, and how full the current ledger and the queue are.
Inputs
None.
Outputs
base_fee_dropsnumber- The reference fee of a plain transaction, in drops.
current_ledger_sizenumber- How many transactions the open ledger holds so far.
current_queue_sizenumber- How many transactions are queued for later ledgers.
expected_ledger_sizenumber- How many it takes before fees start to rise.
ledger_current_indexnumber- The ledger now open.
max_queue_sizenumber- How many the queue can hold.
median_fee_dropsnumber- The median fee of transactions in the queue, in drops.
minimum_fee_dropsnumber- The least a transaction can pay to be queued, in drops.
open_ledger_fee_dropsnumber- What a transaction pays to get into the next ledger now, in drops.
open_ledger_fee_xrpnumber- The same in XRP.
Example output
{
"base_fee_drops": 10,
"current_ledger_size": 63,
"current_queue_size": 0,
"expected_ledger_size": 260,
"ledger_current_index": 107824514,
"max_queue_size": 5200,
"median_fee_drops": 5000,
"minimum_fee_drops": 10,
"open_ledger_fee_drops": 10,
"open_ledger_fee_xrp": 1e-05
}List account NFTs
List the NFTs an account holds, with each one's issuer, collection (taxon), serial number, URI, royalty and transfer rules.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- Number of results
limitnumber - How many NFTs to return, 1 to 400. Defaults to 50.From 1 to 400.
Outputs
accounttext- The account's address.
countnumber- How many NFTs came back.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
ledger_indexnumber- The validated ledger the answer was read from.
nftslist- The NFTs.
Example output
{
"account": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"count": 1,
"has_more": true,
"ledger_index": 107824511,
"nfts": [
{
"burnable": false,
"issuer": "rpbjkoncKiv1LkPWShzZksqYPzKXmUhTW7",
"mutable": false,
"nft_id": "00081B581189F5687DBB7516339D6CCB5593D96622AD82DF536971BA000004F3",
"only_xrp": false,
"serial": 1267,
"taxon": 52,
"transfer_fee_percent": 7.0,
"transferable": true,
"uri": null
}
]
}List account objects
List what an account owns on the ledger, such as escrows, payment channels, checks, offers, NFT offers, tickets and trust lines, optionally only one kind.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- Kind of object
object_typetext - Only this kind of object. Leave empty for every kind.One of:
state(Trust lines),offer(Offers on the exchange),escrow(Escrows),payment_channel(Payment channels),check(Checks),nft_offer(NFT offers),nft_page(NFT pages (where NFTs are held)),ticket(Tickets),signer_list(Multi-signing lists),deposit_preauth(Deposit preauthorizations), and 7 more. - Number of results
limitnumber - How many objects to return, 1 to 400. Defaults to 50.From 1 to 400.
Outputs
accounttext- The account's address.
countnumber- How many objects came back.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
ledger_indexnumber- The validated ledger the answer was read from.
objectslist- The objects.
Example output
{
"account": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"count": 1,
"has_more": true,
"ledger_index": 107824511,
"objects": [
{
"account": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"amount": {
"currency": "XRP",
"drops": "9840000",
"issuer": null,
"mpt_issuance_id": null,
"value": 9.84
},
"destination": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC",
"expires_at": null,
"fields": {
"Amount": "9840000",
"Destination": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC",
"Flags": 1,
"LedgerEntryType": "NFTokenOffer",
"NFTokenID": "00081B58AED7E25A9085DF5E80EA66DD1E058557537FC91CF8D4BC5305A9C183",
"NFTokenOfferNode": "0",
"Owner": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"OwnerNode": "7db",
"PreviousTxnID": "D26E6D44E3CBD55451D95B063C4DF4E60FFAF90CEFBFF7A0C0405EB261998656",
"PreviousTxnLgrSeq": 107384275,
"index": "2EC532DD8D9D901C424A5673B7EEA88DD5045605C70098143AB90F777A7CD45A"
},
"finish_after": null,
"id": "2EC532DD8D9D901C424A5673B7EEA88DD5045605C70098143AB90F777A7CD45A",
"last_changed_by_tx": "D26E6D44E3CBD55451D95B063C4DF4E60FFAF90CEFBFF7A0C0405EB261998656",
"last_changed_in_ledger": 107384275,
"nft_id": "00081B58AED7E25A9085DF5E80EA66DD1E058557537FC91CF8D4BC5305A9C183",
"type": "NFTokenOffer"
}
]
}List account offers
List an account's open offers on the XRP Ledger's decentralized exchange: what each sells, what it asks in return and at what price.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- Number of results
limitnumber - How many offers to return, 1 to 400. Defaults to 50.From 1 to 400.
Outputs
accounttext- The account's address.
countnumber- How many offers came back.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
ledger_indexnumber- The validated ledger the answer was read from.
offerslist- The offers.
Example output
{
"account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
"count": 1,
"has_more": true,
"ledger_index": 107824511,
"offers": [
{
"expires_at": null,
"passive": false,
"price": 1.35482606,
"sell": false,
"sells": {
"currency": "XRP",
"drops": "12791000000",
"issuer": null,
"mpt_issuance_id": null,
"value": 12791.0
},
"sequence": 288012689,
"wants": {
"currency": "USDC",
"drops": null,
"issuer": "rcEGREd8NmkKRE8GE424sksyt1tJVFZwu",
"mpt_issuance_id": null,
"value": 17329.58013346
}
}
]
}List account transactions
List an account's validated transactions, newest first, optionally between two dates and of one type: what each did in a sentence, the amount delivered, the fee, the result and any memos.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- From
start_timedate and time - Only transactions from this date and time on.
- Until
end_timedate and time - Only transactions up to this date and time.
- Transaction type
transaction_typetext - Only this kind of transaction, e.g. Payment. Leave empty for every kind.
- Oldest first
oldest_firsttrue/false - List the oldest transactions first instead of the newest.Default:
false. - Number of results
limitnumber - How many transactions to return, 1 to 200. Defaults to 20.From 1 to 200.
Outputs
accounttext- The account's address.
countnumber- How many transactions came back.
from_ledgernumber- The first ledger searched.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
to_ledgernumber- The last ledger searched.
transactionslist- The transactions.
Example output
{
"account": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb",
"count": 1,
"from_ledger": 32570,
"has_more": true,
"to_ledger": 107824540,
"transactions": [
{
"account": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb",
"amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"date": "2026-10-21T16:58:11Z",
"delivered_amount": {
"currency": "XRP",
"drops": "502",
"issuer": null,
"mpt_issuance_id": null,
"value": 0.000502
},
"destination": "rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"destination_tag": null,
"direction": "sent",
"fee_drops": "15",
"fee_xrp": 1.5e-05,
"hash": "6ADD48260EC9852804850AF878E848A3C30F7F9CC902D8433294F93343F084B6",
"ledger_index": 107809419,
"memos": [
"Horizon Booster Fee"
],
"result": "tesSUCCESS",
"sequence": 107881796,
"source_tag": 222,
"succeeded": true,
"summary": "rMPVQkxnn6mjZLMJBJ5QHyBrhe4Hs8kefb paid 0.000502 XRP to rFEEzdpY6c3GuWhLHjsvfBLUghS7cGoi3",
"type": "Payment"
}
]
}List NFT offers
List the open offers to sell or buy one NFT: who made each, the price, and any expiry or restriction to one buyer.
Inputs
- NFT ID
nft_idtextRequired - The NFT's 64-character id. List account NFTs shows them.
- Offers
sidetext - Which offers to list.One of:
both(Sell and buy offers),sell(Sell offers only),buy(Buy offers only). Default:both.
Outputs
buy_countnumber- How many are buy offers.
countnumber- How many offers came back.
nft_idtext- The NFT.
offerslist- The open offers, sell offers first.
sell_countnumber- How many are sell offers.
Example output
{
"buy_count": 0,
"count": 1,
"nft_id": "00081B581189F5687DBB7516339D6CCB5593D96622AD82DF536971BA000004F3",
"offers": [
{
"amount": {
"currency": "XRP",
"drops": "99999000",
"issuer": null,
"mpt_issuance_id": null,
"value": 99.999
},
"destination": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC",
"expires_at": null,
"offer_id": "A90541F36EBE07DD65A400A30ED12ED9E41A21BD0A003D5DC48CC1318DA18F2A",
"owner": "rnHeqy9a1MxQJEYbGBXYNDosZRU7qySsAV",
"side": "sell"
}
],
"sell_count": 1
}List NFTs by issuer
List the NFTs an account has minted, optionally from one collection (taxon), with who holds each one now.
Inputs
- Issuer
issuertextRequired - The address that minted the NFTs. It starts with r.
- Collection (taxon)
taxonnumber - Only NFTs with this taxon, the number an issuer gives a collection. Leave empty for all.From 0 to 4294967295.
- Number of results
limitnumber - How many NFTs to return, 1 to 400. Defaults to 50.From 1 to 400.
Outputs
countnumber- How many NFTs came back.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
issuertext- The issuer's address.
ledger_indexnumber- The validated ledger the answer was read from.
nftslist- The NFTs.
Example output
{
"count": 1,
"has_more": true,
"issuer": "rpbjkoncKiv1LkPWShzZksqYPzKXmUhTW7",
"ledger_index": 107824512,
"nfts": [
{
"burnable": false,
"is_burned": false,
"issuer": "rpbjkoncKiv1LkPWShzZksqYPzKXmUhTW7",
"mutable": false,
"nft_id": "00081B581189F5687DBB7516339D6CCB5593D96622AD82DF000009AF00000000",
"only_xrp": false,
"owner": "r4FtLE72BbhXHbssj6fCGWASe4U8AMEjca",
"serial": 0,
"taxon": 52,
"transfer_fee_percent": 7.0,
"transferable": true,
"uri": null
}
]
}List trust lines
List the tokens an account holds (or, for a token issuer, who holds its tokens): each trust line's token, counterparty, balance and limit, and its freeze and rippling settings.
Inputs
- Account
accounttextRequired - The account's address. It starts with r.
- Counterparty
counterpartytext - Only the line with this account, e.g. one token's issuer. Leave empty for every line.
- Number of results
limitnumber - How many trust lines to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Outputs
accounttext- The account's address.
countnumber- How many trust lines came back.
has_moretrue/false- True when there are more than came back. Raise 'Number of results' to see more.
ledger_indexnumber- The validated ledger the answer was read from.
lineslist- The trust lines.
Example output
{
"account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"count": 1,
"has_more": true,
"ledger_index": 107824506,
"lines": [
{
"authorized": false,
"balance": 0.0,
"counterparty": "rKUK9omZqVEnraCipKNFb5q4tuNTeqEDZS",
"counterparty_authorized": false,
"counterparty_frozen": false,
"counterparty_limit": 10.0,
"counterparty_no_ripple": false,
"currency": "BTC",
"frozen": false,
"limit": 0.0,
"no_ripple": false
}
]
}