For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

XRP — server, Methods, mpt (2/3)

API reference for XRP. All methods ->

Part 2 of 3: 1 · 2 · 3

version​

Retrieves API version information.

The version command retrieves the API version information for the rippled server. For Clio servers, see version (clio) instead.

Parameters​

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON-RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): none.

Returns​

The response follows the standard format, with a successful result containing a version object as its only field.

The version object returns some arrangement of the following fields:

  • first (string): Lowest supported API release.
  • last (string): Highest supported API release.
  • good (string): Default API if none specified.

Request example​

curl 'https://rpc.ankr.com/xrp_mainnet/YOUR_ANKR_API_KEY' \
-d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "version",
      "params": []
  }'

Response example​

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "status": "success",
        "version": {
            "first": "1.0.0",
            "good": "1.0.0",
            "last": "1.0.0"
        }
    }
}

Clio Methods:

These API methods are provided only by the Clio server, not rippled.

server_info​

Retrieves status of the Clio server in human-readable format.

The server_info command asks the Clio server for a human-readable version of various information about the Clio server being queried. For rippled servers, see server_info (rippled) instead.

Parameters​

  • id (integer; required): a request ID (example: 1).
  • jsonrpc (string; required): a JSON-RPC spec used (example: 2.0).
  • method (string; required): a method used for the request.
  • params (array; required): none.

Returns​

The response follows the standard format, with a successful result containing an info object as its only field.

The info object may have some arrangement of the following fields:

  • complete_ledgers (string): Range expression indicating the sequence numbers of the ledger versions the local rippled has in its database. This may be a disjoint sequence such as 24900901-24900984,24901116-24901158. If the server does not have any complete ledgers (for example, it recently started syncing with the network), this is the string empty.
  • counters (object; optional): Stats on API calls handled since server startup. This is present only if the client connects to the Clio server over localhost.
  • rpc (object; optional): Stats on each API call handled by the Clio server since startup. Since this is nested within the counters object, this is also present only if the client connects to the Clio server over localhost. The rpc object is a map of API method names to API Stats Objects.
  • subscriptions (object; optional): Number of current subscribers for each stream type. Since this is nested within the counters object, this is also present only if the client connects to the Clio server over localhost.
    • subscriptions.ledger
    • subscriptions.transactions
    • subscriptions.transactions_proposed
    • subscriptions.manifests
    • subscriptions.validations
    • subscriptions.account
    • subscriptions.accounts_proposed
    • subscriptions.books
  • time (string): The current time in UTC, according to the server's clock.
  • uptime (number): Number of consecutive seconds that the server has been operational.
  • amendment_blocked (boolean; optional): Whether the Clio server is Amendment Blocked.
  • load_factor (number): The load-scaled open ledger transaction cost the server is currently enforcing, as a multiplier on the base transaction cost. For example, at 1000 load factor and a reference transaction cost of 10 drops of XRP, the load-scaled transaction cost is 10,000 drops (0.01 XRP). The load factor is determined by the highest of the individual server's load factor, the cluster's load factor, the open ledger cost, and the overall network's load factor.
  • clio_version (string): The version number of the running Clio server.
  • libxrpl_version (string): The version number of the libxrpl library this Clio server was built against.
  • validation_quorum (number; optional): Minimum number of trusted validations required to validate a ledger version. Some circumstances may cause the server to require more validations. This value is obtained from rippled. This field may be omitted from the response if the Clio server is unable to connect to rippled for some reason.
  • rippled_version (string; optional): The version number of the running rippled server that the Clio server is connected to. This field may be omitted from the response if the Clio server is unable to connect to rippled for some reason.
  • network_id (string; optional): The network ID of the network that the rippled this Clio server is connected to is operating on. This field may be omitted from the response if the Clio server is unable to connect to rippled for some reason.
  • validated_ledger (object; optional): Information about the most recent fully-validated ledger. If the most recent validated ledger is not available, the response omits this field and includes closed_ledger instead.
    • validated_ledger.age (number): The time since the ledger was closed, in seconds.
    • validated_ledger.base_fee_xrp (number): Base fee, in XRP. This may be represented in scientific notation such as 1e-05 for 0.00001.
    • validated_ledger.hash (string): Unique hash for the ledger, as hexadecimal.
    • validated_ledger.reserve_base_xrp (number): Minimum amount of XRP (not drops) necessary for every account to keep in reserve. This may be represented in scientific notation such as 1e-05 for 0.00001.
    • validated_ledger.reserve_inc_xrp (number): Amount of XRP (not drops) added to the account reserve for each object an account owns in the ledger. This may be represented in scientific notation such as 1e-05 for 0.00001.
    • validated_ledger.seq (number): The ledger index of the latest validated ledger.
    • validator_list_expires (string): (Admin only) Either the human-readable time, in UTC, when the current validator list expires, the string unknown if the server has yet to load a published validator list or the string never if the server uses a static validator list.
  • cache (object): Information on Clio's state data cache.
    • cache.size (number): Number of state data objects currently in the cache.
    • cache.is_full (boolean): True if cache contains all state data for a specific ledger, false otherwise. Some API calls, such as the book_offers method, process much faster when the cache is full.
    • cache.latest_ledger_seq (number): The ledger index of the latest validated ledger stored in the cache.
  • etl (object): The rippled sources (ETL sources) that the Clio server is connected to. This is present only if the client connects to the Clio server over localhost.
    • etl.etl_sources (array): List the rippled sources (ETL sources) that the Clio server is connected to and extracts data from.
      • etl.etl_sources.validated_range (string): The validated ledger range retrieved by the P2P rippled server.
      • etl.etl_sources.is_connected (boolean): True if Clio is connected to this source via websocket, false otherwise. A value of false here could indicate a networking issue, or that rippled is not running, amongst other things.
      • etl.etl_sources.ip (number): IP of the rippled server.
      • etl.etl_sources.ws_port (number): Websocket port of the rippled server.
      • etl.etl_sources.grpc_port (number): The gRPC connection port of the P2P rippled server that the Clio server is connected to.
      • etl.etl_sources.last_msg_age_seconds (number): Total seconds that have elapsed since Clio last heard anything from rippled. This should not be higher than 8.
    • etl.is_writer (boolean): true if this Clio server is currently writing data to the database, false otherwise.
    • etl.read_only (boolean): true if this Clio server is configured in read-only mode, false otherwise.
    • etl.last_publish_age_seconds (number): Time in seconds that have elapsed since this Clio server last published a ledger. This should not be more than 8.
  • validated (boolean): When true, this indicates that the response uses a ledger version that has been validated by consensus. In Clio, this is always true as Clio stores and returns validated ledger data. If a request was forwarded to rippled and the server returns current data, a missing or false value indicates that this ledger's data is not final.
  • status (string): Returns the status of the API request: success when the request completes successfully.

