fee

The fee command reports the current state of the open-ledger requirements for the transaction cost. This requires the [FeeEscalation amendment][] to be enabled.

This is a public command available to unprivileged users.

Request Format

An example of the request format:

curl --location 'https://xrp.nownodes.io' \
--header 'Content-Type: application/json' \
--header 'api-key: API_KEY' \
--data '{
    "method": "fee",
    "params": [{}]
}'

The request does not include any parameters.

Response Format

An example of a successful response:

200 OK

{
    "result": {
        "current_ledger_size": "56",
        "current_queue_size": "11",
        "drops": {
            "base_fee": "10",
            "median_fee": "10000",
            "minimum_fee": "10",
            "open_ledger_fee": "2653937"
        },
        "expected_ledger_size": "55",
        "ledger_current_index": 26575101,
        "levels": {
            "median_level": "256000",
            "minimum_level": "256",
            "open_ledger_level": "67940792",
            "reference_level": "256"
        },
        "max_queue_size": "1100",
        "status": "success"
    }
}

The response follows the [standard format][], with a successful result containing the following fields:

Field	Type	Description
current_ledger_size	String (Integer)	Number of transactions provisionally included in the in-progress ledger.
current_queue_size	String (Integer)	Number of transactions currently queued for the next ledger.
drops	Object	Various information about the transaction cost (the Fee field of a transaction), in [drops of XRP][].
drops.base_fee	String (Integer)	The transaction cost required for a reference transaction to be included in a ledger under minimum load, represented in drops of XRP.
drops.median_fee	String (Integer)	An approximation of the median transaction cost among transactions included in the previous validated ledger, represented in drops of XRP.
drops.minimum_fee	String (Integer)	The minimum transaction cost for a reference transaction to be queued for a later ledger, represented in drops of XRP. If greater than base_fee, the transaction queue is full.
drops.open_ledger_fee	String (Integer)	The minimum transaction cost that a reference transaction must pay to be included in the current open ledger, represented in drops of XRP.
expected_ledger_size	String (Integer)	The approximate number of transactions expected to be included in the current ledger. This is based on the number of transactions in the previous ledger.
ledger_current_index	Number	The [Ledger Index][] of the current open ledger these stats describe.
levels	Object	Various information about the transaction cost, in [fee levels][]. The ratio in fee levels applies to any transaction relative to the minimum cost of that particular transaction.
levels.median_level	String (Integer)	The median transaction cost among transactions in the previous validated ledger, represented in [fee levels][].
levels.minimum_level	String (Integer)	The minimum transaction cost required to be queued for a future ledger, represented in [fee levels][].
levels.open_ledger_level	String (Integer)	The minimum transaction cost required to be included in the current open ledger, represented in [fee levels][].
levels.reference_level	String (Integer)	The equivalent of the minimum transaction cost, represented in [fee levels][].
max_queue_size	String (Integer)	The maximum number of transactions that the transaction queue can currently hold.

Possible Errors

• Any of the [universal error types][].