# Build with XRPSCAN

Explore our guides and examples to integrate XRPL.

## Introduction

XRPSCAN is the #1 explorer and network analysis platform for the XRP Ledger, the home of XRP. The XRP Ledger is a decentralized, public blockchain driven by a global and diverse developer community. We provide a clean and intuitive REST based API to look up accounts, transactions, ledgers and NFTs.

We welcome developers to build on XRPSCAN API. The API platform provides a set of powerful REST APIs designed for ease of use and developer productivity.


# Introduction

Welcome to XRPSCAN developer portal.

The XRPSCAN API platform provides a set of powerful REST APIs designed for ease of use and developer productivity. The latest (and only) supported API version is `v1`. All resources are relative to the following root endpoint:

{% code title="Mainnet" %}

```
https://api.xrpscan.com/api/v1
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/api/v1
```

{% endcode %}

The API has public as well as private endpoints. Only the public endpoints documented in this portal are meant for public use.

## License

<figure><img src="https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png" alt=""><figcaption><p>CC BY-NC-SA 4.0</p></figcaption></figure>

XRPSCAN API by XRPSCAN is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-nc-sa/4.0/). Permissions beyond the scope of this license, including commercial use are available by [contacting us](/help/contact-us).

{% embed url="<https://creativecommons.org/licenses/by-nc-sa/4.0/>" %}


# Pricing

API pricing that scales to fit your app

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>Developer</td><td><strong>FREE</strong></td><td>Integrate for free. Great for open source developers, students, researchers and academia.</td><td><a href="/files/txt6xQEMKc0RT1Ps41xU">/files/txt6xQEMKc0RT1Ps41xU</a></td></tr><tr><td>Pay as you Go</td><td><strong>0.0001 XRP per request</strong></td><td>Great starting point for businesses with medium usage. Comes with email support. <a href="/pages/oc9xaBy0jmBfAEFeVzQL">Read more →</a></td><td><a href="/files/iHX7bJTDiwgSNnJAflm2">/files/iHX7bJTDiwgSNnJAflm2</a></td></tr><tr><td>Enterprise</td><td><strong>$4,999 per month</strong></td><td>Best in class performance for high usage workloads. Higher number of requests and throughput.</td><td><a href="/files/QUVW5UV6HHY6fkcEd8lR">/files/QUVW5UV6HHY6fkcEd8lR</a></td></tr></tbody></table>

| FREE                | Pro                  | Enterprise             |
| ------------------- | -------------------- | ---------------------- |
| 10,000 requests/day | 100,000 requests/day | 1,000,000 requests/day |
| Self support        | Email support        | Email support          |
|                     |                      |                        |

Interested? contact us at `support@xrpscan.com`

{% content-ref url="/pages/lH5o8elX3Dc71usHaZkh" %}
[Contact us](/help/contact-us)
{% endcontent-ref %}


# Pay as you Go (PAYG)

With our Pay as you Go pricing, pay for our API based on how much you need. Our Pay as you Go offering is powered by [Dhali](https://dhali.io/docs/getting-started/). Click the link below to access Dhali payment terminal.

{% embed url="<https://pay.dhali.io/?uuids=ee519808-97b7-4288-abb8-17d4a8513ea5>" %}

## PAYG API base URL

Base URL for accessing XRP Ledger mainnet is:

```
https://xrpscan.dhali.io
```

## Full URL

To query ledger index `93957385`, use:

```
https://xrpscan.dhali.io/api/v1/ledger/93957385
```

## How to Pay as you Go

* Log into Dhali Payment Terminal, follow the instructions shown in the app to create a payment channel.
* Click "**Deposit**" to deposit enough `XRP` for your needs.
* Click "**Get payment claim**" to authorize spending your deposit.
* Copy `PAYMENT_CLAIM` value and save it securely. All API requests must use this payment claim to access the API.&#x20;
* Add `PAYMENT_CLAIM` to your request headers:

```
$ PAYMENT_CLAIM='<PAYMENT-CLAIM-VALUE>'
$ curl -H "Payment-Claim: $PAYMENT_CLAIM" https://xrpscan.dhali.io/<API_ENDPOINT>
```

* Monitor your usage via the Payment Terminal. Authorize more funds as needed.

## Example

```
$ PAYMENT_CLAIM='nue9eith1Cai......xi4toh8ohwfQ=='
$ curl -H "Payment-Claim: $PAYMENT_CLAIM" https://xrpscan.dhali.io/api/v1/ping
```

## Dhali documentation

{% embed url="<https://dhali.io/docs/getting-started/>" %}

## Dhali SDKs

{% embed url="<https://www.npmjs.com/package/dhali-js>" %}
dhali-js for Node.js applications
{% endembed %}

{% embed url="<https://pypi.org/project/dhali-py/>" %}
dhali-py for Python applications
{% endembed %}


# API Concepts

Learn about concepts specific to the XRPSCAN API


# Pagination

Some APIs may contain a large number of documents. It is possible to paginate data in such APIs by passing `limit` and `offset` parameters in the GET query string.

<table><thead><tr><th width="155">Parameter</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>limit</code></td><td>Number</td><td>Maximum number of documents the API will return.</td></tr><tr><td><code>offset</code></td><td>Number</td><td>Number of documents to skip in the results set.</td></tr></tbody></table>

## Example

To fetch 20 AMM pools from record 60 through 79, `offset` parameter would be set to 60 and `limit` parameter would be set to 20.

<pre><code>$ curl "https://api.xrpscan.com/api/v1/amm/pools?<a data-footnote-ref href="#user-content-fn-1">offset</a>=60&#x26;<a data-footnote-ref href="#user-content-fn-2">limit</a>=20"
</code></pre>

[^1]: Maximum number of documents the API will return.

[^2]: Number of documents to skip in the results set.


# Account


# Account info

Retrieves information about an account, its activity, and its XRP balance. All information retrieved is relative to the last validated ledger.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
$ curl https://api.xrpscan.com/api/v1/account/rwpTh9DDa52XkM9nTKp2QrJuCGV5d1mQVP
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "sequence": 573329,
  "xrpBalance": "985332.357523",
  "ownerCount": 0,
  "previousAffectingTransactionID": "59B6AEB320F3861003A48C811F231BF37D8E3A24240096F426C32CC903E1BCED",
  "previousAffectingTransactionLedgerVersion": 81461129,
  "Account": "rwpTh9DDa52XkM9nTKp2QrJuCGV5d1mQVP",
  "Balance": "985332357523",
  "Flags": 0,
  "LedgerEntryType": "AccountRoot",
  "OwnerCount": 0,
  "PreviousTxnID": "59B6AEB320F3861003A48C811F231BF37D8E3A24240096F426C32CC903E1BCED",
  "PreviousTxnLgrSeq": 81461129,
  "Sequence": 573329,
  "index": "AEF7054C5839EDA240E3EC9DABC7305B9D8AD449D95C09D8B5C647E3A9E668DF",
  "settings": {},
  "account": "rwpTh9DDa52XkM9nTKp2QrJuCGV5d1mQVP",
  "parent": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg",
  "initial_balance": 8793.131825,
  "inception": "2020-03-17T20:40:10.000Z",
  "ledger_index": 54161785,
  "tx_hash": "D46593AE03B566A10BCC1F968EB069DB84D4D51388EA4C9F947162F7F9A2AC1D",
  "accountName": {
    "name": "Coinbase",
    "desc": "4",
    "account": "rwpTh9DDa52XkM9nTKp2QrJuCGV5d1mQVP",
    "domain": "coinbase.com",
    "twitter": "coinbase"
  },
  "parentName": {
    "name": "Coinbase",
    "desc": "2",
    "account": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg",
    "domain": "coinbase.com",
    "twitter": "coinbase",
    "verified": true
  }
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_info` command.

{% embed url="<https://xrpl.org/account_info.html>" %}


# Activations

This endpoint retrieves all child accounts activated by a given account.&#x20;

There is not a dedicated "create account" transaction. The [Payment transaction](https://xrpl.org/payment.html) automatically creates a new account if the payment sends XRP equal to or greater than the [account reserve](https://xrpl.org/reserves.html) to a valid address that does not already have an account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/activations
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
$ curl https://api.xrpscan.com/api/v1/account/rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY/activations
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "result": "success",
  "count": 25,
  "marker": "20180921135312|000041687556|00047",
  "accounts": [
    {
      "account": "rGbvH8TVWsmmFWPUDypx1CCCk4znoaofLp",
      "parent": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
      "initial_balance": "20",
      "inception": "2018-02-27T23:33:40Z",
      "ledger_index": 36880537,
      "tx_hash": "485B6C4AF662EE45DA4F9B567613C04039ACD395FA383795224EE91DFCABCE68",
      "parentName": {
        "name": "XRP Tip Bot",
        "account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
        "domain": "xrptipbot.com",
        "twitter": "xrptipbot",
        "verified": true
      }
    },
    {
      "account": "rMWoY6X6LHmrTv3UmC3w3TCa6S9URXTcb7",
      "parent": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
      "initial_balance": "20",
      "inception": "2018-06-02T07:02:20Z",
      "ledger_index": 39090386,
      "tx_hash": "BEE4990AC93DE798AC9D41EA938B36F3229E56E5B21C0827D7DCCA804E74EDD6",
      "parentName": {
        "name": "XRP Tip Bot",
        "account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
        "domain": "xrptipbot.com",
        "twitter": "xrptipbot",
        "verified": true
      }
    },
    ...
  ]
}
```

{% endtab %}
{% endtabs %}


# Ancestry

This endpoint retrieves a recursive ordered list of accounts that activated a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/ancestry
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1/ancestry
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
  "parent": "rf8kg7r5Fc8cCszGdD2jeUZt2FrgQd76BS",
  "inception": "2013-02-19T02:36:20.000Z",
  "ledger_index": 244032,
  "ancestry": [
    {
      "account": "rf8kg7r5Fc8cCszGdD2jeUZt2FrgQd76BS",
      "inception": "2013-01-01T03:21:10.000Z",
      "ledger_index": 32570,
      "depth": 1,
      "accountName": {
        "username": "ahbritto",
        "account": "rf8kg7r5Fc8cCszGdD2jeUZt2FrgQd76BS"
      }
    },
    {
      "account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1",
      "parent": "rf8kg7r5Fc8cCszGdD2jeUZt2FrgQd76BS",
      "inception": "2013-02-19T02:36:20.000Z",
      "ledger_index": 244032,
      "tx_hash": "66F353F9A72178768AB5B03DC2922C30C4E118BEF8758632B7063BDDE512D335",
      "depth": 0,
      "accountName": {
        "username": "Bitstamp-hot",
        "account": "rrpNnNLKrartuEqfJGpqyDwPj1AFPg9vn1"
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}


# Assets

This endpoint retrieves IOU tokens owned by a given account.

Tokens can represent any type of value, including "stablecoins" backed by assets that exist outside of the ledger, purely digital tokens created specifically on the XRP Ledger, community credit, and more.

{% embed url="<https://xrpl.org/tokens.html>" %}
Read more about Tokens on xrpl.org
{% endembed %}

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/assets
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rGFuMiw48HdbnrUbkRYuitXTmfrDBNTCnX/assets
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "counterparty": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
    "currency": "BTC",
    "value": "36.41805453512676",
    "counterpartyName": {
      "username": "Bitstamp",
      "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
    }
  },
  {
    "counterparty": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
    "currency": "EUR",
    "value": "4926372.911025",
    "counterpartyName": {
      "username": "Bitstamp",
      "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
    }
  },
  {
    "counterparty": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
    "currency": "USD",
    "value": "4673369.908680244",
    "counterpartyName": {
      "username": "Bitstamp",
      "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"
    }
  }
]
```

{% endtab %}
{% endtabs %}


# Deposit Preauths

This endpoint retrieves pre-authorized accounts that can deposit funds to a given account.

Deposit Authorization is an optional account setting in the XRP Ledger. If enabled, Deposit Authorization blocks all transfers from strangers, including transfers of XRP and tokens. An account with Deposit Authorization can only receive value in two ways - from accounts it has pre-authorized or by sending a transaction to recive funds.

{% embed url="<https://xrpl.org/depositauth.html#preauthorization>" %}
Read more about Deposit Pre-authorization on xrpl.org
{% endembed %}

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/deposit_preauths
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rMND5vHirAL1AUCDfqvGtBkgnEgVeB4X7h/deposit_preauths
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "Account": "rMND5vHirAL1AUCDfqvGtBkgnEgVeB4X7h",
    "Authorize": "rNKpohy2aF3ZJg27QLAhQHT5muoXYNrzSu"
  },
  {
    "Account": "rMND5vHirAL1AUCDfqvGtBkgnEgVeB4X7h",
    "Authorize": "rLyUreVzNcAtAkBhwaiw9WyxmnoSdaAyTs"
  },
  {
    "Account": "rMND5vHirAL1AUCDfqvGtBkgnEgVeB4X7h",
    "Authorize": "rBg2FuZT91C52Nny68houguJ4vt5x1o91m"
  },
  {
    "Account": "rMND5vHirAL1AUCDfqvGtBkgnEgVeB4X7h",
    "Authorize": "rpQVujdWMw2odm8gQHiyGM7qrbkyQmf1sZ"
  }
]
```

{% endtab %}
{% endtabs %}


# DEX Orders

This endpoint retrieves a list of DEX orders (or, offers) made by a given account that are outstanding as of the last validated ledger.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/orders
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah/orders
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "specification": {
      "direction": "buy",
      "quantity": {
        "currency": "USD",
        "value": "53934.3279",
        "counterparty": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq"
      },
      "totalPrice": {
        "currency": "XRP",
        "value": "72045"
      }
    },
    "properties": {
      "maker": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
      "sequence": 102024952,
      "makerExchangeRate": "0.74862"
    }
  },
  {
    "specification": {
      "direction": "buy",
      "quantity": {
        "currency": "EUR",
        "value": "49134.41118585",
        "counterparty": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq"
      },
      "totalPrice": {
        "currency": "XRP",
        "value": "72045"
      }
    },
    "properties": {
      "maker": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah",
      "sequence": 102024953,
      "makerExchangeRate": "0.68199613"
    }
  },
  ...
]
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_offers` command.

{% embed url="<https://xrpl.org/account_offers.html>" %}


# Escrows

This endpoint retrieves XRP locked in on-ledger time based escrows for a given account.

Escrow is a feature of the XRP Ledger that allows you to send conditional XRP payments. These conditional payments, called *escrows*, set aside XRP and deliver it later when certain conditions are met.

{% embed url="<https://xrpl.org/account_objects.html#account_objects>" %}
Read more about account\_objects on xrpl.org
{% endembed %}

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/escrows
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY/escrows
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "Account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
    "Amount": "250000000",
    "Destination": "rHhuUU6kb2DVaHYVkNjeH5NLuFPiVz98Pa",
    "DestinationNode": "0",
    "DestinationTag": 0,
    "FinishAfter": 734639400,
    "Flags": 0,
    "LedgerEntryType": "Escrow",
    "OwnerNode": "1",
    "PreviousTxnID": "A6AEA6C63575A09157A2DA74C6D50DA6C2A88E8172823578E6B79DEFB780B7EE",
    "PreviousTxnLgrSeq": 43448639,
    "SourceTag": 20145,
    "index": "CD87787EC9BF895988871B56855F446BB85652A9E7FF6B4CABD4A9104324CCF0",
    "AccountName": {
      "name": "XRP Tip Bot",
      "account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
      "domain": "xrptipbot.com",
      "twitter": "xrptipbot",
      "verified": true
    }
  },
  {
    "Account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
    "Amount": "10000000",
    "Destination": "rp31TCoguTHzVgS5sV6BVYo1L4r6GLPtUZ",
    "DestinationNode": "0",
    "DestinationTag": 0,
    "FinishAfter": 739737000,
    "Flags": 0,
    "LedgerEntryType": "Escrow",
    "OwnerNode": "2",
    "PreviousTxnID": "4C7EA45CCE5CA877182F0D40E53CA389B71C8421D854870FDB5E074C954EBE94",
    "PreviousTxnLgrSeq": 44260645,
    "SourceTag": 7316,
    "index": "D0EA95685C9C08DE1D4AB7ABF64D563C22DFB9B6B29F4189291C2993CECC3D45",
    "AccountName": {
      "name": "XRP Tip Bot",
      "account": "rPEPPER7kfTD9w2To4CQk6UCfuHM9c6GDY",
      "domain": "xrptipbot.com",
      "twitter": "xrptipbot",
      "verified": true
    }
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Issued tokens

This endpoint retrieves tokens issued by a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/obligations
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B/obligations
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "currency": "AUD",
    "value": "8692.124778218182"
  },
  {
    "currency": "BTC",
    "value": "383.870451452218"
  },
  {
    "currency": "CHF",
    "value": "8999.902361874776"
  },
  {
    "currency": "EUR",
    "value": "4993503.074323792"
  },
  {
    "currency": "GBP",
    "value": "2358.981108002784"
  },
  {
    "currency": "JPY",
    "value": "898767.4602429621"
  },
  {
    "currency": "USD",
    "value": "12197839.11643992"
  }
]
```

