Documentation exported from Bitcoin Core 0.17.99

getblock (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

getblock "blockhash" ( verbosity ) 

If verbosity is 0, returns a string that is serialized, hex-encoded data for block ‘hash’. If verbosity is 1, returns an Object with information about block <hash>. If verbosity is 2, returns an Object with information about block <hash> and information about each transaction.

Arguments

1. "blockhash"

string

required

The block hash

2. verbosity

numeric

optional

default=1

0 for hex encoded data, 1 for a json object, and 2 for json object with transaction data

Result (for verbosity = 0)

"data"

string

A string that is serialized, hex-encoded data for block ‘hash’.

Result (for verbosity = 1)

{
  "hash" : "hash",

string

the block hash (same as provided)

  "confirmations" : n,

numeric

The number of confirmations, or -1 if the block is not on the main chain

  "size" : n,

numeric

The block size

  "strippedsize" : n,

numeric

The block size excluding witness data

  "weight" : n

numeric

The block weight as defined in BIP 141

  "height" : n,

numeric

The block height or index

  "version" : n,

numeric

The block version

  "versionHex" : "00000000",

string

The block version formatted in hexadecimal

  "merkleroot" : "xxxx",

string

The merkle root

  "tx" : [

array of string

The transaction ids

     "transactionid"

string

The transaction id

     ,...
  ],
  "time" : ttt,

numeric

The block time in seconds since epoch (Jan 1 1970 GMT)

  "mediantime" : ttt,

numeric

The median block time in seconds since epoch (Jan 1 1970 GMT)

  "nonce" : n,

numeric

The nonce

  "bits" : "1d00ffff",

string

The bits

  "difficulty" : x.xxx,

numeric

The difficulty

  "chainwork" : "xxxx",

string

Expected number of hashes required to produce the chain up to this block (in hex)

  "nTx" : n,

numeric

The number of transactions in the block.

  "previousblockhash" : "hash",

string

The hash of the previous block

  "nextblockhash" : "hash"

string

The hash of the next block

}

Result (for verbosity = 2)

{
  ...,

Same output as verbosity = 1.

  "tx" : [

array of Objects

The transactions in the format of the getrawtransaction RPC. Different from verbosity = 1 “tx” result.

         ,...
  ],
  ,...

Same output as verbosity = 1.

}

Examples

Examples:

bitcoin-cli getblock "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblock", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/