estimaterawfee

hidden

v0.16.3

estimaterawfee conf_target (threshold)

WARNING: This interface is unstable and may disappear or change!

WARNING: This is an advanced API call that is tightly coupled to the specific
implementation of fee estimation. The parameters it can be called with
and the results it returns will change if the internal implementation changes.

Estimates the approximate fee per kilobyte needed for a transaction to begin
confirmation within conf_target blocks if possible. Uses virtual transaction size as
defined in BIP 141 (witness data is discounted).

Arguments:
1. conf_target (numeric) Confirmation target in blocks (1 - 1008)
2. threshold (numeric, optional) The proportion of transactions in a given feerate range that must have been
confirmed within conf_target in order to consider those feerates as high enough and proceed to check
lower buckets. Default: 0.95

Result:
{
"short" : { (json object, optional) estimate for short time horizon
"feerate" : x.x, (numeric, optional) estimate fee rate in " + CURRENCY_UNIT + "/kB
"decay" : x.x, (numeric) exponential decay (per block) for historical moving average of confirmation data
"scale" : x, (numeric) The resolution of confirmation targets at this time horizon
"pass" : { (json object, optional) information about the lowest range of feerates to succeed in meeting the threshold
"startrange" : x.x, (numeric) start of feerate range
"endrange" : x.x, (numeric) end of feerate range
"withintarget" : x.x, (numeric) number of txs over history horizon in the feerate range that were confirmed within target
"totalconfirmed" : x.x, (numeric) number of txs over history horizon in the feerate range that were confirmed at any point
"inmempool" : x.x, (numeric) current number of txs in mempool in the feerate range unconfirmed for at least target blocks
"leftmempool" : x.x, (numeric) number of txs over history horizon in the feerate range that left mempool unconfirmed after target
},
"fail" : { ... }, (json object, optional) information about the highest range of feerates to fail to meet the threshold
"errors": [ str... ] (json array of strings, optional) Errors encountered during processing
},
"medium" : { ... }, (json object, optional) estimate for medium time horizon
"long" : { ... } (json object) estimate for long time horizon
}

Results are returned for any horizon which tracks blocks up to the confirmation target.

Example:
> bitcoin-cli estimaterawfee 6 0.9
Don't trust. Verify. Docs extracted from src/rpc/mining.cpp#L874-L915.