{% endtab %}
{% endtabs %}


# Issued token balance

This endpoint retrieves token balance for the specified token issued by a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/obligation/{TOKEN_ID}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B/obligation/USD
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
12197839.11643992
```

{% endtab %}
{% endtabs %}


# NFTs

This endpoint retrieves XLS-20 NFTs owned by a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/nfts
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/ro4HnG6G1Adz2cWSnZ3Dcr39kmXk4ztA5/nfts
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "Flags": 8,
    "Issuer": "ro4HnG6G1Adz2cWSnZ3Dcr39kmXk4ztA5",
    "NFTokenID": "0008138808C4E53F4F6EF5D5B2AF64F96B457F42E0ED95300000099B00000000",
    "NFTokenTaxon": 0,
    "TransferFee": 5000,
    "URI": "https://bafybeienvbxkuolk7x3c36awhj44noohwva3ph5h7ktjxamhmoc32es62q.ipfs.nftstorage.link/almighty_bird.jpg",
    "nft_serial": 0
  },
  {
    "Flags": 8,
    "Issuer": "ro4HnG6G1Adz2cWSnZ3Dcr39kmXk4ztA5",
    "NFTokenID": "0008138808C4E53F4F6EF5D5B2AF64F96B457F42E0ED95301B714B0C00000071",
    "NFTokenTaxon": 0,
    "TransferFee": 5000,
    "URI": "https://bafybeienvbxkuolk7x3c36awhj44noohwva3ph5h7ktjxamhmoc32es62q.ipfs.nftstorage.link/cool_bird_no_35.jpg",
    "nft_serial": 113
  },
  {
    "Flags": 8,
    "Issuer": "ro4HnG6G1Adz2cWSnZ3Dcr39kmXk4ztA5",
    "NFTokenID": "0008138808C4E53F4F6EF5D5B2AF64F96B457F42E0ED95301BDCB687000000EC",
    "NFTokenTaxon": 0,
    "TransferFee": 5000,
    "URI": "https://bafybeienvbxkuolk7x3c36awhj44noohwva3ph5h7ktjxamhmoc32es62q.ipfs.nftstorage.link/cool_bird_no_158.jpg",
    "nft_serial": 236
  },
  ...
]
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_nfts` command.

{% embed url="<https://xrpl.org/account_nfts.html>" %}


# Settings