API Stats Objects​

An API Stats object provides key metrics for every API call handled by the Clio server since startup. It includes the following fields:

  • started (number): Number of API calls of this type that the Clio server has started processing since startup.
  • finished (number): Number of API calls of this type that the Clio server has finished processing since startup.
  • errored (number): Number of API calls of this type that have resulted in some sort of error since startup.
  • forwarded (number): Number of API calls of this type that the Clio server has forwarded to a rippled P2P server since startup.
  • duration_us (number): The total number of microseconds spent processing API calls of this type since startup.

Request example​

curl 'https://rpc.ankr.com/xrp_mainnet/YOUR_ANKR_API_KEY' \
-d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "server_info",
      "params": []
  }'

Response example​

{
    "result": {
        "info": {
            "build_version": "2.6.2",
            "complete_ledgers": "100146025-100669999",
            "hostid": "SAD",
            "initial_sync_duration_us": "292599227",
            "io_latency_ms": 1,
            "jq_trans_overflow": "0",
            "last_close": {
                "converge_time_s": 3,
                "proposers": 35
            },
            "load_factor": 1,
            "peer_disconnects": "25682",
            "peer_disconnects_resources": "10",
            "peers": 50,
            "ports": [
                {
                    "port": "51235",
                    "protocol": [
                        "peer"
                    ]
                },
                {
                    "port": "51234",
                    "protocol": [
                        "http"
                    ]
                },
                {
                    "port": "51233",
                    "protocol": [
                        "ws"
                    ]
                },
                {
                    "port": "50051",
                    "protocol": [
                        "grpc"
                    ]
                }
            ],
            "pubkey_node": "n94B86FddoyYsndK6N8gZwcD5xoMonptkHxmWnNqc22naS5V1pF8",
            "server_state": "full",
            "server_state_duration_us": "174432150738",
            "state_accounting": {
                "connected": {
                    "duration_us": "283465932",
                    "transitions": "2"
                },
                "disconnected": {
                    "duration_us": "1040136",
                    "transitions": "2"
                },
                "full": {
                    "duration_us": "174432150738",
                    "transitions": "1"
                },
                "syncing": {
                    "duration_us": "8093158",
                    "transitions": "1"
                },
                "tracking": {
                    "duration_us": "0",
                    "transitions": "1"
                }
            },
            "time": "2025-Dec-05 11:47:07.485428 UTC",
            "uptime": 174724,
            "validated_ledger": {
                "age": 4,
                "base_fee_xrp": 1e-05,
                "hash": "88DD7DD8994E83A178D341FB9621610CD56B4576384FCA3A962A675E9C1A4003",
                "reserve_base_xrp": 1,
                "reserve_inc_xrp": 0.2,
                "seq": 100669999
            },
            "validation_quorum": 28
        },
        "status": "success"
    }
}

