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