This endpoint retrieves account settings for a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/settings
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn/settings
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "requireDestinationTag": true,
  "disableMasterKey": true,
  "defaultRipple": true,
  "emailHash": "98B4375E1D753E5B91627516F6D70977",
  "messageKey": "0000000000000000000000070000000300",
  "domain": "mduo13.com",
  "transferRate": 4.294967295,
  "regularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
  "signers": {
    "threshold": 2,
    "weights": [
      {
        "address": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
        "weight": 1
      },
      {
        "address": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
        "weight": 1
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_info` command and AccountRoot ledger object.

{% embed url="<https://xrpl.org/account_info.html#response-format>" %}

{% embed url="<https://xrpl.org/accountroot.html>" %}


# Trustlines

This endpoint retrieves information about an account's trust lines, which contain balances in all non-XRP currencies and assets. All information retrieved is relative to a last validated ledger.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/trustlines2
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn/trustlines2
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
  "ledger_current_index": 81505485,
  "lines": [
    {
      "account": "rJF9txJpy3RG7XkXsiL72us5X5txbQDFgA",
      "balance": "0",
      "currency": "VGB",
      "limit": "0",
      "limit_peer": "100000000",
      "no_ripple": false,
      "no_ripple_peer": true,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
      "balance": "0",
      "currency": "USD",
      "limit": "1000000000",
      "limit_peer": "0",
      "no_ripple": true,
      "no_ripple_peer": false,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "r9qheokwreSsfdFqvYzYerrTa6xGpD8N5r",
      "balance": "0",
      "currency": "USD",
      "limit": "0",
      "limit_peer": "10000",
      "no_ripple": false,
      "no_ripple_peer": false,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
      "balance": "-14.0301",
      "currency": "USD",
      "limit": "0",
      "limit_peer": "100",
      "no_ripple": false,
      "no_ripple_peer": false,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
      "balance": "0.0001",
      "currency": "USD",
      "limit": "110",
      "limit_peer": "0",
      "no_ripple": true,
      "no_ripple_peer": false,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW",
      "balance": "0",
      "currency": "USD",
      "freeze": true,
      "limit": "110",
      "limit_peer": "0",
      "peer_authorized": true,
      "quality_in": 0,
      "quality_out": 0
    },
    {
      "account": "rKaSUCRdBL5tnjEfbnA67JfbzHtCKsyNyE",
      "balance": "0",
      "currency": "USD",
      "limit": "0",
      "limit_peer": "10000000",
      "no_ripple": false,
      "no_ripple_peer": false,
      "quality_in": 0,
      "quality_out": 0
    }
  ],
  "validated": false
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_lines` command.

{% embed url="<https://xrpl.org/account_lines.html#response-format>" %}


# Transactions

This endpoint retrieves a list of transactions that involved the specified account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/transactions
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv/transactions
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
  "ledger_index_min": 32570,
  "ledger_index_max": 81505670,
  "transactions": [
    {
      "meta": {
        "TransactionIndex": 38,
        "TransactionResult": "tesSUCCESS",
        "delivered_amount": {
          "value": 109100000000,
          "currency": "XRP"
        }
      },
      "validated": true,
      "Account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
      "Amount": {
        "value": 109100000000,
        "currency": "XRP"
      },
      "Destination": "rwWr7KUZ3ZFwzgaDGjKBysADByzxvohQ3C",
      "DestinationTag": 2223795,
      "Fee": "10000",
      "Flags": 2147483648,
      "LastLedgerSequence": 81505917,
      "Sequence": 2902111,
      "SigningPubKey": "03511308215C16636E6605938C61D28B03345CFFEAA0D9EACCFA9386BAA1A55752",
      "TransactionType": "Payment",
      "TxnSignature": "3044022054E688529685546D8DEEECE1612A782D1DAE92E516A4F94CEA0A77A1AFDD43B302201F1B8B114A4A090E036B6409A1693A43FEE791FDEA0F262875ED57B611119288",
      "hash": "D54105B3D7CADE03910E90646514B0CDB98A052D97A60BF82C80EA6A2692BA12",
      "ledger_index": 81505668,
      "date": "2023-07-30T19:51:20.000Z",
      "AccountName": {
        "name": "Bitstamp",
        "desc": "1",
        "account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
        "domain": "bitstamp.net",
        "twitter": "Bitstamp",
        "verified": true
      },
      "DestinationName": {
        "name": "Indodax",
        "desc": "1",
        "account": "rwWr7KUZ3ZFwzgaDGjKBysADByzxvohQ3C",
        "domain": "indodax.com",
        "twitter": "indodaxOfficial"
      }
    },
    {
      "meta": {
        "TransactionIndex": 56,
        "TransactionResult": "tesSUCCESS",
        "delivered_amount": {
          "value": 568741841,
          "currency": "XRP"
        }
      },
      "validated": true,
      "Account": "rLHzPsX6oXkzU2qL12kHCH8G8cnZv1rBJh",
      "Amount": {
        "value": 568741841,
        "currency": "XRP"
      },
      "Destination": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
      "DestinationTag": 94827736,
      "Fee": "12",
      "Flags": 2147483648,
      "LastLedgerSequence": 81505662,
      "Sequence": 1453476,
      "SigningPubKey": "02F6A2E0A7650748B45F2329D92D598604D89146C16D5700F492126F1F07914A2E",
      "TransactionType": "Payment",
      "TxnSignature": "30450221008D98D359BE6004DCDBB654D5F000F69CBC3754D79930290B467B835A586F14C2022025B04AC82A1D6A751F53A1EE9EF7C352A6BB0A02687C98D276A94AC56B7017D9",
      "hash": "2A4D075E891011A444470BCB51629104732048926E760C0D292546B1F8A51DA7",
      "ledger_index": 81505653,
      "date": "2023-07-30T19:50:21.000Z",
      "AccountName": {
        "name": "Kraken",
        "desc": "1",
        "account": "rLHzPsX6oXkzU2qL12kHCH8G8cnZv1rBJh",
        "domain": "kraken.com",
        "twitter": "krakenfx",
        "verified": true
      },
      "DestinationName": {
        "name": "Bitstamp",
        "desc": "1",
        "account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
        "domain": "bitstamp.net",
        "twitter": "Bitstamp",
        "verified": true
      }
    },
    ...
  ],
  "validated": true,
  "marker": "7b226c6564676572223a38313530353431332c22736571223a33347d",
  "limit": 25
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_tx` command.

{% embed url="<https://xrpl.org/account_tx.html#response-format>" %}

## Fetch multiple pages

Some requests may return results spanning multiple pages. In such cases, the API will return **marker** field. Pass the **marker** field back to return the next page of results.

{% code title="Paginate" overflow="wrap" %}

```sh
curl https://api.xrpscan.com/api/v1/account/rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv/transactions?marker=7b226c6564676572223a38313530353431332c22736571223a33347d
```

{% endcode %}


# Xumm KYC status

This endpoint retrieves Xumm KYC status for a given account.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/account/{ACCOUNT}/xummkyc
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/account/ra5nK24KXen9AHvsdFTKHSANinZseWnPcX/xummkyc
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "account": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
  "kycApproved": true
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `account_tx` command.

{% embed url="<https://xumm.readme.io/reference/kyc-statusaccount>" %}


# Transaction


# Transaction info

This endpoint retrieves transaction object identified by a given transaction hash.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/tx/{HASH}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/tx/B01A7E11B84A2539A3DCCF65C95514F4C3A87E61BAF7DBDED9F1CDEE06D5A39C
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "Amount": {
    "value": 230293920,
    "currency": "XRP"
  },
  "meta": {
    "delivered_amount": {
      "value": 230293920,
      "currency": "XRP"
    },
    "AffectedNodes": [
      {
        "ModifiedNode": {
          "FinalFields": {
            "Account": "r33hypJXDs47LVpmvta7hMW9pR8DYeBtkW",
            "Balance": "12578893259807",
            "Flags": 131072,
            "MessageKey": "02000000000000000000000000878CD675FBCF3CB8D0B920B0BECD695FB0C205DA",
            "OwnerCount": 0,
            "Sequence": 58344
          },
          "LedgerEntryType": "AccountRoot",
          "LedgerIndex": "282B966A0E1FA1FE3ADD8A0A068A50B67E0E8127630BFAF2E55CD7ED0B4BCDA1",
          "PreviousFields": {
            "Balance": "12578662965887"
          },
          "PreviousTxnID": "675EC31EAAF26521F8081CA202677E7E5188DBA01065F16752C808A89B9F6982",
          "PreviousTxnLgrSeq": 81516514
        }
      },
      {
        "ModifiedNode": {
          "FinalFields": {
            "Account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
            "Balance": "44303549301389",
            "Flags": 1179648,
            "OwnerCount": 0,
            "RegularKey": "rBMFF7vhe2pxYS5wo3dpXMDrbbRudB7hGf",
            "Sequence": 2902420
          },
          "LedgerEntryType": "AccountRoot",
          "LedgerIndex": "C3B625B296E95A21D7BBBB7E3D343AF423B463B87B5D56EE7F79C8E16A47A6F5",
          "PreviousFields": {
            "Balance": "44303779605309",
            "Sequence": 2902419
          },
          "PreviousTxnID": "675EC31EAAF26521F8081CA202677E7E5188DBA01065F16752C808A89B9F6982",
          "PreviousTxnLgrSeq": 81516514
        }
      }
    ],
    "TransactionIndex": 9,
    "TransactionResult": "tesSUCCESS"
  },
  "NFTokenOffers": [],
  "Paths": [],
  "Account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
  "Destination": "r33hypJXDs47LVpmvta7hMW9pR8DYeBtkW",
  "DestinationTag": 1076932832,
  "Fee": 10000,
  "Flags": 2147483648,
  "LastLedgerSequence": 81516764,
  "Sequence": 2902419,
  "SigningPubKey": "03511308215C16636E6605938C61D28B03345CFFEAA0D9EACCFA9386BAA1A55752",
  "TransactionType": "Payment",
  "TxnSignature": "30450221009F3065DFA7D55EA81F3ABDD950FB0B777AB308E1E82936E880AC382A809A640B022052FE9DB2EE4CD90A4839D66BC806760436D3936DD1E18C710B2904E5DD0F65A8",
  "hash": "B01A7E11B84A2539A3DCCF65C95514F4C3A87E61BAF7DBDED9F1CDEE06D5A39C",
  "ledger_index": 81516515,
  "date": "2023-07-31T07:18:30.000Z",
  "Signers": [],
  "Memos": [],
  "AccountName": {
    "name": "Bitstamp",
    "desc": "1",
    "account": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
    "domain": "bitstamp.net",
    "twitter": "Bitstamp",
    "verified": true
  },
  "DestinationName": {
    "name": "Independent Reserve",
    "account": "r33hypJXDs47LVpmvta7hMW9pR8DYeBtkW",
    "domain": "independentreserve.com",
    "twitter": "indepreserve",
    "verified": true
  },
  "AmendmentName": null,
  "SigningPubKeyAccount": "rBMFF7vhe2pxYS5wo3dpXMDrbbRudB7hGf"
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `tx` command.

{% embed url="<https://xrpl.org/tx.html#response-format>" %}


# Ledger


# Ledgers

This endpoint retrieves last 10 ledgers closed by the network.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/ledgers
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/ledgers
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "current_ledger": 90852571,
  "ledgers": [
    {
      "ledger_index": 90852571,
      "ledger_hash": "6BA5FD4D8CD8DC513DE2410D87C8FB21A86E8DE327D5D5679945698DAD6284D2",
      "close_flags": 0,
      "close_time": 1726737870,
      "close_time_human": "2024-09-19T09:24:30.000Z",
      "close_time_resolution": 10,
      "parent_close_time": 1726737862,
      "parent_hash": "B6B25C45558ABB1CDA74C3128EA854DB0D921B621FF383F684BECE8A82CC7DC9",
      "transaction_hash": "BABD823DC4EEF9BF757D6F596DC9C55A6D8EF99BE2A230A30468BFF26497C963",
      "tx_count": 71,
      "total_coins": 99987172394797580,
      "destroyed_coins": -16880
    },
    {
      "ledger_index": 90852570,
      "ledger_hash": "B6B25C45558ABB1CDA74C3128EA854DB0D921B621FF383F684BECE8A82CC7DC9",
      "close_flags": 0,
      "close_time": 1726737862,
      "close_time_human": "2024-09-19T09:24:22.000Z",
      "close_time_resolution": 10,
      "parent_close_time": 1726737861,
      "parent_hash": "DEDF680D8A0D2058EF8FC1330D7C9111E2C823815537E84DAB015B4FF76679CD",
      "transaction_hash": "1FDEFF9192B28E6E09665B927DFBB53971E47BA527BEF28DCDC6E37D27077261",
      "tx_count": 57,
      "total_coins": 99987172394814460,
      "destroyed_coins": -13696
    },
    ...
  ]
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `ledger` command.

{% embed url="<https://xrpl.org/ledger.html#response-format>" %}


# Ledger info

This endpoint retrieves ledger object identified by a given ledger index.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/ledger/{LEDGER_INDEX}
GET /api/v1/ledger/{LEDGER_HASH}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/ledger/80000000
curl https://api.xrpscan.com/api/v1/ledger/DB978F031B...14858A55DF
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "ledger_index": 80000000,
  "ledger_hash": "DB978F031BB14734213998060E077D5F813358222DAB07CA8148588D852A55DF",
  "close_flags": 0,
  "close_time": 1684953531,
  "close_time_human": "2023-05-24T18:38:51.000Z",
  "close_time_resolution": 10,
  "parent_close_time": 1684953530,
  "parent_hash": "E70235CEAA964202C74CD81132C69F8F44FE539F9E347F82AA3131410B7CDBEF",
  "transaction_hash": "CDA48280EF5F88BC86164A77E1072296899B384619D552445D71C922026A3E8C",
  "tx_count": 36,
  "total_coins": 99988894618845390
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `ledger` command.

{% embed url="<https://xrpl.org/ledger.html#response-format>" %}


# Transactions

This endpoint retrieves transactions included in a ledger identified by a given ledger index.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/ledger/{LEDGER_INDEX}/transactions
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/ledger/80000000/transactions
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "TakerPays": {
      "currency": "CNY",
      "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
      "value": 3278400
    },
    "TakerGets": {
      "value": 1000000000000,
      "currency": "XRP"
    },
    "meta": {
      "TransactionIndex": 0,
      "TransactionResult": "tesSUCCESS"
    },
    "NFTokenOffers": [],
    "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM",
    "Fee": 15,
    "Flags": 0,
    "LastLedgerSequence": 80000002,
    "OfferSequence": 25577103,
    "Sequence": 25577104,
    "SigningPubKey": "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE",
    "TransactionType": "OfferCreate",
    "TxnSignature": "3045022100C8D2CF74DFD1E5029AB0F3BD6469374F4658BFA6A93132167EB16864C6AEC4BE022074219E9C87A651883C98B40329EF546912A33F478C3F6FBE9BFE838AF4667319",
    "hash": "0BE1E6647EE9D851880706B1F1229F0CF21ADF3CD53AAB1BCD1408C68F899C28",
    "ledger_index": 80000000,
    "date": "2023-05-24T18:38:51.000Z",
    "Signers": [],
    "AccountName": null,
    "DestinationName": null,
    "AmendmentName": null,
    "SigningPubKeyAccount": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM"
  },
  {
    "Amount": {
      "value": 35724138,
      "currency": "XRP"
    },
    "meta": {
      "delivered_amount": {
        "value": 35724138,
        "currency": "XRP"
      },
      "TransactionIndex": 23,
      "TransactionResult": "tesSUCCESS"
    },
    "NFTokenOffers": [],
    "Account": "rNU4eAowPuixS5ZCWaRL72UUeKgxcKExpK",
    "Destination": "rCoinaUERUrXb1aA7dJu8qRcmvPNiKS3d",
    "DestinationTag": 1628386574,
    "Fee": 3000,
    "Flags": 0,
    "LastLedgerSequence": 80000013,
    "Sequence": 71192568,
    "SigningPubKey": "02750F6E5C9BEDA0B47748CCB0BB3013D7FB48443C6A6420405AB2BC578A22B8DC",
    "TransactionType": "Payment",
    "TxnSignature": "304402204CEF2D362BE2E32A381B849D3FA22813F276D393089719472C12CD7CEB09B6E60220489F5A43807E990205464BABFB9FDB61E6AB88A9AFE63E9B4056729F0038EC00",
    "hash": "537532D3E7B84D069E8C2C3C7A7E8F30DD2614C644743B70F9743FCFCF58F6F8",
    "ledger_index": 80000000,
    "date": "2023-05-24T18:38:51.000Z",
    "Signers": [],
    "AccountName": {
      "name": "Binance",
      "desc": "10",
      "account": "rNU4eAowPuixS5ZCWaRL72UUeKgxcKExpK",
      "domain": "binance.com",
      "twitter": "binance"
    },
    "DestinationName": {
      "name": "CoinPayments",
      "desc": "1",
      "account": "rCoinaUERUrXb1aA7dJu8qRcmvPNiKS3d",
      "domain": "coinpayments.net",
      "twitter": "CoinPaymentsNET",
      "verified": true
    },
    "AmendmentName": null,
    "SigningPubKeyAccount": "rNU4eAowPuixS5ZCWaRL72UUeKgxcKExpK"
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# NFT


# NFT info

This endpoint retrieves information about a given NFToken ID.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/nft/{NFTOKEN_ID}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/nft/000B00004B50699E253C5098DEFE3A0872A79D129172F4965B974D9E00000004
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "nft_id": "000B00004B50699E253C5098DEFE3A0872A79D129172F4965B974D9E00000004",
  "ledger_index": 77228176,
  "owner": "rf1NrYAsv92UPDd8nyCG4A3bez7dhYE61r",
  "is_burned": false,
  "flags": 11,
  "transfer_fee": 0,
  "issuer": "rf1NrYAsv92UPDd8nyCG4A3bez7dhYE61r",
  "nft_taxon": 1,
  "nft_serial": 4,
  "validated": true,
  "uri": "697066733A2F2F6261667962656965356A626736336A6164676979736337796B6B6A64737170777732746A6D786D7935377077716F6A697666356562366B6D6D79612F352E6A736F6E",
  "flags_parsed": [
    "tfBurnable",
    "tfOnlyXRP",
    "tfTransferable"
  ]
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on Clio `nft_info` command.

{% embed url="<https://xrpl.org/nft_info.html>" %}


# AMM


# AMM info

This endpoint retrieves information about a given AMM account

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/amm/{AMM_ACCOUNT}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/amm/rs9ineLqrCzeAGS1bxsrW8x2n3bRJYAh3Q
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "account": "rs9ineLqrCzeAGS1bxsrW8x2n3bRJYAh3Q",
  "amount": "14679296731",
  "amount2": {
    "currency": "USD",
    "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq",
    "value": "9043.349269355098"
  },
  "asset2_frozen": false,
  "auction_slot": {
    "account": "raBZQW4ZmhbhnjJFc6U7AQkCeTAHkmAP4y",
    "discounted_fee": 29,
    "expiration": "2024-03-25T12:08:50+0000",
    "price": {
      "currency": "03930D02208264E2E40EC1B0C09E4DB96EE197B1",
      "issuer": "rs9ineLqrCzeAGS1bxsrW8x2n3bRJYAh3Q",
      "value": "8670"
    },
    "time_interval": 20
  },
  "lp_token": {
    "currency": "03930D02208264E2E40EC1B0C09E4DB96EE197B1",
    "issuer": "rs9ineLqrCzeAGS1bxsrW8x2n3bRJYAh3Q",
    "value": "11108703.80455174"
  },
  "trading_fee": 290,
  "vote_slots": [
    {
      "account": "rBLPZR37M5rhKMLyeNqJZEHEivJob6ptFm",
      "trading_fee": 1000,
      "vote_weight": 5181
    },
    {
      "account": "rGgzn7VassmMM6vSzb5UqZbYbtegrkg5KB",
      "trading_fee": 100,
      "vote_weight": 19393
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled's `amm_info` command.

{% embed url="<https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/amm_info/>" %}


# Pools

This endpoint retrieves available AMM pools

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/amm/pools
```

{% endtab %}
{% endtabs %}

## Parameters

The endpoint supports custom result limit and pagination via `limit` and `offset` query parameters.

{% content-ref url="/pages/anIB0BJR7of6Qa6LqUKl" %}
[Pagination](/api-documentation/api-concepts/pagination)
{% endcontent-ref %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/amm/pools
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "Account": "rdrBYMcjBo9zVExL7V3DicH48FXgKW5RX",
    "Asset": {
      "currency": "XRP"
    },
    "Asset2": {
      "currency": "5852505300000000000000000000000000000000",
      "issuer": "rN1bCPAxHDvyJzvkUso1L2wvXufgE4gXPL"
    },
    "AuctionSlot": {
      "Account": "rKYZMwA5viogqKYpnSUpLJXag17KM27map",
      "DiscountedFee": 30,
      "Expiration": 764541201,
      "Price": {
        "currency": "036A7A7F2A97B4FA6DC31E9C00A24DF4436A76ED",
        "issuer": "rdrBYMcjBo9zVExL7V3DicH48FXgKW5RX",
        "value": "0"
      }
    },
    "Flags": 0,
    "LPTokenBalance": {
      "currency": "036A7A7F2A97B4FA6DC31E9C00A24DF4436A76ED",
      "issuer": "rdrBYMcjBo9zVExL7V3DicH48FXgKW5RX",
      "value": "895237102.9651812"
    },
    "OwnerNode": "0",
    "TradingFee": 300,
    "VoteSlots": [
      {
        "VoteEntry": {
          "Account": "rKYZMwA5viogqKYpnSUpLJXag17KM27map",
          "TradingFee": 300,
          "VoteWeight": 100000
        }
      }
    ],
    "index": "4147EE9748EC1E13566D445E1B9DB77540E34CA604423C12B1ADCF693C92B307",
    "Balance": 49149000774
  },
  ...
  ...
]
```

{% endtab %}
{% endtabs %}


# Token


# Token info

This endpoint retrieves information about a given (IOU) Token managed by a Trustline

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/token/{TOKEN_CODE}.{TOKEN_ISSUER}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/token/RLUSD.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "id": "524C555344000000000000000000000000000000.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
  "amms": 171,
  "code": "RLUSD",
  "createdAt": "2025-01-09T10:29:28.080Z",
  "currency": "524C555344000000000000000000000000000000",
  "holders": 33491,
  "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
  "token": "RLUSD.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
  "updatedAt": "2025-07-03T18:47:21.597Z",
  "blackholed": false,
  "marketcap": 28970634.053129405,
  "price": 0.4395789888276604,
  "supply": 65905411.2900003,
  "meta": {
    "token": {
      "description": "Ripple USD (RLUSD) is natively issued on the XRP Ledger and Ethereum blockchains and is enabled with a number of features to ensure strict adherence to compliance standards, flexibility for developers, and security for holders.",
      "icon": "https://s1.xrplmeta.org/icon/5CEA036903.png",
      "name": "Ripple USD",
      "trust_level": 3,
      "weblinks": [
        {
          "url": "https://ripple.com",
          "title": "Official Website"
        }
      ]
    },
    "issuer": {
      "description": "We're building the Internet of Value.",
      "icon": "https://s1.xrplmeta.org/icon/CAEB5E0CD8.jpg",
      "kyc": true,
      "name": "RLUSD",
      "trust_level": 3,
      "weblinks": [
        {
          "url": "https://twitter.com/Ripple",
          "type": "socialmedia"
        }
      ]
    }
  },
  "metrics": {
    "trustlines": 61019,
    "holders": 33427,
    "supply": "65905411.2900162",
    "marketcap": "30180789.9515613",
    "price": "0.457941",
    "volume_24h": "1130734.21792498",
    "volume_7d": "5623264.31269795",
    "exchanges_24h": 7423,
    "exchanges_7d": 44699,
    "takers_24h": 337,
    "takers_7d": 1195
  },
  "tomldata": {
    "METADATA": {
      "modified": "2022-05-19T14:09:02.000Z"
    },
    "ORGANIZATION": {
      "name": "Ripple",
      "website": "https://ripple.com",
      "twitter": "@ripple"
    },
    "PRINCIPALS": [
      {
        "name": "Ripple XRP Ledger Operations Team",
        "email": "xrpl-ops@ripple.com"
      }
    ],
    "VALIDATORS": [
      {
        "public_key": "nHU4bLE3EmSqNwfL4AP1UZeTNPrSPPP6FXLKXo2uqfHuvBQxDVKd",
        "attestation": "C8EB7DB8B51B5CDD86732A089BF0B1C6497F4F00BC39FFF34032630D6D43C08F03751917E9C140157E6A3AB7C62A88DF3B2FFF93E90A6C3E3A752492A8ADFC09",
        "owner_country": "US",
        "server_country": "US",
        "network": "main",
        "unl": "https://vl.ripple.com"
      },
      {
        "public_key": "nHUon2tpyJEHHYGmxqeGu37cvPYHzrMtUNQFVdCgGNvEkjmCpTqK",
        "owner_country": "US",
        "server_country": "SG",
        "network": "main",
        "unl": "https://vl.ripple.com"
      },
      {
        "public_key": "nHUUrjuEMtvzzTsiW2xKinUt7Jd83QFqYgfy3Feb7Hq1EJyoxoSz",
        "owner_country": "US",
        "server_country": "US",
        "network": "main",
        "unl": "https://vl.ripple.com"
      },
      {
        "public_key": "nHU2Y1mLGDvTbc2dpvpkQ16qdeTKv2aJwGJHFySSB9U3jkTmj4CA",
        "owner_country": "US",
        "server_country": "AU",
        "network": "main",
        "unl": "https://vl.ripple.com"
      }
    ],
    "SERVERS": [
      {
        "peer": "s1.ripple.com",
        "ws": "wss://s1.ripple.com/",
        "rpc": "https://s1.ripple.com:51234/",
        "network": "main",
        "port": 51235
      },
      {
        "peer": "s2.ripple.com",
        "ws": "wss://s2.ripple.com/",
        "rpc": "https://s2.ripple.com:51234/",
        "network": "main",
        "port": 51235
      }
    ],
    "ACCOUNTS": [
      {
        "address": "r9NpyVfLfUG8hatuCCHKzosyDtKnBdsEN3",
        "desc": "Ripple Escrow Wallet #01"
      },
      {
        "address": "r9UUEXn3cx2seufBkDa8F86usfjWM6HiYp",
        "desc": "Ripple Escrow Wallet #02"
      },
      {
        "address": "rB3WNZc45gxzW31zxfXdkx8HusAhoqscPn",
        "desc": "Ripple Escrow Wallet #03"
      },
      {
        "address": "rDdXiA3M4mYTQ4cFpWkVXfc2UaAXCFWeCK",
        "desc": "Ripple Escrow Wallet #04"
      },
      {
        "address": "rKDvgGUsNPZxsgmoemfrgXPS2Not4co2op",
        "desc": "Ripple Escrow Wallet #05"
      },
      {
        "address": "rKwJaGmB5Hz24Qs2iyCaTdUuL1WsEXUWy5",
        "desc": "Ripple Escrow Wallet #06"
      },
      {
        "address": "rN8pqRwLYuuvY7pUHurybPC8P6rLqVsu6o",
        "desc": "Ripple Escrow Wallet #07"
      },
      {
        "address": "rNASJdZjY9dToHnNURi3HAUku3duPwbtD1",
        "desc": "Ripple Escrow Wallet #08"
      },
      {
        "address": "rU9qmGM4Y6WWDhiNzkwVKBwwatcoE7YL1T",
        "desc": "Ripple Escrow Wallet #09"
      },
      {
        "address": "rfWPPQBYqYmoFMdVnjzXCagJbz5uajSBXL",
        "desc": "Ripple Escrow Wallet #10"
      },
      {
        "address": "rh2EsAe2xVE71ZBjx7oEL2zpD4zmSs3sY9",
        "desc": "Ripple Escrow Wallet #11"
      },
      {
        "address": "rhEwsCWDCVxDiKxGJAKM6VuXC8EFtJP5gQ",
        "desc": "Ripple Escrow Wallet #12"
      },
      {
        "address": "rncKvRcdDq9hVJpdLdTcKoxsS3NSkXsvfM",
        "desc": "Ripple Escrow Wallet #13"
      },
      {
        "address": "rp6aTJmW3nq1aKt3Jmuz4DPRxksT5PBjpH",
        "desc": "Ripple Escrow Wallet #14"
      },
      {
        "address": "rsjFB8mPWqiZgPUaVh8XYqdfa59PE2d5LG",
        "desc": "Ripple Escrow Wallet #15"
      },
      {
        "address": "rw2hzLZgiQ9q62KCuaTWuFHWfiX7JWg3wY",
        "desc": "Ripple Escrow Wallet #16"
      },
      {
        "address": "rDqGA2GfveHypDguQ1KXrJzYymFZmKxEsF",
        "desc": "Ripple Escrow Wallet #17"
      },
      {
        "address": "rGKHDyj4L6pc7DzRB6LWCR4YfZfzXj2Bdh",
        "desc": "Ripple Escrow Wallet #18"
      },
      {
        "address": "rHGfmgv54kpc3QCZGRXEQKUhLPndbasbQr",
        "desc": "Ripple Escrow Wallet #19"
      },
      {
        "address": "rMhkqz3DeU7GUUJKGZofusbrTwZe6bDyb1",
        "desc": "Ripple Escrow Wallet #20"
      }
    ],
    "ISSUERS": [
      {
        "address": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "name": "RLUSD"
      }
    ],
    "TOKENS": [
      {
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "currency": "RLUSD",
        "name": "Ripple USD",
        "desc": "Ripple USD (RLUSD) is natively issued on the XRP Ledger and Ethereum blockchains and is enabled with a number of features to ensure strict adherence to compliance standards, flexibility for developers, and security for holders.",
        "icon": "https://ripple.com/assets/rlusd-logo.png",
        "WEBLINKS": [
          {
            "url": "https://ripple.com",
            "type": "website",
            "title": "Official Website"
          }
        ]
      }
    ]
  },
  "disabled": false,
  "score": 0.4085713679973927,
  "IssuingAccount": {
    "name": "RLUSD",
    "desc": "Issuer",
    "account": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
    "domain": "ripple.com/solutions/stablecoin",
    "twitter": "Ripple",
    "verified": true
  }
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the `tomldata` field based on [XLS-26 standard](https://github.com/XRPLF/XRPL-Standards/discussions/71).


# Token list

This endpoint retrieves available Tokens managed by Trustlines.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/tokens
```

{% endtab %}
{% endtabs %}

## Parameters

The endpoint supports custom result limit and pagination via `limit` and `offset` query parameters.

{% content-ref url="/pages/anIB0BJR7of6Qa6LqUKl" %}
[Pagination](/api-documentation/api-concepts/pagination)
{% endcontent-ref %}

## Sorting results

The response may be sorted by passing the `sort` parameter. The `sort` parameter accepts the following values: `code` , `trustlines` , `holders` , `amms` ,`price` , `supply` , `marketcap` , `score` , `createdAt` , `updatedAt`&#x20;

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/tokens?sort=score
```

{% endtab %}
{% endtabs %}

Sort direction may be specified by passing `direction=asc` parameter for ascending order or `direction=desc` parameter for descending order.

## Example

{% tabs %}
{% tab title="curl" %}

<pre class="language-bash"><code class="lang-bash"><strong>curl https://api.xrpscan.com/api/v1/tokens?sort=score&#x26;direction=desc
</strong></code></pre>

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "id": "524C555344000000000000000000000000000000.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
    "amms": 171,
    "code": "RLUSD",
    "createdAt": "2025-01-09T10:29:28.080Z",
    "currency": "524C555344000000000000000000000000000000",
    "holders": 33491,
    "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
    "token": "RLUSD.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
    "updatedAt": "2025-07-03T18:47:21.597Z",
    "blackholed": false,
    "marketcap": 28970634.053129405,
    "price": 0.4395789888276604,
    "supply": 65905411.2900003,
    "meta": {
      "token": {
        "description": "Ripple USD (RLUSD) is natively issued on the XRP Ledger and Ethereum blockchains and is enabled with a number of features to ensure strict adherence to compliance standards, flexibility for developers, and security for holders.",
        "icon": "https://s1.xrplmeta.org/icon/5CEA036903.png",
        "name": "Ripple USD",
        "trust_level": 3,
        "weblinks": [
          {
            "url": "https://ripple.com",
            "title": "Official Website"
          }
        ]
      },
      "issuer": {
        "description": "We're building the Internet of Value.",
        "icon": "https://s1.xrplmeta.org/icon/CAEB5E0CD8.jpg",
        "kyc": true,
        "name": "RLUSD",
        "trust_level": 3,
        "weblinks": [
          {
            "url": "https://twitter.com/Ripple",
            "type": "socialmedia"
          }
        ]
      }
    },
    "metrics": {
      "trustlines": 61019,
      "holders": 33427,
      "supply": "65905411.2900162",
      "marketcap": "30180789.9515613",
      "price": "0.457941",
      "volume_24h": "1130734.21792498",
      "volume_7d": "5623264.31269795",
      "exchanges_24h": 7423,
      "exchanges_7d": 44699,
      "takers_24h": 337,
      "takers_7d": 1195
    },
    "disabled": false,
    "score": 0.4085713679973927,
    "IssuingAccount": {
      "name": "RLUSD",
      "desc": "Issuer",
      "account": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
      "domain": "ripple.com/solutions/stablecoin",
      "twitter": "Ripple",
      "verified": true
    }
  },
  ...
  ...
]
```

{% endtab %}
{% endtabs %}


# Token ranking

Our Token ranking process involves several steps to calculate a comprehensive score for each issued token.

**XRPScan Token Score** is available in token response as `score` field. Here's a breakdown of our proprietary token ranking process:

## 1. Configuration parameters

* Weights: Each metric (amms, trustlines, holding wallets, total supply, price, market capitalization) is assigned a `weight`. These weights determine how much influence each factor has on the final score. For instance, `holdingWallets` has the highest weight (0.4), indicating it's considered the most significant factor in our algorithm.
* Centralization Threshold: This is a crucial parameter (`1000` wallets in our case). If a token's `holdingWallets` count falls below this threshold, it starts incurring a penalty.
* Max Centralization Penalty: This defines the maximum percentage of the potential score that can be deducted due to centralization (for example, `0.3` or 30%).
* High Market Cap Threshold: This parameter is essential for penalizing outliers (For example, market capitalization more than `10,000,000,000` or 10 Billion XRP). Tokens with a market capitalization exceeding this value will incur an additional penalty.
* High Market Cap Penalty Percentage: The percentage of the `baseScore` that will be deducted if the `highMarketCapThreshold` is exceeded (for example,, `0.4` or 40%).
* Epsilon: A tiny value (`1e-9`) used to prevent errors when taking the logarithm of zero or very small numbers.

## 2. Log scaling

* Token metrics like `amms`, `trustlines`, `holdingWallets`, `totalSupply`, `price`, and `marketCap` can vary by many orders of magnitude. To prevent larger values from disproportionately dominating the score, the algorithm applies a `log10` (base-10 logarithm) transformation to each of these metrics. This compresses the range of values, making the scoring more balanced.
* For example, a jump from 100 to 1,000 holding wallets will have a similar impact on the log-scaled score as a jump from 1,000,000 to 10,000,000, rather than the raw difference.

## 3. Min-Max normalization

* After log scaling, the algorithm finds the minimum and maximum log-scaled values for each metric across *all* the tokens in the input list.
* Each log-scaled value is then normalized to a range between 0 and 1 using the min-max normalization formula: `(value - min) / (max - min)`. This ensures that all metrics contribute to the score on a comparable scale, regardless of their original magnitude. If all values for a metric are the same, it normalizes to 0.5 to provide a neutral impact.

## 4. Base score calculation

* The normalized log-scaled values for each token are multiplied by their respective `weights`.
* These weighted normalized values are then summed up to calculate a `baseScore`. This `baseScore` represents the token's performance across the key metrics before any centralization or market cap adjustments.

## 5. Centralization penalty

* This addresses the risk associated with too few token holders.
* If a token's `holdingWallets` count is below the `centralizationThreshold`, a penalty is calculated.
* The penalty increases as the number of holding wallets decreases further below the threshold. The formula:\
  &#x20;`maxCentralizationPenalty * (1 - (token.holdingWallets / centralizationThreshold))` \
  ensures that a token with very few holders gets a penalty closer to the `maxCentralizationPenalty`.

## 6. High MarketCap penalty

* This penalty is applied to tokens that exceed a certain market capitalization threshold.
* If a token's `marketCap` is greater than `highMarketCapThreshold` (for example, 10 Billion), a significant penalty is applied.
* The penalty is calculated as a percentage (`highMarketCapPenaltyPercentage`, e.g., 40%) of the `baseScore`. This aims to heavily penalize extremely large, potentially over-valued, or dominant tokens, depending on our adjustable ranking strategy.

## 7. Final score and ranking

* The `finalScore` is calculated by subtracting both the `centralizationPenalty` and the `highMarketCapPenalty` from the `baseScore`. We ensure that the score does not drop below zero.

XRPScan token scoring algorithm rewards tokens with higher numbers of holding wallets, larger total supplies, higher prices, and greater market capitalizations, while simultaneously penalizing those that exhibit signs of centralization (i.e., too few unique holders) or those that have reached an extremely high market capitalization, as defined by the configurable thresholds.


# Object


# Object info

This endpoint retrieves a single ledger object identified by its Object ID from the XRP Ledger in its raw format.

{% hint style="info" %}
Some ledger objects have static Object IDs. These objects may be retrieved by their special object IDs.
{% endhint %}

<table data-full-width="false"><thead><tr><th width="165.33333333333331">Object ID</th><th>Object hash</th></tr></thead><tbody><tr><td><code>FeeSettings</code></td><td><code>4BC50C9B0D8515D3EAAE1E74B29A95804346C491EE1A95BF25E4AAB854A6A651</code></td></tr><tr><td><code>Amendments</code></td><td><code>7DB0788C020F02780A673DC74757F23823FA3014C1866E72CC4CD8B226CD6EF4</code></td></tr><tr><td><code>NegativeUNL</code></td><td><code>2E8A59AA9D3B5B186B0B9E0F62E6C02587CA74A4D778938E957B6357D364B244</code></td></tr><tr><td><code>LedgerHashes</code></td><td><code>B4979A36CDC7F3D3D5C31A4EAE2AC7D7209DDA877588B9AFC66799692AB0D66B</code></td></tr></tbody></table>

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/object/{OBJECT_ID}
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/object/587E28972F3B63D2260C0671E59593EE6C4D27AB857D1AF230F5CAA959BB3EAC
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Named objects" %}
`curl https://api.xrpscan.com/api/v1/object/FeeSettings`
{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "index": "587E28972F3B63D2260C0671E59593EE6C4D27AB857D1AF230F5CAA959BB3EAC",
  "ledger_hash": "B8FD3B7CBB118A6147C7A82B83D1215B73B6069D33727BD34CA3AF43298126A3",
  "ledger_index": 81520079,
  "node": {
    "Account": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC",
    "Balance": "88307934814",
    "Flags": 0,
    "LedgerEntryType": "AccountRoot",
    "OwnerCount": 0,
    "PreviousTxnID": "8C30B3C6F526334309C7F6DE1131EF94D987762375116E0C184F840F03DDA974",
    "PreviousTxnLgrSeq": 81520079,
    "Sequence": 75897829,
    "index": "587E28972F3B63D2260C0671E59593EE6C4D27AB857D1AF230F5CAA959BB3EAC"
  },
  "validated": true
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `ledger_entry` command.

{% embed url="<https://xrpl.org/ledger_entry.html#response-format>" %}


# Amendment


# Amendments

This endpoint retrieves all amendments supported on the XRPL mainnet.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/amendments
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/amendments
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "amendment_id": "AE35ABDEFBDE520372B31C957020B34A7A4A9DC3115A69803A44016477C84D6E",
    "introduced": "1.11.0",
    "name": "fixNFTokenRemint",
    "count": 7,
    "enabled": false,
    "majority": null,
    "supported": true,
    "threshold": 28,
    "validations": 35
  },
  {
    "amendment_id": "47C3002ABA31628447E8E9A8B315FAA935CE30183F9A9B86845E469CA2CDC3DF",
    "introduced": "1.10.0",
    "name": "DisallowIncoming",
    "enabled": false,
    "majority": null,
    "supported": true,
    "count": 26,
    "threshold": 28,
    "validations": 35
  },
    {
    "amendment_id": "4C97EBA926031A7CF7D7B36FDE3ED66DDA5421192D63DE53FFB46E43B9DC8373",
    "enabled": true,
    "name": "MultiSign",
    "supported": true,
    "enabled_on": "2016-06-27T23:34:41.000Z",
    "introduced": "0.31.0",
    "tx_hash": "168F8B15F643395E59B9977FC99D6310E8708111C85659A9BAF8B9222EEAC5A7",
    "majority": null
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Amendment info

This endpoint retrieves a single amendment identified by its Amendment ID.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/amendment/{AMENDMENT_ID}
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/amendment/B4E4F5D2D6FB84DF7399960A732309C9FD530EAE5941838160042833625A6076
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "amendment_id": "B4E4F5D2D6FB84DF7399960A732309C9FD530EAE5941838160042833625A6076",
  "introduced": "1.7.3",
  "name": "NegativeUNL",
  "enabled": true,
  "majority": null,
  "supported": true,
  "count": 35,
  "threshold": 28,
  "validations": 36,
  "enabled_on": "2021-11-21T18:38:51.000Z",
  "tx_hash": "1500FADB73E7148191216C53040990E829C7110788B26E7F3246CB3660769EBA"
}
```

{% endtab %}
{% endtabs %}


# Validator


# Registry

This endpoint retrieves a list of all active validators.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/validatorregistry
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/validatorregistry
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "master_key": "nHUpDEZX5Zy9auiu4yhDmhirNu6PyB1LvzQEL9Mxmqjr818w663q",
    "chain": "main",
    "ephemeral_key": "n9LPSEVyNTApMuchFeTE1GD9qhsH9Umagnpu3NLC9zb358KNfiZV",
    "last_seen": "2023-07-31T12:28:38.931Z",
    "ledger_index": 81521454,
    "meta": {
      "manifest": "JAAAAAVxIe1YCtT6XamJ+pmVNezCAZeltToaSalx9mUu2NXUZspgXXMhAvLQl0WBMe0XSjFQPbqUXSiRBQwcypNu02I3WQMNj/9zdkYwRAIgSV2kfFs1r1TaHX/SUbx78vIq1nhyAiNS0GGu8nIaNi4CIGbCr/dXKdKjrdwoJYNDgf4tlMT094bhUUnpTzkNHWLPdwx4c3BlY3Rhci5jb21wEkApTowQiZRa8XXIDlEZ2RUqfF6JK1nNzMaAHz4zLBwa+ed17+kqmyOM+haosWBJO6oqwiKl46p7RW753XkrZ8gF",
      "verification_message": "Hostname/IP does not match certificate's altnames: Host: xspectar.com. is not in the cert's altnames: DNS:*.azurewebsites.net, DNS:*.scm.azurewebsites.net, DNS:*.azure-mobile.net, DNS:*.scm.azure-mobile.net, DNS:*.sso.azurewebsites.net",
      "verified": true
    },
    "server_version": {
      "implementation": "rippled",
      "major": 1,
      "minor": 11,
      "patch": 0,
      "version": "1.11.0",
      "version_full": "rippled-1.11.0"
    },
    "votes": {
      "amendments": [
        "2E2FB9CF8A44EB80F4694D38AADAE9B8B7ADAFD2F092E10068E61C98C4F092B0",
        "47C3002ABA31628447E8E9A8B315FAA935CE30183F9A9B86845E469CA2CDC3DF",
        "73761231F7F3D94EC3D8C63D91BDD0D89045C6F71B917D1925C01253515A6669",
        "75A7E01C505DD5A179DFE3E000A9B6F1EDDEB55A12F95579A23E15B15DC8BE5A",
        "93E516234E35E08CA689FA33A6D38E103881F8DCB53023F728C307AA89D515A7",
        "F1ED6B4A411D8B872E65B9DCB4C8B100375B0DD3D62D07192E011D6D7F339013"
      ]
    },
    "domain": "xspectar.com",
    "unl": [
      "vl.xrplf.org",
      "vl.ripple.com"
    ],
    "domain_legacy": "xspectar.com"
  },
  {
    "master_key": "nHBdXSF6YHAHSZUk7rvox6jwbvvyqBnsWGcewBtq8x1XuH6KXKXr",
    "chain": "main",
    "domain": "xrpvalidator.ftso.eu",
    "ephemeral_key": "n9MfeCuZK2ra5eJtFDtuCTnvxfsi85k4J3GXJ1TvRVr2o4EQeHMF",
    "last_seen": "2023-07-31T12:28:39.197Z",
    "ledger_index": 81521454,
    "meta": {
      "manifest": "JAAAAAJxIe0kh8AnrrWSIR31ZHToQaraDB9PBijoBO6fEuxOfFUZuXMhA1KqzeMXFIgOfqY2d+J7qzq24oruATCkmopCUMGJOEBldkYwRAIgCwa3VLJb/Dzkb2vyX/Z+uTQJU3P+KdCjagwKSLEguj4CIF00+9ztyp3KgV7MQmAi+nogs4f8rPbcG3SQAktWmscodxR4cnB2YWxpZGF0b3IuZnRzby5ldXASQJ4IcwxDN69Q4mkjemSlFX+mrNhsITvmeTyEP4f5E6WcE1u/WlDNCdqs/RDTG98eqyJE6MGUB76Qnxqb8Zi71QU=",
      "verified": true,
      "verification_message": "getaddrinfo ENOTFOUND xrpvalidator.ftso.eu"
    },
    "server_version": {
      "implementation": "rippled",
      "major": 1,
      "minor": 11,
      "patch": 0,
      "version": "1.11.0",
      "version_full": "rippled-1.11.0"
    },
    "unl": [
      "vl.xrplf.org",
      "vl.ripple.com"
    ],
    "votes": {
      "amendments": [
        "2E2FB9CF8A44EB80F4694D38AADAE9B8B7ADAFD2F092E10068E61C98C4F092B0",
        "47C3002ABA31628447E8E9A8B315FAA935CE30183F9A9B86845E469CA2CDC3DF",
        "73761231F7F3D94EC3D8C63D91BDD0D89045C6F71B917D1925C01253515A6669",
        "75A7E01C505DD5A179DFE3E000A9B6F1EDDEB55A12F95579A23E15B15DC8BE5A",
        "93E516234E35E08CA689FA33A6D38E103881F8DCB53023F728C307AA89D515A7",
        "F1ED6B4A411D8B872E65B9DCB4C8B100375B0DD3D62D07192E011D6D7F339013"
      ]
    },
    "domain_legacy": "xrpvalidator.ftso.eu"
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Validator info

This endpoint retrieves validator info for a given validator public key.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/validator/{VALIDATOR_PUBLIC_KEY}
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/validator/nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "validation_public_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
  "signing_key": "n9Jk38y9XCznqiLq53UjREJQbZWnz4Pvmph55GP5ofUPg3RG8eVr",
  "master_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
  "domain": "xrpscan.com",
  "chain": "main",
  "server_version": "1.11.0",
  "networks": "main",
  "current_index": 81521260,
  "agreement_1h": {
    "missed": 0,
    "total": 961,
    "score": "1.00000",
    "incomplete": false
  },
  "agreement_24h": {
    "missed": 0,
    "total": 22747,
    "score": "1.00000",
    "incomplete": false
  },
  "agreement_30day": {
    "missed": 1,
    "total": 677637,
    "score": "1.00000",
    "incomplete": false
  },
  "partial": false,
  "unl": "vl.ripple.com",
  "revoked": false,
  "result": "success"
}
```

{% endtab %}
{% endtabs %}


# Report

This endpoint retrieves validator agreement report for a given validator public key.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/validator/{PUBLIC_KEY}/reports
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/validator/nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz/reports
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "result": "success",
  "count": 844,
  "reports": [
    {
      "validation_public_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
      "date": "2023-07-31T23:00:00.000Z",
      "chain": "main",
      "score": "1.00000",
      "total": "10492",
      "missed": "0",
      "incomplete": true
    },
    {
      "validation_public_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
      "date": "2023-07-30T23:00:00.000Z",
      "chain": "main",
      "score": "1.00000",
      "total": "21810",
      "missed": "0",
      "incomplete": false
    },
    {
      "validation_public_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
      "date": "2023-07-29T23:00:00.000Z",
      "chain": "main",
      "score": "1.00000",
      "total": "22023",
      "missed": "0",
      "incomplete": false
    },
    {
      "validation_public_key": "nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz",
      "date": "2023-07-28T23:00:00.000Z",
      "chain": "main",
      "score": "1.00000",
      "total": "21720",
      "missed": "0",
      "incomplete": false
    },
    ...
  ]
}
```

{% endtab %}
{% endtabs %}


# Node


# Nodes

This endpoint retrieves a list of active nodes on the XRPL.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/nodes
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/nodes
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "public_key": "n9L4vDaq7Cfv2g5MEU3JwL3mMDeFygwXkN8wLKQRSoyFSGXX941r",
    "asn": "0",
    "complete_ledgers": "81520411-81520923",
    "ip": "0",
    "last_seen": "2023-07-31T11:55:14.000Z",
    "last_seen_unix": 1690804514,
    "server_version": "1.11.0",
    "version": "rippled-1.11.0"
  },
  {
    "public_key": "n944TqPBiNhdbHED7MUCeGL8LJcvKuMhczkZ5ZSNtNGmPg5yQTkP",
    "asn": "GOOGLE-CLOUD-PLATFORM",
    "complete_ledgers": "81371041-81520922",
    "ip": "35.246.88.112",
    "last_seen": "2023-07-31T11:55:14.000Z",
    "last_seen_unix": 1690804514,
    "server_version": "1.11.0",
    "version": "rippled-1.11.0"
  },
  {
    "public_key": "n9LWQ8GvAS34xdacPgyvAgbGGfsPkt957kzs2Bqx8oEy9TdSvan4",
    "asn": "GOOGLE",
    "complete_ledgers": "81520410-81520922",
    "ip": "34.147.87.0",
    "last_seen": "2023-07-31T11:55:14.000Z",
    "last_seen_unix": 1690804514,
    "server_version": "1.11.0",
    "version": "rippled-1.11.0"
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Node info

This endpoint retrieves node info for a given node public key.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/node/{NODE_PUBLIC_KEY}
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/node/n9L4vDaq7Cfv2g5MEU3JwL3mMDeFygwXkN8wLKQRSoyFSGXX941r
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "public_key": "n9L4vDaq7Cfv2g5MEU3JwL3mMDeFygwXkN8wLKQRSoyFSGXX941r",
  "asn": "0",
  "complete_ledgers": "81520411-81520923",
  "ip": "0",
  "last_seen": "2023-07-31T11:55:14.000Z",
  "last_seen_unix": 1690804514,
  "server_version": "1.11.0",
  "version": "rippled-1.11.0"
}
```

{% endtab %}
{% endtabs %}


# Network


# Fee

This endpoint retrieves the current state of the open-ledger requirements for the [transaction cost](https://xrpl.org/transaction-cost.html) (fee).

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/network/fee
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/network/fee
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "current_ledger_size": "41",
  "current_queue_size": "0",
  "drops": {
    "base_fee": "10",
    "median_fee": "5000",
    "minimum_fee": "10",
    "open_ledger_fee": "10"
  },
  "expected_ledger_size": "206",
  "ledger_current_index": 81539144,
  "levels": {
    "median_level": "128000",
    "minimum_level": "256",
    "open_ledger_level": "256",
    "reference_level": "256"
  },
  "max_queue_size": "4120"
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `fee` command.

{% embed url="<https://xrpl.org/fee.html#response-format>" %}


# Server info

This endpoint retrieves human-readable version of various information about the `rippled` server.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/network/server_info
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/network/server_info
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "info": {
    "build_version": "1.11.0",
    "complete_ledgers": "81504012-81539201",
    "initial_sync_duration_us": "102156474",
    "io_latency_ms": 1,
    "jq_trans_overflow": "0",
    "last_close": {
      "converge_time_s": 3,
      "proposers": 35
    },
    "load_factor": 1,
    "node_size": "huge",
    "peer_disconnects": "4",
    "peer_disconnects_resources": "0",
    "peers": 12,
    "pubkey_node": "n9LC3KrWgXWvTjZ5opGi8kUHRhsoZq7ZbXfMrhbcMAkUGVywMbBL",
    "pubkey_validator": "none",
    "server_state": "full",
    "server_state_duration_us": "662233177701",
    "time": "2023-Aug-01 07:22:23.479760 UTC",
    "uptime": 662335,
    "validated_ledger": {
      "age": 4,
      "base_fee_xrp": 0.00001,
      "hash": "D6B0A1283CF59F9A31307C9BFBC30D156B56819A279BA2ED2D8CC22EFA389B81",
      "reserve_base_xrp": 10,
      "reserve_inc_xrp": 2,
      "seq": 81539201
    },
    "validation_quorum": 28,
    "validator_list": {
      "count": 2,
      "expiration": "2023-Oct-24 00:00:00.000000000 UTC",
      "status": "active"
    }
  }
}
```

{% endtab %}
{% endtabs %}

## Response format

Additional properties may be available in the response based on rippled `server_info` command.

{% embed url="<https://xrpl.org/server_info.html#response-format>" %}


# Server versions

This endpoint retrieves a list of most recent rippled release versions.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/network/server_versions
```

{% endtab %}
{% endtabs %}

## Examples

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/network/server_versions
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  "1.11.0",
  "1.10.1",
  "1.10.0",
  "1.9.4",
  "1.9.3",
  "1.9.2",
  "1.9.1",
  "1.9.0",
  "1.8.5",
  "1.8.4",
  "1.8.3",
  "1.8.2",
  "1.8.1",
  "1.7.3",
  "1.7.2",
  "1.7.0",
  "1.6.0",
  "1.5.0",
  "1.4.0",
  "1.3.1",
  "1.3.0",
  "1.2.4",
  "1.2.3",
  "1.2.2",
  "1.2.1",
  "1.2.0",
  "1.1.2",
  "1.1.1",
  "1.1.0",
  "1.0.1",
  "1.0.0"
]
```

{% endtab %}
{% endtabs %}


# Account Name


# Well known accounts

This endpoint retrieves a list of well known accounts.

{% hint style="info" %}
Help us improve XRPSCAN. Submit information about well known XRP accounts (such as exchanges, bridges, liquidity pools, token issuers, FIs). This info would be used to label accounts and show profile picture (from X/Twitter) on account pages.

[Submit info →](https://docs.google.com/forms/d/e/1FAIpQLSexZkEn9A6rOcfxFDYIIB-Dp5hgE4z0qsmmNeiEkk6s2b2paQ/viewform)
{% endhint %}

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/names/well-known
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/names/well-known
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "name": "1xBet",
    "desc": "1",
    "account": "rP1afBEfikTz7hJh2ExCDni9W4Bx1dUMRk",
    "domain": "1xbet.com",
    "twitter": "1xbet_Eng",
    "verified": true
  },
  {
    "name": "1xBet",
    "desc": "2",
    "account": "rpE6gE8jEN1trDwQwe47VmgDL5y6m3XX2n",
    "domain": "1xbet.com",
    "twitter": "1xbet_Eng",
    "verified": true
  },
  {
    "name": "1xBit",
    "desc": "1",
    "account": "ra1CVNEG9gRgqJkLqgDv2GZ3Hw5LMuJo9B",
    "domain": "1xbit.com",
    "twitter": "1x_bit",
    "verified": true
  },
  {
    "name": "24Paybank",
    "desc": "1",
    "account": "rKs1E7iQxSk8wfEjXiWakZSF1HQUfewSDQ",
    "domain": "24paybank.net",
    "twitter": "24Paybank",
    "verified": true
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Balance


# Balances

Also known as XRP rich list.

This endpoint retrieves XRP balances for the top 10,000 active accounts in descending order of balance held. This list can also be used as "XRP *rich list*".&#x20;

{% hint style="info" %}
Account balances returned by this endpoint are not real time. This data is updated nightly.
{% endhint %}

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/balances
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/balances
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "account": "rMQ98K56yXJbDGv49ZSmW51sLn94Xe1mu1",
    "balance": 1960027030133974,
    "name": {
      "_id": "64436b3c0b75eabd8ea9640b",
      "name": "Ripple",
      "desc": "29",
      "account": "rMQ98K56yXJbDGv49ZSmW51sLn94Xe1mu1",
      "domain": "ripple.com",
      "twitter": "Ripple",
      "__v": 0
    }
  },
  {
    "account": "rKveEyR1SrkWbJX214xcfH43ZsoGMb3PEv",
    "balance": 1572294079629055,
    "name": {
      "_id": "64436b3c0b75eabd8ea96416",
      "name": "Ripple",
      "desc": "39",
      "account": "rKveEyR1SrkWbJX214xcfH43ZsoGMb3PEv",
      "domain": "ripple.com",
      "twitter": "Ripple",
      "__v": 0
    }
  },
  {
    "account": "rEy8TFcrAPvhpKrwyrscNYyqBGUkE9hKaJ",
    "balance": 1477168712041960,
    "name": {
      "_id": "64436b3c0b75eabd8ea96065",
      "name": "Binance",
      "desc": "4",
      "account": "rEy8TFcrAPvhpKrwyrscNYyqBGUkE9hKaJ",
      "domain": "binance.com",
      "twitter": "binance",
      "__v": 0
    }
  },
  {
    "account": "rBEc94rUFfLfTDwwGN7rQGBHc883c2QHhx",
    "balance": 1372766273535760,
    "name": {
      "_id": "64436b3c0b75eabd8ea964dd",
      "name": "Uphold",
      "desc": "4",
      "account": "rBEc94rUFfLfTDwwGN7rQGBHc883c2QHhx",
      "domain": "uphold.com",
      "twitter": "UpholdInc",
      "__v": 0
    }
  },
  ...
]
```

