> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocks

> Complete Ethereum & EVM block header data via REST API — block hash, gas, miner, timestamps. Historical and real-time, 10 chains.

## Overview

* **Dataset ID:** `0101`
* **Table:** `blockdb_evm.b0101_blocks_v1`
* **Description:** Canonical block headers with BlockDB integrity metadata
* **Primary key:** `block_number`
* **API:** [POST /evm/raw/blocks](/api-reference/evm/primitives/blocks)
* **CSV Sample:** [Download](https://huggingface.co/datasets/BlockDB/Raw-Blocks-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0101_blocks_v1.csv?download=true)
* **JSON Sample:** [Download](https://huggingface.co/datasets/BlockDB/Raw-Blocks-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0101_blocks_v1.json?download=true)

## Sample Viewer

<Frame>
  <iframe src="https://huggingface.co/datasets/BlockDB/Raw-Blocks-Ethereum-And-EVM-Cryptocurrency-Data/embed/viewer/default/train" frameborder="0" width="100%" height="600px" />
</Frame>

## Columns

| Column                            | Type          | Description                                                    |
| --------------------------------- | ------------- | -------------------------------------------------------------- |
| `block_number`                    | `BIGINT`      | Monotonic block height (chain-local). Primary key.             |
| `block_hash`                      | `BYTEA`       | 32B Keccak block hash.                                         |
| `parent_block_hash`               | `BYTEA`       | 32B hash of the parent block.                                  |
| `receipt_root`                    | `BYTEA`       | 32B receipts trie root from block header.                      |
| `miner`                           | `BYTEA`       | 20B fee recipient (coinbase) address.                          |
| `gas_limit`                       | `BIGINT`      | Block gas limit.                                               |
| `extra_data`                      | `BYTEA`       | Up to 32B extra data from header.                              |
| `size`                            | `BIGINT`      | Encoded block size (bytes).                                    |
| `timestamp_utc`                   | `TIMESTAMPTZ` | Block timestamp as `timestamptz` (UTC, microsecond precision). |
| `_tracing_id`                     | `BYTEA`       | BlockDB tracing ID; unique.                                    |
| `_computed_receipt_root`          | `BYTEA`       | Recomputed receipts root (BlockDB integrity check).            |
| `_computed_receipt_timestamp_utc` | `TIMESTAMPTZ` | UTC timestamp when receipts root was (re)computed.             |
| `_created_at`                     | `TIMESTAMPTZ` | Record creation timestamp.                                     |
| `_updated_at`                     | `TIMESTAMPTZ` | Record last update timestamp.                                  |

## Use Cases

* Chain reconstruction and blockchain state verification
* Block production and mining analytics
* Gas market analysis and block space utilization
* Chain reorganization detection and handling
* Foundation for transaction and log indexing
* Block-level time series analysis and chain health monitoring

## Related Datasets

<CardGroup cols={3}>
  <Card title="Transactions" icon="arrow-right-arrow-left" href="/data-catalog/evm/primitives/transactions">
    EVM transaction records with gas, status, and calldata.
  </Card>

  <Card title="Logs" icon="list" href="/data-catalog/evm/primitives/logs">
    Smart contract event logs tied to each block.
  </Card>

  <Card title="Internal Transactions" icon="sitemap" href="/data-catalog/evm/primitives/internal-transactions">
    Nested calls and value flows within transactions.
  </Card>
</CardGroup>