bitcoin-cliコマンド【getblockstats】

getblockstats hash_or_height ( stats )

ブロックの統計情報を計算する。表示される金額は全て satoshi 。プルーニングされているブロックでは機能しない。また、utxo_size_inc, *fee, *feerate の情報は、-txindexオプションが無効な場合は計算されない。

-txindexオプションを有効にする方法は以下を参照
https://yukiosugiyama.com/crypto/post-2576/

引数

① hash_or_height (string or numeric, required)

対象ブロックのブロックハッシュ、もしくはブロック高を指定する

以下のバージョンで試してみたが、ブロックハッシュ指定はエラーになる。
version v0.17.0.0-5b47b8efd

② stats (array,  optional)

デフォルトで表示される全ての値から、対象とする値を指定する
例)'[“minfeerate”,”avgfeerate”]’

実行例

$ bitcoin-cli getblockstats 548456
{
  "avgfee": 3433,
  "avgfeerate": 13,
  "avgtxsize": 317,
  "blockhash": "0000000000000000000637baae3065132dd562b5bb32c8dc8a0bb243118a3617",
  "feerate_percentiles": [
    5,
    8,
    11,
    12,
    15
  ],
  "height": 548456,
  "ins": 5618,
  "maxfee": 636150,
  "maxfeerate": 781,
  "maxtxsize": 21954,
  "medianfee": 1865,
  "mediantime": 1541170587,
  "mediantxsize": 249,
  "minfee": 286,
  "minfeerate": 1,
  "mintxsize": 189,
  "outs": 8462,
  "subsidy": 1250000000,
  "swtotal_size": 797910,
  "swtotal_weight": 2036949,
  "swtxs": 2530,
  "time": 1541173356,
  "total_out": 1267257716600,
  "total_size": 1286645,
  "total_weight": 3991889,
  "totalfee": 13925299,
  "txs": 4057,
  "utxo_increase": 2844,
  "utxo_size_inc": 218069
}

$ bitcoin-cli getblockstats 548456 '["minfeerate","avgfeerate"]'
{
  "avgfeerate": 13,
  "minfeerate": 1
}

出力内容

avgfee (numeric)

ブロック内の手数料の平均値

avgfeerate (numeric)

手数料レートの平均値(satoshi / virtual byte)

avgtxsize (numeric)

トランザクションサイズの平均値

blockhash (string)

ブロックハッシュ(reorgの可能性があるため)

feerate_percentiles (array of numeric)

10, 25, 50, 75, 90 の各パーセンタイル別の手数料レート(satoshi / virtual byte)

10th_percentile_feerate (numeric)

10パーセンタイルの手数料レート

25th_percentile_feerate (numeric)

25パーセンタイルの手数料レート

50th_percentile_feerate (numeric)

50パーセンタイルの手数料レート

75th_percentile_feerate (numeric)

75パーセンタイルの手数料レート

90th_percentile_feerate (numeric)

90パーセンタイルの手数料レート

height (numeric)

ブロック高

ins (numeric)

インプット数(コインベースを除く)

maxfee (numeric)

ブロック内の最大手数料

maxfeerate (numeric)

最大手数料レート(satoshi / virtual byte)

maxtxsize (numeric)

最大トランザクションサイズ

medianfee (numeric)

ブロック内の手数料中央値(端数切捨て)

mediantime (numeric)

ブロックの median time

mediantxsize (numeric)

トランザクションサイズの中央値(端数切捨て)

minfee (numeric)

ブロック内の最小手数料

minfeerate (numeric)

最小手数料レート(satoshi / virtual byte)

mintxsize (numeric)

最小トランザクションサイズ

outs (numeric)

アウトプット数

subsidy (numeric)

このブロックのマイニング報酬

swtotal_size (numeric)

segwitトランザクションの合計サイズ

swtotal_weight (numeric)

segwitトランザクションの合計weightを、segwit scale factor である “4” で割った値

swtxs (numeric)

segwitトランザクション数

time (numeric)

ブロック時間(UNIX時間)

total_out (numeric)

全てのアウトプットの合計額(マイニング報酬と手数料を除く)

total_size (numeric)

コインベースを除く、全トランザクションの合計サイズ

total_weight (numeric)

コインベースを除く、全トランザクションの合計weightを、segwit scale factor である “4” で割った値

totalfee (numeric)

手数料の合計

txs (numeric)

トランザクション数(コインベースを除く)

utxo_increase (numeric)

UTXOの増減

utxo_size_inc (numeric)

UTXOインデックスのサイズの増減(op_returnなどを割り引かない)