{% endtab %}
{% endtabs %}

## Response format

Individual account's `balance` property is represented in *drops* of XRP, where each drop is equal to `0.000001 XRP` . To convert Drop unit to XRP unit, divide the amount by `1000000`.

{% embed url="<https://xrpl.org/currency-formats.html#xrp-amounts>" %}


# Fact


# Facts in namespace

This endpoint retrieves a list of known facts for a given namespace. List of supported namespaces is available below.

<table data-full-width="false"><thead><tr><th width="165.33333333333331">Namespace ID</th><th>Description</th></tr></thead><tbody><tr><td><code>AMM</code></td><td>AMM facts</td></tr><tr><td><code>ObjectCount</code></td><td>XRP ledger object counts </td></tr><tr><td><code>XRP</code></td><td>XRP distribution facts</td></tr></tbody></table>

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/fact/{NAMESPACE_ID}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/fact/ObjectCount
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "AccountRoot": "4720986",
  "DirectoryNode": "2473626",
  "Offer": "136748",
  "NFTokenPage": "84894",
  "RippleState": "6391527",
  "NFTokenOffer": "161814",
  "SignerList": "72683",
  "Ticket": "32063",
  "LedgerHashes": "1245",
  "Escrow": "10015",
  "PayChannel": "2407",
  "Check": "16",
  "DepositPreauth": "51",
  "NegativeUNL": "1",
  "FeeSettings": "1",
  "Amendments": "1"
}
```

{% endtab %}
{% endtabs %}


# Fact

This endpoint retrieves a specific fact stored under a given namespace. List of [supported namespaces](/api-documentation/fact/fact) is available.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/fact/{NAMESPACE_ID}/{FACT_ID}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/fact/ObjectCount/AccountRoot
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "value": "4720986"
}
```