ledger​

Retrieves info on the ledger version.

The ledger command retrieves information about the public ledger.

Note that the Clio server returns validated ledger data by default.

Parameters​

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON-RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    • ledger_hash (hash; optional): The unique hash of the ledger version to use. (See Specifying Ledgers).
    • ledger_index (ledger index; optional): The ledger index of the ledger to use, or a shortcut string to choose a ledger automatically. (See Specifying Ledgers)
    • transactions (boolean; optional): If true, return information on transactions in the specified ledger version. Defaults to false. Ignored if you did not specify a ledger version.
    • expand (boolean; optional): Provide full JSON-formatted information for transaction/account information instead of only hashes. Defaults to false. Ignored unless you request transactions.
    • owner_funds (boolean; optional): If true, include owner_funds field in the metadata of OfferCreate transactions in the response. Defaults to false. Ignored unless transactions are included and expand is true.
    • binary (boolean; optional): If true, and transactions and expand are both also true, return transaction information in binary format (hexadecimal string) instead of JSON format.
    • diff (boolean; optional): If true, returns all objects that were added, modified, or deleted as part of applying transactions in the specified ledger.

Returns​

The response follows the standard format, with a successful result containing information about the ledger, including the following fields:

  • ledger (object): The complete header data of this ledger.
    • ledger.account_hash (string): Hash of all account state information in this ledger, as hex.
    • ledger.accountState (array; optional): All the account-state information in this ledger.
    • ledger.close_flags (integer): A bit-map of flags relating to the closing of this ledger.
    • ledger.close_time (integer): The time this ledger was closed, in seconds since the Ripple Epoch.
    • ledger.close_time_human (string): The time this ledger was closed, in human-readable format. Always uses the UTC time zone.
    • ledger.close_time_resolution (integer): Ledger close times are rounded to within this many seconds.
    • ledger.closed (boolean): Whether this ledger has been closed or not.
    • ledger.ledger_hash (string): Unique identifying hash of the entire ledger.
    • ledger.ledger_index (string): The Ledger Index of this ledger, as a quoted integer.
    • ledger.parent_close_time (integer): The time at which the previous ledger was closed.
    • ledger.parent_hash (string): Unique identifying hash of the ledger that came immediately before this one.
    • ledger.total_coins (string): Total number of XRP drops in the network, as a quoted integer. (This decreases as transaction costs destroy XRP.)
    • ledger.transaction_hash (string): Hash of the transaction information included in this ledger, as hex.
    • ledger.transactions (array; optional): Transactions applied in this ledger version. By default, members are the transactions' identifying Hash strings. If the request specified expand as true, members are full representations of the transactions instead, in either JSON or binary depending on whether the request specified binary as true.
  • ledger_hash (string): Unique identifying hash of the entire ledger.
  • ledger_index (number): The Ledger Index of this ledger.
  • validated (boolean; optional): If true, this is a validated ledger version. If omitted or set to false, this ledger's data is not final.
  • diff (object; optional): Object containing an array of hashes that were added, modified, or deleted as part of applying transactions for the ledger.

If the request specified "owner_funds": true and expanded transactions, the response has a field owner_funds in the metaData object of each OfferCreate transaction. The purpose of this field is to make it easier to track the funding status of offers with each new validated ledger.

  • owner_funds (string): Numeric amount of the TakerGets currency that the Account sending this OfferCreate transaction has after the execution of all transactions in this ledger. This does not check whether the currency amount is frozen.

If the request specified "diff": true, the response has an object diff. The fields of this object are as follows:

  • object_id (string): The object identifier.
  • Hashes (object or string): Depending on whether the request set binary to true or false, this field returns the contents of the object that was created, the new value of an object that was modified, or an empty string if the object was deleted.

Request example​

