# XRP Ledger

> 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.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/xrp-ledger

## Actions

### 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_account`, text, required): The address that would send. It starts with r.
- Recipient (`destination_account`, text, required): The address that would receive. It starts with r.

**Outputs**

- `authorized` (true/false): True when the sender may pay the recipient directly.
- `destination_account` (text): The recipient.
- `ledger_index` (number): The validated ledger the answer was read from.
- `source_account` (text): The sender.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- Account is (`role`, text): 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**

- `account` (text): The account's address.
- `count` (number): How many problems there are.
- `ledger_index` (number): The validated ledger the answer was read from.
- `problems` (list): Each setting that is wrong for the role, as a sentence.
- `role` (text): 'gateway' or 'user', as checked.
- `suggested_transactions` (list): The unsigned transactions that would fix them, one per problem.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.

**Outputs**

- `account` (text): The account's address.
- `available_xrp` (number): The XRP it can spend: its balance less the reserve.
- `balance_drops` (text): The same balance in drops (1 XRP is 1,000,000 drops).
- `balance_xrp` (number): The XRP it holds.
- `default_ripple` (true/false): True when rippling is on by default, as a token issuer needs.
- `deposit_auth` (true/false): True when only accounts it has authorized may pay it.
- `domain` (text): The domain it claims, e.g. 'bitstamp.net'.
- `explorer_url` (text): The account's page on the XRPL Explorer (livenet.xrpl.org).
- `global_freeze` (true/false): True when it has frozen every token it issues.
- `last_transaction_hash` (text): The hash of the last transaction that changed it.
- `last_transaction_ledger` (number): The ledger of that transaction.
- `ledger_index` (number): The validated ledger the answer was read from.
- `master_key_disabled` (true/false): True when its master key can no longer sign.
- `minted_nfts` (number): How many NFTs it has minted.
- `nft_minter` (text): The account allowed to mint NFTs for it, if any.
- `owner_count` (number): How many objects it owns (trust lines, offers, NFT pages...).
- `regular_key` (text): The address of the second key that can sign for it, if any.
- `requires_destination_tag` (true/false): True when payments to it must carry a destination tag.
- `reserve_xrp` (number): The XRP it must keep and can't spend: the base reserve plus a reserve for each object it owns.
- `sequence` (number): The sequence number its next transaction must use.
- `settings` (list): Every setting turned on, in words, e.g. 'Requires a destination tag'.
- `tick_size` (number): For an issuer, the significant digits its exchange rates keep.
- `transfer_fee_percent` (number): For an issuer, the fee it charges when its tokens change hands, in percent.

**Example output**

```json
{
  "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 (`asset1`, text, required): 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 (`asset2`, text, required): 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_account` (text): The pool's own address.
- `asset1` (object): How much of the first currency the pool holds.
- `asset1_frozen` (true/false): True when the first currency is frozen.
- `asset2` (object): How much of the second currency the pool holds.
- `asset2_frozen` (true/false): True when the second currency is frozen.
- `auction_slot_expires_at` (text): When the slot expires, ISO 8601 in UTC.
- `auction_slot_fee_percent` (number): The slot holder's discounted fee, in percent.
- `auction_slot_holder` (text): Who holds the auction slot, which trades at a discount.
- `ledger_index` (number): The validated ledger the answer was read from.
- `lp_token` (object): The LP tokens in issue, which liquidity providers hold.
- `price` (number): The pool's price: second currency per one unit of the first.
- `trading_fee_percent` (number): The fee a trade against the pool pays, in percent.
- `votes` (list): The liquidity providers' votes on the trading fee.

**Example output**