{% endtab %}
{% endtabs %}


# Metrics


# Metrics

This endpoint retrieves historical ledger metrics for a given metrics ID.

<table data-full-width="false"><thead><tr><th width="165.33333333333331">Metrics ID</th><th>Description</th></tr></thead><tbody><tr><td><code>metric</code></td><td>Aggregate ledger metrics</td></tr><tr><td><code>type</code></td><td>Transaction type metrics</td></tr><tr><td><code>result</code></td><td>Transaction result metrics</td></tr><tr><td><code>amm</code></td><td>AMM metrics</td></tr></tbody></table>

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/metrics/{METRIC_ID}
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/metrics/metric
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
[
  {
    "date": "2013-01-02T00:00:00.000Z",
    "metric": {
      "accounts_created": 3,
      "ledger_count": 4703,
      "ledger_interval": 18.371252392090156,
      "payments_count": 3,
      "transaction_count": 18,
      "tx_per_ledger": 0.0038273442483521157
    }
  },
  {
    "date": "2013-01-03T00:00:00.000Z",
    "metric": {
      "accounts_created": 6,
      "ledger_count": 4780,
      "ledger_interval": 18.07531380753138,
      "payments_count": 7,
      "transaction_count": 10,
      "tx_per_ledger": 0.0020920502092050207
    }
  },
  {
    "date": "2013-01-04T00:00:00.000Z",
    "metric": {
      "accounts_created": 2,
      "ledger_count": 4024,
      "ledger_interval": 21.468687872763418,
      "payments_count": 8,
      "transaction_count": 19,
      "tx_per_ledger": 0.004721669980119284
    }
  },
  ...
]
```

{% endtab %}
{% endtabs %}


# Health


# Ping

This endpoint retrieves API service health status.

## Request

{% tabs %}
{% tab title="GET" %}

```
GET /api/v1/ping
```

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="curl" %}

```
curl https://api.xrpscan.com/api/v1/ping
```

{% endtab %}
{% endtabs %}

## Response

{% tabs %}
{% tab title="JSON" %}

```json
{
  "status": "OK"
}
```

{% endtab %}
{% endtabs %}


# Advanced search API

Integrate advanced search in your applications.

## Elasticsearch Query

Example: Search for all `Payment` transactions with `DestinationTag` value equal to `1337`:

{% tabs %}
{% tab title="ES Query" %}

```shell
curl -XPOST 'https://console.xrpscan.com/api/v1/search' -d '
{
  "bool": {
    "must": [
      { "term": { "TransactionType": "Payment" } },
      { "term": { "DestinationTag": 1337 } }
    ]
  }
}'
```

{% endtab %}
{% endtabs %}

## Response

```json
{
  "took": 31,
  "timed_out": false,
  "_shards": {
    "total": 98,
    "successful": 98,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 7382,
      "relation": "eq"
    },
    "max_score": null,
    "hits": [
      {
        "_index": "platform.xrpl.transactions-97m",
        "_id": "F2E402B43EDE6EA9E7BD87CDCAA4236834E89236F8ACB3445F558534741C3012",
        "_score": 1.4392471,
        "_source": {
          "Account": "rJHkpNJVRUKMGV3NV6FNccySKNwEFF9C4c",
          "Amount": {
            "_currency": "XRP",
            "_value": 176032.226409,
            "currency": "XRP",
            "native": true,
            "value": "176032226409"
          },
          "DeliverMax": {
            "_currency": "XRP",
            "_value": 176032.226409,
            "currency": "XRP",
            "native": true,
            "value": "176032226409"
          },
          "Destination": "rLHzPsX6oXkzU2qL12kHCH8G8cnZv1rBJh",
          "DestinationTag": 1337,
          "Fee": 24,
                    "Flags": 2147483648,
          "LastLedgerSequence": 97359736,
          "Sequence": 89292640,
          "SigningPubKey": "02ED1CCA3DBC1971D38E72ECF74452739C9A4FD8C77EC2E3C5C4561371BF7B1ADF",
          "TransactionType": "Payment",
          "TxnSignature": "304502210097F5922FA7E0EF817EA5FC678A82766798C3BE0AAC636A2CACE846A98CBED83A02206BC6D2CB3ED8E8E5306D342063549C2BC16F6421B87AA80AAAA9D1F4E457E
619",
          "_Fee": 0.000024,
          "_date": "2025-07-08T12:02:02Z",
          "ctid": "C5CD330800420000",
          "date": 805291322,
          "hash": "F2E402B43EDE6EA9E7BD87CDCAA4236834E89236F8ACB3445F558534741C3012",
          "ledger_index": 97334024,
          "meta": {
            "TransactionIndex": 66,
            "TransactionResult": "tesSUCCESS",
            "delivered_amount": {
              "_currency": "XRP",
              "_value": 176032.226409,
              "currency": "XRP",
              "native": true,
              "value": "176032226409"
            }
          },
          "validated": true
        },
        "sort": [
          97334024,
          1.4392471
        ]
      },
      ...
      ...
    ]
  }
}
```

## SQL Query

The advanced search API also supports limited SQL queries. Example: Search all transactions where `DestinationTag` = 1337

{% tabs %}
{% tab title="Elasticsearch SQL" %}

```javascript
curl -XPOST 'https://console.xrpscan.com/api/v1/sql' -d '
{
  "format": "text",
  "query": "SELECT ctid, Account, Destination, DestinationTag FROM \"platform.xrpl.transactions\" WHERE DestinationTag = 1337 LIMIT 10"
}
'
```

{% endtab %}
{% endtabs %}

The `format` parameter supports following values: `csv` `json` `tsv` `txt` `text` `yaml` `cbor` `smile`.

## Response

```
      ctid      |             Account              |           Destination            |DestinationTag
