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

ActionWhat it does
Check deposit authorizationCheck whether one account may send payments straight to another, which matters when the recipient has turned on deposit authorization.
Check rippling settingsCheck 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 accountGet 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 poolGet 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 totalsFor 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 ledgerGet 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 statusGet 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 NFTLook 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 bookSee 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 oracleRead 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 transactionLook 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 feesGet 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 NFTsList the NFTs an account holds, with each one's issuer, collection (taxon), serial number, URI, royalty and transfer rules.
List account objectsList 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 offersList 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 transactionsList 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 offersList 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 issuerList the NFTs an account has minted, optionally from one collection (taxon), with who holds each one now.
List trust linesList 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

Sendersource_accounttextRequired
The address that would send. It starts with r.
Recipientdestination_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

AccountaccounttextRequired
The account's address. It starts with r.
Account isroletext
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

AccountaccounttextRequired
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 currencyasset1textRequired
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 currencyasset2textRequired
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

AccountaccounttextRequired
The token issuer's address. It starts with r.
Hot walletshot_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

Ledgerledgertext
A ledger number or hash. Leave empty for the latest validated ledger.
Include transactionsinclude_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 IDnft_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

BuybuytextRequired
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 withpay_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 resultslimitnumber
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

AccountaccounttextRequired
The address that publishes the oracle. It starts with r.
Document IDdocument_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 hashtransactiontextRequired
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

AccountaccounttextRequired
The account's address. It starts with r.
Number of resultslimitnumber
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

AccountaccounttextRequired
The account's address. It starts with r.
Kind of objectobject_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 resultslimitnumber
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

AccountaccounttextRequired
The account's address. It starts with r.
Number of resultslimitnumber
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

AccountaccounttextRequired
The account's address. It starts with r.
Fromstart_timedate and time
Only transactions from this date and time on.
Untilend_timedate and time
Only transactions up to this date and time.
Transaction typetransaction_typetext
Only this kind of transaction, e.g. Payment. Leave empty for every kind.
Oldest firstoldest_firsttrue/false
List the oldest transactions first instead of the newest.Default: false.
Number of resultslimitnumber
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 IDnft_idtextRequired
The NFT's 64-character id. List account NFTs shows them.
Offerssidetext
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

IssuerissuertextRequired
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 resultslimitnumber
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

AccountaccounttextRequired
The account's address. It starts with r.
Counterpartycounterpartytext
Only the line with this account, e.g. one token's issuer. Leave empty for every line.
Number of resultslimitnumber
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
    }
  ]
}

On this page