Documentation exported from Bitcoin Core 0.17.99

estimatesmartfee (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

estimatesmartfee conf_target ("estimate_mode")

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

The request target will be clamped between 2 and the highest target fee estimation is able to return based on how long it has been running. An error is returned if not enough transactions and blocks have been observed to make an estimate for any number of blocks.

Arguments

1. conf_target

numeric

Confirmation target in blocks (1 - 1008)

2. "estimate_mode"

string

optional

default=CONSERVATIVE

The fee estimate mode. Whether to return a more conservative estimate which also satisfies a longer history. A conservative estimate potentially returns a higher feerate and is more likely to be sufficient for the desired target, but is not as responsive to short term drops in the prevailing fee market. Must be one of:

  • “UNSET” (defaults to CONSERVATIVE)
  • “ECONOMICAL”
  • “CONSERVATIVE”

Result

{
  "feerate" : x.x,

numeric

optional

estimate fee rate in BTC/kB

  "errors": [ str... ]

json array of strings

optional

Errors encountered during processing

  "blocks" : n

numeric

block number where estimate was found

}

Examples

Examples:

bitcoin-cli estimatesmartfee 6