----------------+----------------------------------+----------------------------------+---------------
C2356DB500090000|rJb5KsHsDHF1YS5B5DU6QCkH5NsPaKQTcy|rDGfU2vjzieWac1drAvLKge8hQLPK7Wgcy|1337
C4E453B300080000|rpz1PivxjVPbuF8yUsBqj1kk6y7NaQLLQt|rNhUFBAAZagSP91YRQA7sxjMMVHQS3GbZE|1337
C502D19300060000|rPVMhWBsfF9iMXYj3aAzJVkPDTFNSyWdKy|rNdzyWuUChAcdRzSnTKT3SbWcdDSZLfrun|1337
C235D16A00110000|rJb5KsHsDHF1YS5B5DU6QCkH5NsPaKQTcy|rDGfU2vjzieWac1drAvLKge8hQLPK7Wgcy|1337
C32A699B00280000|rfwWwz7yrvBCVY1RWdnZ4Uk1va7WpiWxNX|rJ3MkSEBzjkQdecHUr6svQwwTX79WEE2gd|1337
C284C741000B0000|rG8orpd1A58Tk5j3Atx9WEizt2AFW4THCT|rsCSfPvKsFmiRBcDUo8tU2vx96nuSes7Vx|1337
C4E44FE400060000|rLSn6Z3T8uCxbcd1oxwfGQN1Fdn5CyGujK|rNhUFBAAZagSP91YRQA7sxjMMVHQS3GbZE|1337
C4E4506400110000|rLSn6Z3T8uCxbcd1oxwfGQN1Fdn5CyGujK|rNhUFBAAZagSP91YRQA7sxjMMVHQS3GbZE|1337
C4E450CA002A0000|rLSn6Z3T8uCxbcd1oxwfGQN1Fdn5CyGujK|rNhUFBAAZagSP91YRQA7sxjMMVHQS3GbZE|1337
C235D1C700370000|rPdvC6ccq8hCdPKSPJkPmyZ4Mi1oG2FFkT|rQHYSEyxX3GKK3F6sXRvdd2NHhUqaxtC6F|1337
```


# Integration guide

Integrate XRPSCAN in your application.

{% hint style="success" %}
Do you work at a Bank, Financial Institution or a Cryptocurrency Exchange? Its easy to integrate XRPSCAN in your application. We support deep links for accounts, transactions, ledgers, amendments, NFTs and validator nodes. All pages support desktop as well as mobile layouts.
{% endhint %}

## Account

To link to an account, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/account/{ACCOUNT}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/account/{ACCOUNT}
```