```json
{
  "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 (`account`, text, required): The token issuer's address. It starts with r.
- Hot wallets (`hot_wallets`, text): The issuer's own operational addresses, separated by commas, so their holdings are counted apart. Leave empty if it has none.

**Outputs**

- `account` (text): The account's address.
- `assets` (list): Tokens of other issuers it holds itself.
- `frozen_balances` (list): Balances of its tokens it has frozen.
- `hot_wallet_balances` (list): What each hot wallet you named holds of its tokens.
- `ledger_index` (number): The validated ledger the answer was read from.
- `obligations` (list): Each token it issues, with the total held by others (less its hot wallets).

**Example output**

```json
{
  "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 (`ledger`, text): A ledger number or hash. Leave empty for the latest validated ledger.
- Include transactions (`include_transactions`, true/false): Also list every transaction in the ledger. Default: `false`.

**Outputs**

- `close_time` (text): When it closed, ISO 8601 in UTC.
- `ledger_hash` (text): The ledger's hash.
- `ledger_index` (number): The ledger's number.
- `parent_hash` (text): The previous ledger's hash.
- `total_drops` (text): The same in drops.
- `total_xrp` (number): All the XRP in existence after it (fees destroy a little each ledger).
- `transaction_count` (number): How many transactions it holds.
- `transactions` (list): Its transactions, when 'Include transactions' is on.
- `validated` (true/false): True when it is validated, so final.

**Example output**

```json
{
  "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_ledgers` (text): The ledgers the server holds, e.g. '32570-107824513'.
- `base_fee_xrp` (number): The fee a plain transaction pays when the network is quiet, in XRP.
- `base_reserve_xrp` (number): The XRP every account must keep, at least.
- `ledger_age_seconds` (number): How many seconds ago it closed.
- `ledger_hash` (text): Its hash.
- `ledger_index` (number): The latest validated ledger.
- `load_factor` (number): How busy the server is: 1 is normal; fees rise with it.
- `network_id` (number): The network: 0 is the XRP Ledger mainnet.
- `owner_reserve_xrp` (number): The extra XRP an account keeps for each object it owns.
- `server_state` (text): The server's state, 'full' when in step with the network.
- `server_time` (text): The server's clock, ISO 8601 in UTC.
- `server_version` (text): The server software's version.

**Example output**

```json
{
  "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_id`, text, required): The NFT's 64-character id. List account NFTs shows them.

**Outputs**

- `burnable` (true/false): True when the issuer may burn (destroy) it.
- `is_burned` (true/false): True when it has been burned.
- `issuer` (text): The account that minted it.
- `ledger_index` (number): The validated ledger the answer was read from.
- `mutable` (true/false): True when the issuer may change its URI.
- `nft_id` (text): The NFT's id.
- `only_xrp` (true/false): True when it can only be bought and sold for XRP.
- `owner` (text): The account that holds it now.
- `serial` (number): Its serial number among the issuer's NFTs.
- `taxon` (number): The issuer's collection number for it.
- `transfer_fee_percent` (number): The royalty the issuer takes on each resale, in percent.
- `transferable` (true/false): True when holders other than the issuer may sell it on.
- `uri` (text): Its URI (usually where its metadata or image is), decoded.

**Example output**

```json
{
  "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 (`buy`, text, required): 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_with`, text, required): 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 (`limit`, number): How many offers to return, 1 to 100. Defaults to 20. From 1 to 100.

**Outputs**

- `best_price` (number): The best (lowest) price on offer. Empty when nobody is selling.
- `buy` (text): The currency bought, as given.
- `count` (number): How many offers came back.
- `ledger_index` (number): The validated ledger the answer was read from.
- `offers` (list): The offers, best price first.
- `pay_with` (text): The currency paid, as given.

**Example output**