curl 'https://rpc.ankr.com/xrp_mainnet/YOUR_ANKR_API_KEY' \
-d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "ledger",
      "params": [
          {
              "ledger_index": "validated",
              "transactions": false,
              "expand": false,
              "owner_funds": false,
              "diff": false
          }
      ]
  }'

Response example​

{
    "result": {
        "ledger": {
            "account_hash": "F16BD4873733F45AA69A22E16669701FA6382BE5465EDA7B9B77AFCFBE9BB335",
            "close_flags": 0,
            "close_time": 818251651,
            "close_time_human": "2025-Dec-05 12:07:31.000000000 UTC",
            "close_time_iso": "2025-12-05T12:07:31Z",
            "close_time_resolution": 10,
            "closed": true,
            "ledger_hash": "57FAE517644B0E528D331D105D5E06071742CD7E35BE77C4F775E6FA98B38A83",
            "ledger_index": "100670317",
            "parent_close_time": 818251650,
            "parent_hash": "ECEB12B2CC088D735BA64F05DF424833B9CD1821FDFE72C8608FA0895BF8DA87",
            "total_coins": "99985745812732275",
            "transaction_hash": "B3440C9462D83D4CD22208538DA257974A99AC132EBE976CE7B581C36F8B8825"
        },
        "ledger_hash": "57FAE517644B0E528D331D105D5E06071742CD7E35BE77C4F775E6FA98B38A83",
        "ledger_index": 100670317,
        "status": "success",
        "validated": true
    }
}

mpt_holders​

Retrieves the holders of a given MPT issuance for a given ledger.

For a given MPTokenIssuanceID and ledger sequence, mpt_holders returns all holders of that MPT and their balance. This method likely returns very large data sets, so you should expect to implement paging via the marker field. This API is only available using Clio, not rippled.

Parameters​

  • id (integer; required): a request ID (example: 1).

  • jsonrpc (string; required): a JSON-RPC spec used (example: 2.0).

  • method (string; required): a method used for the request.

  • params (array; required):

    • mpt_issuance_id (string; required): The MPTokenIssuance to query.
    • ledger_index (ledger index; optional): The Ledger Index of the max ledger to use, or a shortcut string to choose a ledger automatically. You must specify either ledger_index or ledger_hash. See Specifying Ledgers.
    • ledger_hash (string; optional): A 32-byte hex string for the ledger version to use. You must specify either ledger_index or ledger_hash. See Specifying Ledgers.
    • marker (marker; optional): Used to continue your query where it left off in paginating.
    • limit (number — positive integer; optional): Specify a limit to the number of MPTs returned.

Returns​

  • mpt_issuance_id (string): The MPTokenIssuance queried.
  • mptokens (array): An array of MPTokens. Includes all relevant fields in the underlying MPToken object.
  • marker (marker; optional): Used to continue querying where we left off when paginating. Omitted if there are no more entries after this result.
  • limit (number): The limit, as specified in the request.
  • ledger_index (ledger index): The index of the ledger used.
  • validated (boolean): If true, the ledger has been validated by the consensus process and is immutable. Otherwise, the contents of the ledger are not final and may change. In Clio, this is always true as Clio stores and returns validated ledger data.

MPToken​

An MPToken object has the following parameters:

  • account (string): The account address of the holder who owns the MPToken.
  • flags (number): The flags assigned to the MPToken object.
  • mpt_amount (string — number): Specifies a positive amount of tokens currently held by the owner.
  • mptoken_index (string): Key of the MPToken object.

Request example​

curl 'https://rpc.ankr.com/xrp_mainnet/YOUR_ANKR_API_KEY' \
-d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "mpt_holders",
      "params": [
          {
            "mpt_issuance_id": "0024D204E07DDDFBCD83B1649C07FE27FD536A3A32E6FDD8",
            "ledger_index": "validated"
          }
      ]
  }'

Response example​

{
  "result": {
    "mpt_issuance_id": "0024D204E07DDDFBCD83B1649C07FE27FD536A3A32E6FDD8",
    "limit": 50,
    "ledger_index": 2415033,
    "mptokens": [
      {
        "account": "rfyWeQpYM3vCXRHA9cMLs2ZEdZv1F1jzm9",
        "flags": 0,
        "mpt_amount": "200",
        "mptoken_index": "22F99DCD55BCCF3D68DC3E4D6CF12602006A7563A6BE93FC57FD63298BCCEB13"
      }
    ],
    "validated": true,
    "status": "success"
  },
  "warnings": [
    {
      "id": 2001,
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
    }
  ]
}