{% endcode %}

> [`https://xrpscan.com/account/rGeyCsqc6vKXuyTGF39WJxmTRemoV3c97h`](https://xrpscan.com/account/rGeyCsqc6vKXuyTGF39WJxmTRemoV3c97h)

`ACCOUNT` in the XRP Ledger is identified by an address in the Base58 format. An account address has the following properties:

* A string of length between 25 to 35 characters.
* Starts with the character `r`.
* Is case sensitive.
* Uses alphanumeric characters, excluding the number `0` capital letter `O`, capital letter `I`, and lowercase letter `l`.

## Transaction

To link to an transaction, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/tx/{TRANSACTION_HASH}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/tx/{TRANSACTION_HASH}
```

{% endcode %}

> [`https://xrpscan.com/tx/5A9E938DB7DA6193446A383898C7A66518E9FCE65DFFD82DF0B7E65844F3EB61`](https://xrpscan.com/tx/5A9E938DB7DA6193446A383898C7A66518E9FCE65DFFD82DF0B7E65844F3EB61)

`TRANSACTION_HASH` in the XRP Ledger is identified by a 64 characters long string. A transaction hash has the following properties:

* A string exactly 64 characters in length.
* Hex character set: `0-9` and `A-F`.
* Not case sensitive, but typically written in upper case letters.

In lieu of transaction hash, it is also possible to use Compact Transaction Identifier (`CTID`) to link to a transaction.

> [`https://xrpscan.com/tx/C2D1AC8600270000`](https://xrpscan.com/tx/C2D1AC8600270000)

## Token

To link to a Token issued on XRPL, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/token/{TOKEN_CODE}.{TOKEN_ISSUER}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/token/{TOKEN_CODE}.{TOKEN_ISSUER}
```

{% endcode %}

> [`https://xrpscan.com/token/RLUSD.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De`](https://xrpscan.com/token/RLUSD.rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De)

`TOKEN_ISSUER` is the r-Address of the account that issued the token. `TOKEN_CODE` is the Token code.  `TOKEN_CODE` can be any of the following:

* 3-character ISO 4217 currency code
* 3-character non standard currency code
* 160-bit (40-character) hexadecimal currency code
* 4-character to 40-character decoded currency code

## Ledger

To link to a Transaction, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/ledger/{LEDGER_INDEX}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/ledger/{LEDGER_INDEX}
```

{% endcode %}

> [`https://xrpscan.com/ledger/81234567`](https://xrpscan.com/ledger/81234567)

`LEDGER_INDEX` in the XRP Ledger is identified by a 32 bit unsigned integer. string. A ledger index has the following properties:

* A number between `32,570` and `4,294,967,295`.
* Must be less than the last closed ledger index.

## NFT

To link to a NFT, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/nft/{NFTOKEN_ID}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/nft/{NFTOKEN_ID}
```

{% endcode %}

> [`https://xrpscan.com/nft/000B00004B50699E253C5098DEFE3A0872A79D129172F4965B974D9E00000004`](https://xrpscan.com/nft/000B00004B50699E253C5098DEFE3A0872A79D129172F4965B974D9E00000004)

`NFTOKEN_ID` in the XRP Ledger is identified by a 64 characters long string. A NFToken ID has the following properties:

* A string exactly 64 characters in length.
* Hex character set: `0-9` and `A-F`.

## Validator

To link to a Validator, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/validator/{VALIDATOR_PUBLIC_KEY}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/validator/{VALIDATOR_PUBLIC_KEY}
```

{% endcode %}

> [`https://xrpscan.com/validator/nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz`](https://xrpscan.com/validator/nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz)

`VALIDATOR_PUBLIC_KEY` in the XRP Ledger is identified by upto 53 characters long string in Base68 format. A Validator public key has the following properties:

* A string in Base58, upto 53 characters in length.
* Starts with the character `n`, commonly followed by `H`.
* Is case sensitive.
* Uses alphanumeric characters, excluding the number `0` capital letter `O`, capital letter `I`, and lowercase letter `l`.

## Amendment

To link to an Amendment, construct a URL like this:

{% code title="Mainnet" %}

```
https://xrpscan.com/amendment/{AMENDMENT_ID}
```

{% endcode %}

{% code title="Testnet" %}

```
https://testnet.xrpscan.com/amendment/{AMENDMENT_ID}
```

{% endcode %}

> [`https://xrpscan.com/amendment/30CD365592B8EE40489BA01AE2F7555CAC9C983145871DC82A42A31CF5BAE7D9`](https://xrpscan.com/amendment/30CD365592B8EE40489BA01AE2F7555CAC9C983145871DC82A42A31CF5BAE7D9)

`AMENDMENT_ID` in the XRP Ledger is identified by upto 64 charcters long string. An Amendment ID has the following properties:

* A string exactly 64 characters in length.
* Hex character set: `0-9` and `A-F`.
* Case sensitive.


# Validator

We run a XRPL validator at [xrpscan.com](https://xrpscan.com/validator/nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz) that’s included in [XRPL Foundation](https://vl.xrplf.org/)'s and [Ripple’s](https://vl.ripple.com) recommended node list (UNL). Our validator master key is:

```
nHDB2PAPYqF86j9j3c6w1F1ZqwvQfiWcFShZ9Pokg9q4ohNDSkAz
```

## Validator's properties

1. Long history of availability and agreement
2. High I/O NVMe SSD disks in RAID configuration
3. Dedicated server that only runs `rippled` and `sshd`
4. Connected to the internet backbone via 1 GBit/s connection
5. Peers with several highly trusted XRPL hubs
6. Geographically located in a commercial data center near Helsinki, Finland
7. CentOS 7 with regular OS updates
8. Timely and coordinated rippled upgrades
9. Active participation in amendment voting
10. Independently operated - Not affiliated with Ripple, Inc or XRPL Foundation

{% hint style="info" %}
The API service that powers xrpscan.com website runs a separate rippled node that is completely isolated from this validating node.
{% endhint %}

## Contact operator

For transparency, we’re happy to answer any questions related to the validating node. [Contact us](/help/contact-us).


# Contribute

We accept contributions from the community including bug reports, feature requests and exchange account identification.

### Feature requests

If you wish to report a bug or request a new feature:

1. Check for open requests or open a fresh issue to start a discussion around a feature idea or a bug: [Github tracker](https://github.com/xrpscan/xrpscan.com/issues).
2. Or reach out to us: [Contact us](/help/contact-us)

### Account identification

Help us improve XRPSCAN. Submit information about well known XRP accounts (for example exchanges, bridges, AMM pools, liquidity pools, token issuers, FIs). This info would be used to label accounts and show avatars (from X/Twitter) on account pages.

Please report unidentified/new accounts via this [Google form →](https://docs.google.com/forms/d/e/1FAIpQLSexZkEn9A6rOcfxFDYIIB-Dp5hgE4z0qsmmNeiEkk6s2b2paQ/viewform)


# Privacy policy

This page informs you of our policies regarding the collection, use and disclosure of Personal Information when you use our Service.

{% hint style="info" %}
Effective date: 01 July, 2025
{% endhint %}

Scrambled Egg Technologies ("us", "we", or "our") operates the [https://xrpscan.com](https://xrpscan.com/) website (the "Service"), hereinafter also known as "**XRPScan**".

At XRPScan, your privacy is important to us. This Privacy Policy outlines how we collect, use, and safeguard your information when you use our website. XRPScan is a public blockchain explorer for the XRP Ledger, and we are committed to ensuring that your personal information is protected. We will not use or share your information with anyone except as described in this Privacy Policy.

We use your Personal Information for providing and improving the Service. By using the Service, you agree to the collection and use of information in accordance with this policy. Unless otherwise defined in this Privacy Policy, terms used in this Privacy Policy have the same meanings as in our Terms and Conditions, accessible at <https://docs.xrpscan.com/help/privacy-policy>

## Information Collection And Use

While using our Service, we may ask you to provide us with certain personally identifiable information that can be used to contact or identify you. Personally identifiable information may include, but is not limited to, your XRP account address, transaction hashes, your email address, other information ("Personal Information").

## Log Data

We collect information that your browser sends whenever you visit our Service ("Log Data"). This Log Data may include information such as your computer's Internet Protocol ("IP") address, browser type, browser version, the pages of our Service that you visit, the time and date of your visit, the time spent on those pages and other statistics.

In addition, we may use third party services such as Google Analytics that collect, monitor and analyze this type of information in order to increase our Service's functionality. These third party service providers have their own privacy policies addressing how they use such information.

## Website analytics

We use Google Analytics to understand general usage trends and improve the performance and usability of our site. Google Analytics may collect non-personally identifiable information such as:

* Browser type and version
* Operating system
* Referring website
* Pages visited on XRPScan
* Time spent on pages

This data helps us better understand how users interact with our website and make improvements accordingly.

Google Analytics may set cookies in your browser. For more information about how Google handles data collected via its analytics service, please refer to [Google’s Privacy Policy](https://policies.google.com/privacy). You can opt out of Google Analytics by installing the Google Analytics Opt-out Browser Add-on.

## Cookies

Cookies are files with small amount of data, which may include an anonymous unique identifier. Cookies are sent to your browser from a web site and stored on your computer's hard drive.

We use "cookies" to collect information. You can instruct your browser to refuse all cookies or to indicate when a cookie is being sent. However, if you do not accept cookies, you may not be able to use some portions of our Service.

## Service Providers

We may employ third party companies and individuals to facilitate our Service, to provide the Service on our behalf, to perform Service-related services or to assist us in analyzing how our Service is used.

These third parties have access to your Personal Information only to perform these tasks on our behalf and are obligated not to disclose or use it for any other purpose.

## Communications

We may use your Personal Information to contact you with newsletters, marketing or promotional materials and other information that may be of interest to you. You may opt out of receiving any, or all, of these communications from us by following the unsubscribe link or instructions provided in any email we send.

## Security

The security of your Personal Information is important to us, but remember that no method of transmission over the Internet, or method of electronic storage is 100% secure. While we strive to use commercially acceptable means to protect your Personal Information, we cannot guarantee its absolute security.

## International Transfer

Your information, including Personal Information, may be transferred to — and maintained on — computers located outside of your state, province, country or other governmental jurisdiction where the data protection laws may differ than those from your jurisdiction.

Your consent to this Privacy Policy followed by your submission of such information represents your agreement to that transfer.

## Links To Other Sites

Our Service may contain links to other sites that are not operated by us. If you click on a third party link, you will be directed to that third party's site. We strongly advise you to review the Privacy Policy of every site you visit.

We have no control over, and assume no responsibility for the content, privacy policies or practices of any third party sites or services.

## Button Advertisements and Affiliate Links

XRPScan may display button advertisements and affiliate links to third-party products or services. These may include promotions for wallets, exchanges, or tools relevant to the XRP Ledger ecosystem.

* Clicking on these links may redirect you to third-party websites.
* Some links may be affiliate links, meaning XRPScan could receive a commission if you make a purchase or sign up for a service through the link.
* These third-party sites may collect data in accordance with their own privacy policies, and we encourage you to review those policies before interacting with them.
* XRPScan does not track which users click on ads or affiliate links.

## Children's Privacy

Our Service does not address anyone under the age of 13 ("Children").

We do not knowingly collect personally identifiable information from children under 13. If you are a parent or guardian and you are aware that your Children has provided us with Personal Information, please contact us. If we become aware that we have collected Personal Information from a children under age 13 without verification of parental consent, we take steps to remove that information from our servers.

## Changes To This Privacy Policy

We may update our Privacy Policy from time to time. We will notify you of any changes by posting the new Privacy Policy on this page.

You are advised to review this Privacy Policy periodically for any changes. Changes to this Privacy Policy are effective when they are posted on this page.

## Contact Us

If you have any questions about this Privacy Policy, please contact us at <support@xrpscan.com>.


# Terms of service

This page informs you of our terms of service regarding usage of our XRP block explorer service.

{% hint style="info" %}
Effective date: 01 July, 2025
{% endhint %}

Scrambled Egg Technologies ("us", "we", or "our") operates the [https://xrpscan.com](https://xrpscan.com/) website (the "Service"), hereinafter also known as "**XRPScan**".

Welcome to XRPScan, a blockchain explorer and analytics platform for the XRP Ledger. By accessing or using XRPScan (the “Service”), you agree to comply with and be bound by the following Terms of Service (“Terms”). If you do not agree to these Terms, please do not use our Service.

### 1. **Acceptance of Terms**

By using XRPScan, you affirm that you are of legal age and are capable of entering into a binding legal agreement. These Terms govern your access to and use of the XRPScan website and its related services, features, and content.

### 2. **Changes to the Terms**

XRPScan reserves the right to modify these Terms at any time. Updates will be posted on this page with the revised effective date. Continued use of the Service after any changes constitutes acceptance of those changes.

### 3. **Use of the Service**

XRPScan provides access to information related to the XRP Ledger including, but not limited to, transaction details, account balances, analytics, charts, and graphs. The data is presented as-is and without warranties of any kind.

### 4. **Prohibited Activities and Website Scraping**

You agree not to engage in any of the following activities while using the Service:

* Accessing or attempting to access data not intended for you.
* Attempting to probe, scan, or test the vulnerability of the XRPScan infrastructure.
* Using any automated tools, bots, scrapers, spiders, or similar data extraction methods to access the site or its data.
* Mirroring or framing the website or any part of it.
* Circumventing or attempting to circumvent any rate limiting, access controls, or security mechanisms.
* Overloading or disrupting XRPScan infrastructure, including excessive API requests.

**Website scraping of any kind is strictly prohibited.** XRPScan uses protective measures to detect and block unauthorized automated access. Violators may be blocked and subject to legal action.

We offer free, paid as well as pay as you go API plans. For accessing XRPScan data programmatically, please check out our [API plans](/api-documentation/pricing).

### 5. **Acceptable Use Policy**

You agree to use XRPScan in accordance with the following principles:

* **Lawfulness**: You may not use the Service for unlawful purposes or to promote illegal activities.
* **Integrity**: Do not impersonate others or misrepresent your affiliation with any person or organization.
* **Respect**: You may not use the Service to transmit any content that is defamatory, harassing, abusive, hateful, or promotes discrimination.
* **Security**: You may not use the Service to distribute viruses, malware, or any other harmful code.
* **Fair Use**: You must not access the Service in a way that imposes an unreasonable load on our infrastructure.

Violation of this Acceptable Use Policy may result in suspension or termination of your access to XRPScan without notice.

### 6. **Reproduction and Attribution**

#### 6.1 Reproduction of Content

Unless otherwise indicated, all content on XRPScan—including charts, graphs, screenshots, and visualizations—is the intellectual property of XRPScan and is protected by applicable copyright and trademark laws.

You may reproduce or redistribute content **only** under the following conditions:

* **Non-commercial use**: You may use XRPScan content for personal or non-commercial educational use.
* **No modification**: You must not alter the graphs, charts, or screenshots in a way that misrepresents the data or source.
* **No redistribution at scale**: Bulk reproduction, resale, or redistribution in commercial or enterprise contexts is strictly prohibited without prior written consent from XRPScan.

#### 6.2 Attribution Requirements

When reproducing or referencing content from XRPScan, you must:

* Provide a clear, visible attribution such as:

  > “Source: XRPScan (<https://xrpscan.com)”>
* For screenshots or embedded charts, attribution must be visible within the image or in its caption.
* If shared on social media or digital publications, a hyperlink to the XRPScan page from which the content was sourced must be included.

Failure to properly attribute content may result in a takedown request or other enforcement action.

### 7. **Intellectual Property**

XRPScan and all associated trademarks, logos, designs, and content are the property of XRPScan or its licensors. You agree not to use, reproduce, or distribute any content without authorization, except as explicitly permitted in these Terms.

### 8. Account labels

We reserve the right, at our sole discretion, to remove, suspend, or modify any account labels associated with addresses or entities listed on the platform in circumstances including, but not limited to: suspected fraudulent or scam activity, credible user or third-party reports, disputed or contested ownership claims, or upon receipt of a valid request from a competent law enforcement authority, regulatory body, or pursuant to a court order. In such cases, labels may be temporarily or permanently withdrawn pending further review. We may, at our discretion, reinstate or update such labels if sufficient and verifiable proof of ownership or control of the relevant account is provided to our satisfaction. Users acknowledge that labeling decisions are made based on available information and internal review processes, and we do not guarantee the accuracy, completeness, or permanence of any label.

### 9. **Disclaimers**

* XRPScan provides data on a best-effort basis and does not guarantee the accuracy, completeness, or availability of any data.
* XRPScan does not offer financial or investment advice. Information provided is for informational purposes only.

### 10. **Limitation of Liability**

In no event shall XRPScan, its team, or affiliates be liable for any direct, indirect, incidental, special, or consequential damages arising from your use of the Service, even if advised of the possibility of such damages.

### 11. **Termination**

We reserve the right to suspend or terminate access to XRPScan at any time and for any reason, including violation of these Terms.

### 12. **Governing Law**

These Terms shall be governed by and construed in accordance with the laws of India, without regard to its conflict of laws principles.

## Contact Us

If you have any questions about this Terms of Service, please contact us at <support@xrpscan.com>.


# AML & KYC

Anti-Money Laundering and Know Your Customer Policy

## **1. Introduction and Purpose**

XRPSCAN Pte. Ltd. ("the Company") is committed to the highest standards of financial integrity and regulatory compliance in the conduct of its business. This Anti-Money Laundering ("AML") and Know Your Customer ("KYC") Policy sets out the framework, procedures, and obligations that govern the Company's approach to preventing money laundering, terrorist financing, and other financial crimes across all its commercial activities.

The Company operates XRPSCAN, a block explorer and data services platform for the XRP Ledger, and generates revenue through advertising partnerships and paid API subscriptions. All commercial relationships entered into by the Company are subject to the compliance procedures described in this Policy.

## **2. Regulatory Framework**

The Company is incorporated in Singapore and conducts its operations in compliance with applicable Singapore laws and regulations, including the Corruption, Drug Trafficking and Other Serious Crimes (Confiscation of Benefits) Act ("CDSA"), the Terrorism (Suppression of Financing) Act ("TSOFA"), and the guidelines issued by the Monetary Authority of Singapore ("MAS") relating to the prevention of money laundering and countering the financing of terrorism ("AML/CFT").

The Company also takes cognizance of internationally recognized standards, including the Financial Action Task Force ("FATF") Recommendations, and applies risk-based compliance practices consistent with those standards when onboarding and maintaining relationships with counterparties across jurisdictions.

## **3. Customer Due Diligence**

The Company conducts Customer Due Diligence ("CDD") on all clients and commercial counterparties prior to entering into a business relationship. CDD procedures are applied uniformly and are calibrated to the assessed risk level of each counterparty.

For corporate clients, including advertising partners, API subscribers, and development clients - the Company applies Know Your Business ("KYB") procedures, which include verification of the entity's legal registration and the nature of the business.

Enhanced Due Diligence ("EDD") is applied to counterparties that present higher risk profiles, including those incorporated in high-risk or non-cooperative jurisdictions as identified by FATF, Politically Exposed Persons ("PEPs") and their associates, and clients whose business activities or transaction patterns deviate materially from expected norms. EDD may include additional documentation requests, senior management approval, and ongoing enhanced monitoring.

The Company will not enter into or maintain a business relationship with any entity or individual that is on the US sanctions list.&#x20;

## **4. Compliance Platform: Impact**

Commercial transactions, payment processing, and compliance verification for XRPSCAN's business activities are conducted through Impact, a regulated compliance and payments platform. Impact provides integrated KYC, KYB, and AML screening capabilities that underpin the Company's compliance framework.

The use of Impact ensures that the Company maintains robust, auditable compliance records for all commercial relationships, supporting its obligations under Singapore law and providing a reliable evidence base in the event of regulatory inquiry.

## **5. Sanctions Screening and Prohibited Counterparties**

The Company maintains a strict policy of not doing business with individuals, entities, or jurisdictions subject to international sanctions. Prior to onboarding any client, the Company screens counterparty names and associated persons against applicable sanctions lists, including those maintained by the US Office of Foreign Assets Control ("OFAC"), the United Nations Security Council, the European Union, and the Monetary Authority of Singapore.

The Company will immediately terminate any existing relationship and freeze associated transactions if a counterparty is identified as a sanctions-listed entity or individual. Any such occurrence will be reported to the relevant authorities in accordance with applicable law.

## **6. Transaction Monitoring and Suspicious Activity**

The Company monitors its commercial transactions on an ongoing basis for patterns or activity that may indicate money laundering, terrorist financing, or other financial crime. Indicators of suspicious activity include, but are not limited to, unusual payment structures, payments from or to unrelated third parties, requests to circumvent standard CDD procedures, and clients who are unwilling or unable to provide satisfactory documentation.

The Company maintains a strict non-tipping-off policy. No client or counterparty will be informed that they are under investigation or that a report has been made to the authorities.

## **7. Record Keeping**

The Company retains all CDD and KYB documentation, transaction records, compliance screening results, and related correspondence for a minimum of five years from the date of the relevant transaction or the end of the business relationship, whichever is later. Records are maintained in a secure and retrievable format and are available for production to regulatory authorities upon lawful request.

## **8. Training and Governance**

The Company's directors and senior management bear ultimate responsibility for the implementation and oversight of this Policy. A designated compliance officer is appointed to manage day-to-day AML/KYC operations, oversee the Impact platform, and ensure that all staff with compliance-relevant responsibilities receive adequate training.

The Policy is reviewed at least annually and updated as necessary to reflect changes in applicable law, regulatory guidance, or the Company's business activities.

## Contact Us

If you have any questions about this policy, please contact us at <support@xrpscan.com>.


# Contact us

{% hint style="info" %}
XRPSCAN is a block explorer that displays transaction information from public blockchain in an easy to read format. We don't store any user funds, nor do we have any control over how transactions execute on the blockchain. We provide support for issues related to [xrpscan.com](http://xrpscan.com) website only.
{% endhint %}

## Email

You may reach us at [support@xrpscan.com](#email)&#x20;

## Advertise with us

Please send advertisement inquiries to [advertise@xrpscan.com](#email)

## Follow us on social media

* X/Twitter - [x.com/xrpscan](https://x.com/xrpscan)
* Instagram - [instagram.com/xrpscan](https://www.instagram.com/xrpscan/)
* Discord - [@xrpscan](https://discord.com)
* Reddit - [www.reddit.com/user/xrpscan](https://www.reddit.com/user/xrpscan)

## Bug reports & Feature requests

If you wish to report a bug or request a new feature, please file a new ticket on our Github page

* <https://github.com/xrpscan/xrpscan.com/issues>

## Security

If you’re reporting a security issue, please send us a detailed report at `support@xrpscan.com`

{% code title="GPG Fingerprint" %}

```
4DC7 65C4 960A 5476 1080  F0E7 0961 1129 E2B2 6848
```

{% endcode %}

{% code title="Public key" %}

```
-----BEGIN PGP PUBLIC KEY BLOCK-----

mQENBFz6sWkBCADkMVkzilqxIP3eHRXeEX3RR0cIJpaNJ9dg0sKLZ8EGBr6bqakD
oIOa3bynnfBbnEZXEUPaic3m2fofplbhtr+b8PM1ZohOMXf8WXvLbkgOwLHZJHyY
Slpn8Z1tztUQ3gu1NafAlgJQSA3m5HZbC/YDMQEzODbXjlsxyGASoRH7qPzZMAxz
IW6nEVmlv67a90y95GONfDHwJR/KyU1uKWWQWm5wbp2PXMpbtKU380glGMKZKUXY
4d9QSL1O8+qxvIAhkSTEyyo2saE6AQrMlq1pYNCaEe4JqWts15RIdkZNLmZbrxU+
fl9K/lLMoMf7QYYEHsAn8o8i437Ho1E5gSKBABEBAAG0J1hSUFNDQU4gKFN1cHBv
cnQpIDxzdXBwb3J0QHhycHNjYW4uY29tPokBOAQTAQIAIgUCXPqxaQIbAwYLCQgH
AwIGFQgCCQoLBBYCAwECHgECF4AACgkQCWERKeKyaEi4+wgAtsShq9GUbmYp1Kuf
rPvazNGbX439/VTvbEmZDKYTyi5K0TbTfjv4wO35kYU6EOGrz/3X/iQmYdH5MMAY
66W/MRP11L/0HD0MFEAwoKBCFADgVU0dzIF8iuXT1URhAMlQ8ckPi/X4yPoM7ein
J+BuqR5nDkis2lTOBHbpDL3eeoBzR9zHFbdo76RDzaw4DzJS3ZGxWyzXIkkLdDpR
T4y9uR3itDHZksQGNq7i7t0GWEREMcUXfxK+xTL5a1K+GCm9yizc2RRubA7WHtGs
OX7WOJx7kI0hO91BGpY2oqH34wLzOVx46yRkvshF3X00Gqaxmq2dzf9Us15Vb4YE
7r2TibkBDQRc+rFpAQgAxjc2sUpMc6DAuY2qSFe/dIpY7IpbWNYvA3cYsflpG4Vs
flLxaq0ln1BKT4xcP5deD5RHfrcp41Z9UlyN49M0wFJjTNY3R9ZJ0cLF4drTigk5
7UQLsPcL6Q75JRA9sViC/D8yxfgRgEhhwLB7/Q4TbEGJ1HAzttB0bLLr8/FzYomg
2Rn1VsGT0rKJYmb6VzWjY2ImBpQGsszskjYd9C5oBXmH5Uo7cBPmW6RxUSn1GzPx
WWnCSK4IYukpiWteVwz61gigyPpOyaJQticmBApQh+p677D8sHyABgIBnU/PS6as
z8xFztHolcdIZDHyQtdIyqOZ8203gTc6tU86DpRZzQARAQABiQEfBBgBAgAJBQJc
+rFpAhsMAAoJEAlhESnismhICc0IANJSDHmAHD4DiMOW+2gNwXJxAFxJqVEY3e4o
PxZ8H4NTgZ0BGtA/7vfdaOh+7DPATIK72TEs5gBFuYvyOK86KEUa+k1okq1hhnSn
E2KCKWHgpEmzIUqqgyEWqT0w1KvDbLb3HQ7STK6u1LbetWvEnHTSJSl78Q7cqlqq
ko9tIMiMEkwvCCOadjWmov/gxCL3nXhuBqOzeGCaJFOvBtNOgKa0ux25hkrJ4maA
JkaCENAQ4+VoITnk7xASYsWamL7w1WwlJfMGheSrYoKeMR8VSFESuoc2oyFJ1GT0
4ZTA14xvzMD6Yg22VmAtX4u8D1BI8TmYiHJ7tMjkHMoi95JTN1A=
=Spdf
-----END PGP PUBLIC KEY BLOCK-----
```

{% endcode %}


# Brand

XRPSCAN Brand Assets

### About XRPSCAN

XRPSCAN is a specialized blockchain explorer and network analysis platform exclusively for the XRP Ledger (XRPL). We provide real-time transaction tracking, wallet monitoring, and network metrics, making it a vital tool for users, exchanges, and financial institutions.

<figure><img src="/files/KEpIhKkMIlrOWVWDwqbX" alt="XRPSCAN Logo (Light)"><figcaption><p>XRPSCAN Logo (Light)</p></figcaption></figure>

<figure><img src="/files/jjgmAJBqUaKjw7BdKhwU" alt=""><figcaption><p>XRPSCAN Logo (Dark)</p></figcaption></figure>

<figure><img src="/files/XtN4MX5pBjC9WjiBMgV7" alt=""><figcaption><p>XRPSCAN Icon (SVG)</p></figcaption></figure>

<figure><img src="/files/kvbXmfuH9A4g7PerBXCL" alt="" width="375"><figcaption><p>XRPSCAN Icon (PNG)</p></figcaption></figure>

<figure><img src="/files/e8bzrYluj9uGA8A01oOs" alt=""><figcaption><p>XRPSCAN - Explore The Ledger</p></figcaption></figure>

#### Download Brand Assets

{% file src="/files/fJ4grjLignr3cmIujlei" %}


# How to report scams

Have you lost funds to a scam, or saw a scam on social media?

{% hint style="info" %}
XRPSCAN is a block explorer that shows transaction information from public blockchain in an easy to read format. We don't store any user funds, nor do we have any control over how transactions execute on the blockchain.
{% endhint %}

Due to the nature of how blockchains work, these transactions can neither be cancelled, nor reversed.

If you suspect you've been scammed, we advise you to approach your local police (or depending on your country, any relevant law enforcement agency that deals with financial or online crimes) and register a complaint of scam/fraud with them.

Recovering stolen funds is a slow process. It is possible you may never see your funds again. We advise you to stay safe, do your own due diligence and participate in online schemes with utmost caution.

## Reporting suspicious wallets

You may also report suspicious wallets to our partner [Chainabuse](https://chainabuse.com/). Once it is reported to Chainabuse, we will flag the wallet on xrpscan.com. Click the link below.

{% embed url="<https://chainabuse.com/report?source=xrpscan>" %}