```json
{
  "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 (`account`, text, required): The address that publishes the oracle. It starts with r.
- Document ID (`document_id`, number, required): The oracle's document id on that account (DIA's is 42). From 0 to 4294967295.

**Outputs**

- `account` (text): The account's address.
- `asset_class` (text): What it prices, e.g. 'currency'.
- `count` (number): How many prices it publishes.
- `document_id` (number): The oracle's document id on that account.
- `last_updated` (text): When it last updated, ISO 8601 in UTC.
- `ledger_index` (number): The validated ledger the answer was read from.
- `prices` (list): Each price it publishes.
- `provider` (text): Who provides the prices, e.g. 'diadata'.
- `uri` (text): A link the oracle gives for more about it.

**Example output**

```json
{
  "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 (`transaction`, text, required): The transaction's 64-character hash (or its 16-character CTID, starting with C).

**Outputs**

- `account` (text): The address that sent (signed) the transaction.
- `amount` (object): The amount it names: what a payment sends, an escrow or channel holds, a check allows or an NFT offer asks.
- `balance_changes` (list): Every balance it changed, one row per account and currency.
- `date` (text): When that ledger closed, ISO 8601 in UTC.
- `delivered_amount` (object): For a payment that succeeded, what actually arrived. Use this rather than the amount: a partial payment can deliver less.
- `destination` (text): The address it was sent to, for payments, checks and escrows.
- `destination_tag` (number): The destination tag: the number an exchange or service uses to tell its customers apart.
- `explorer_url` (text): The transaction's page on the XRPL Explorer.
- `fee_drops` (text): The fee paid, in drops.
- `fee_xrp` (number): The fee paid, in XRP.
- `hash` (text): The transaction's hash, its id.
- `ledger_index` (number): The ledger it was validated in.
- `memos` (list): The text of each memo attached, decoded (hex when not text).
- `result` (text): The result code: 'tesSUCCESS' when it succeeded, else a code such as 'tecPATH_DRY'.
- `sequence` (number): The sender's sequence number it used.
- `source_tag` (number): The source tag the sender set, if any.
- `succeeded` (true/false): True when the result is tesSUCCESS.
- `summary` (text): What it did, in a sentence, e.g. 'rA... paid 25 XRP to rB...'.
- `type` (text): The kind of transaction, e.g. 'Payment', 'OfferCreate' or 'TrustSet'.
- `validated` (true/false): True when it is in a validated ledger, so final.

**Example output**

```json
{
  "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_drops` (number): The reference fee of a plain transaction, in drops.
- `current_ledger_size` (number): How many transactions the open ledger holds so far.
- `current_queue_size` (number): How many transactions are queued for later ledgers.
- `expected_ledger_size` (number): How many it takes before fees start to rise.
- `ledger_current_index` (number): The ledger now open.
- `max_queue_size` (number): How many the queue can hold.
- `median_fee_drops` (number): The median fee of transactions in the queue, in drops.
- `minimum_fee_drops` (number): The least a transaction can pay to be queued, in drops.
- `open_ledger_fee_drops` (number): What a transaction pays to get into the next ledger now, in drops.
- `open_ledger_fee_xrp` (number): The same in XRP.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- Number of results (`limit`, number): How many NFTs to return, 1 to 400. Defaults to 50. From 1 to 400.

**Outputs**

- `account` (text): The account's address.
- `count` (number): How many NFTs came back.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `ledger_index` (number): The validated ledger the answer was read from.
- `nfts` (list): The NFTs.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- Kind of object (`object_type`, text): 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 (`limit`, number): How many objects to return, 1 to 400. Defaults to 50. From 1 to 400.

**Outputs**

- `account` (text): The account's address.
- `count` (number): How many objects came back.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `ledger_index` (number): The validated ledger the answer was read from.
- `objects` (list): The objects.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- Number of results (`limit`, number): How many offers to return, 1 to 400. Defaults to 50. From 1 to 400.

**Outputs**

- `account` (text): The account's address.
- `count` (number): How many offers came back.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `ledger_index` (number): The validated ledger the answer was read from.
- `offers` (list): The offers.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- From (`start_time`, date and time): Only transactions from this date and time on.
- Until (`end_time`, date and time): Only transactions up to this date and time.
- Transaction type (`transaction_type`, text): Only this kind of transaction, e.g. Payment. Leave empty for every kind.
- Oldest first (`oldest_first`, true/false): List the oldest transactions first instead of the newest. Default: `false`.
- Number of results (`limit`, number): How many transactions to return, 1 to 200. Defaults to 20. From 1 to 200.

**Outputs**

- `account` (text): The account's address.
- `count` (number): How many transactions came back.
- `from_ledger` (number): The first ledger searched.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `to_ledger` (number): The last ledger searched.
- `transactions` (list): The transactions.

**Example output**

```json
{
  "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_id`, text, required): The NFT's 64-character id. List account NFTs shows them.
- Offers (`side`, text): Which offers to list. One of: `both` (Sell and buy offers), `sell` (Sell offers only), `buy` (Buy offers only). Default: `both`.

**Outputs**

- `buy_count` (number): How many are buy offers.
- `count` (number): How many offers came back.
- `nft_id` (text): The NFT.
- `offers` (list): The open offers, sell offers first.
- `sell_count` (number): How many are sell offers.

**Example output**

```json
{
  "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 (`issuer`, text, required): The address that minted the NFTs. It starts with r.
- Collection (taxon) (`taxon`, number): Only NFTs with this taxon, the number an issuer gives a collection. Leave empty for all. From 0 to 4294967295.
- Number of results (`limit`, number): How many NFTs to return, 1 to 400. Defaults to 50. From 1 to 400.

**Outputs**

- `count` (number): How many NFTs came back.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `issuer` (text): The issuer's address.
- `ledger_index` (number): The validated ledger the answer was read from.
- `nfts` (list): The NFTs.

**Example output**

```json
{
  "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 (`account`, text, required): The account's address. It starts with r.
- Counterparty (`counterparty`, text): Only the line with this account, e.g. one token's issuer. Leave empty for every line.
- Number of results (`limit`, number): How many trust lines to return, 1 to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `account` (text): The account's address.
- `count` (number): How many trust lines came back.
- `has_more` (true/false): True when there are more than came back. Raise 'Number of results' to see more.
- `ledger_index` (number): The validated ledger the answer was read from.
- `lines` (list): The trust lines.

**Example output**

```json
{
  "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
    }
  ]
}
```
