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.

Request Format

An example of the request format:

{
  "id": "fee_websocket_example",
  "command": "fee"
}

The request does not include any parameters.

Response Format

An example of a successful response:

{
  "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:

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