Bitcoin RPC
Overview
The getblock is a Bitcoin RPC method that returns information about a specified block. This method is useful for obtaining block details such as the hash, height, transactions, and other metadata. It can be used for various purposes, including validating transactions, monitoring the blockchain, and analyzing the network.
Parameters
blockhash: The hash of the block to be retrieved.- Example: "0000000000000000000ef0e1f703b56f2b0d6724e4eeccf00e4f8d55b9c3c3f6e"
verbosity: Specifies the level of detail returned for the block.0: Returns a serialized block as a hex-encoded string (default).1: Returns a JSON object with block information.2: Returns a JSON object with block information and detailed transaction data.
Returns
The returned object varies depending on the verbosity parameter:
- If
verbosityis0, the return object is a hex-encoded string of the serialized block. - If
verbosityis1or2, the return object is a JSON object containing the following fields:
| Name | Description |
|---|---|
| hash | The block hash. |
| confirmations | The number of confirmations for the block. |
| strippedsize | The block size without witness data. |
| size | The block size. |
| transactionIndex | The index of the transaction within the block. |
| weight | The block weight. |
| height | The block height. |
| version | he block version. |
| versionHex | The block version as a hex string. |
| merkleroot | The Merkle root of the transactions in the block. |
| tx | An array of transaction identifiers (if verbosity is 1) or detailed transaction objects (if verbosity is 2). |
| time | The block time in UNIX timestamp format. |
| mediantime | The median block time of the previous 11 blocks. |
| nonce | The block nonce. |
| bits | The block difficulty target as a hex string. |
| difficulty | The block difficulty. |
| chainwork | he total work in the blockchain up to this block. |
| nTx | The number of transactions in the block. |
| previousblockhash | The hash of the previous block. |
| nextblockhash | The hash of the next block (if available). |
Request Example
curl --location 'https://api.tatum.io/v3/blockchain/node/bitcoin-mainnet/' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {API_KEY}' \
--data '{
"id": 1,
"jsonrpc": "2.0",
"method": "getblock",
"params": [
"000000000000000000013d0a85b72c591500abe074a7f9175c596a194f67b82d",
1
]
}'
// yarn add @tatumio/tatum
import { TatumSDK, Bitcoin, Network } from '@tatumio/tatum'
const tatum = await TatumSDK.init<Bitcoin>({ network: Network.BITCOIN })
const result = await tatum.rpc.getBlock('000000000000000000013d0a85b72c591500abe074a7f9175c596a194f67b82d')
await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs