Last updated

fee

[Source]

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. Updated in: rippled 0.32.0

Request Format

An example of the request format:

  1. WebSocket
  2. JSON-RPC
  3. Commandline
{
  "id": "fee_websocket_example",
  "command": "fee"
}

The request does not include any parameters.

Response Format

An example of a successful response:

  1. WebSocket
  2. JSON-RPC
  3. Commandline
{
  "id": "fee_websocket_example",
  "status": "success",
  "type": "response",
  "result": {
    "current_ledger_size": "14",
    "current_queue_size": "0",
    "drops": {
      "base_fee": "10",
      "median_fee": "11000",
      "minimum_fee": "10",
      "open_ledger_fee": "10"
    },
    "expected_ledger_size": "24",
    "ledger_current_index": 26575101,
    "levels": {
      "median_level": "281600",
      "minimum_level": "256",
      "open_ledger_level": "256",
      "reference_level": "256"
    },
    "max_queue_size": "480"
  }
}

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

FieldTypeDescription
current_ledger_sizeString (Integer)Number of transactions provisionally included in the in-progress ledger.
current_queue_sizeString (Integer)Number of transactions currently queued for the next ledger.
dropsObjectVarious information about the transaction cost (the Fee field of a transaction), in drops of XRP.
drops.base_feeString (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_feeString (Integer)An approximation of the median transaction cost among transactions included in the previous validated ledger, represented in drops of XRP.
drops.minimum_feeString (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_feeString (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_sizeString (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_indexNumberThe Ledger Index of the current open ledger these stats describe.
levelsObjectVarious 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_levelString (Integer)The median transaction cost among transactions in the previous validated ledger, represented in fee levels.
levels.minimum_levelString (Integer)The minimum transaction cost required to be queued for a future ledger, represented in fee levels.
levels.open_ledger_levelString (Integer)The minimum transaction cost required to be included in the current open ledger, represented in fee levels.
levels.reference_levelString (Integer)The equivalent of the minimum transaction cost, represented in fee levels.
max_queue_sizeString (Integer)The maximum number of transactions that the transaction queue can currently hold.

Possible Errors