Block

A Bitcoin block including its transactions, header, and chain status.

CryptocurrencyBitcoinBlockchain DataExchangeMarket DataTradingPaymentsPublic APIs

Properties

Name	Type	Description
hash	string	Block hash.
ver	integer	Block version.
prev_block	string	Previous block hash.
mrkl_root	string	Merkle root.
time	integer	Block timestamp (Unix seconds).
bits	integer	Difficulty bits.
nonce	integer	Nonce used to mine the block.
n_tx	integer	Number of transactions in the block.
size	integer	Block size in bytes.
block_index	integer	Internal block index.
main_chain	boolean	True if this block is part of the main chain.
height	integer	Block height.
tx	array	List of transactions included in the block.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blockchain/refs/heads/main/json-schema/data-api-block-schema.json",
  "title": "Block",
  "description": "A Bitcoin block including its transactions, header, and chain status.",
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "description": "Block hash.",
      "example": "00000000000000000004f4e7a1..."
    },
    "ver": {
      "type": "integer",
      "description": "Block version.",
      "example": 536870912
    },
    "prev_block": {
      "type": "string",
      "description": "Previous block hash."
    },
    "mrkl_root": {
      "type": "string",
      "description": "Merkle root."
    },
    "time": {
      "type": "integer",
      "format": "int64",
      "description": "Block timestamp (Unix seconds).",
      "example": 1748609400000
    },
    "bits": {
      "type": "integer",
      "description": "Difficulty bits.",
      "example": 1
    },
    "nonce": {
      "type": "integer",
      "format": "int64",
      "description": "Nonce used to mine the block.",
      "example": 1
    },
    "n_tx": {
      "type": "integer",
      "description": "Number of transactions in the block.",
      "example": 1
    },
    "size": {
      "type": "integer",
      "description": "Block size in bytes.",
      "example": 1
    },
    "block_index": {
      "type": "integer",
      "format": "int64",
      "description": "Internal block index.",
      "example": 1
    },
    "main_chain": {
      "type": "boolean",
      "description": "True if this block is part of the main chain.",
      "example": true
    },
    "height": {
      "type": "integer",
      "description": "Block height.",
      "example": 851234
    },
    "tx": {
      "type": "array",
      "description": "List of transactions included in the block.",
      "items": {
        "type": "object",
        "description": "A Bitcoin transaction with its inputs and outputs.",
        "properties": {
          "hash": {
            "type": "string",
            "description": "Transaction hash.",
            "example": "00000000000000000004f4e7a18a09b1f8e96d6fb01d9b6fce4d12cb3f8a7e21"
          },
          "ver": {
            "type": "integer",
            "description": "Transaction version.",
            "example": 1
          },
          "vin_sz": {
            "type": "integer",
            "description": "Number of inputs.",
            "example": 1
          },
          "vout_sz": {
            "type": "integer",
            "description": "Number of outputs.",
            "example": 1
          },
          "size": {
            "type": "integer",
            "description": "Serialized transaction size in bytes.",
            "example": 1
          },
          "weight": {
            "type": "integer",
            "description": "Transaction weight (BIP141).",
            "example": 1
          },
          "fee": {
            "type": "integer",
            "format": "int64",
            "description": "Fee paid in Satoshi.",
            "example": 1
          },
          "relayed_by": {
            "type": "string",
            "description": "IP address that relayed the transaction."
          },
          "lock_time": {
            "type": "integer",
            "format": "int64",
            "description": "Lock time (block height or Unix seconds).",
            "example": 1748609400000
          },
          "tx_index": {
            "type": "integer",
            "format": "int64",
            "description": "Internal transaction index.",
            "example": 1
          },
          "double_spend": {
            "type": "boolean",
            "description": "True if the transaction is a known double-spend.",
            "example": true
          },
          "time": {
            "type": "integer",
            "format": "int64",
            "description": "First-seen time (Unix seconds).",
            "example": 1748609400000
          },
          "block_index": {
            "type": "integer",
            "format": "int64",
            "description": "Block index containing the transaction (null if unconfirmed).",
            "example": 1
          },
          "block_height": {
            "type": "integer",
            "description": "Block height containing the transaction (null if unconfirmed).",
            "example": 851234
          },
          "inputs": {
            "type": "array",
            "description": "Transaction inputs.",
            "items": {
              "$ref": "#/components/schemas/TxInput"
            }
          },
          "out": {
            "type": "array",
            "description": "Transaction outputs.",
            "items": {
              "$ref": "#/components/schemas/TxOutput"
            }
          }
        }
      }
    }
  }
}