Skip to main content
GET
/
blocks
/
{block_number_or_hash}
get block info
curl --request GET \
  --url https://eth.blockscout.com/api/v2/blocks/{block_number_or_hash}
{
  "base_fee_per_gas": "26618801760",
  "burnt_fees": "261263193229977120",
  "burnt_fees_percentage": 85.19028810863084,
  "difficulty": "0",
  "extra_data": "TODO",
  "gas_limit": "30000000",
  "gas_target_percentage": -34.56675333333333,
  "gas_used": "9814987",
  "gas_used_percentage": 32.71662333333333,
  "hash": "0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a",
  "height": 17615720,
  "miner": {
    "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
    "implementation_name": "implementationName",
    "name": "contractName",
    "is_contract": true,
    "private_tags": [
      {
        "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "watchlist_names": [
      {
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "public_tags": [
      {
        "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "is_verified": true,
    "ens_domain_name": "domain.eth",
    "metadata": {
      "slug": "tag_slug",
      "name": "Tag name",
      "tagType": "name",
      "ordinal": 0,
      "meta": {}
    }
  },
  "nonce": "0x0000000000000000",
  "parent_hash": "0xd464e02d81e2bdf6bc5fa9b8e33f0b564c464a82d821a3e56531f8636dc00dfa",
  "priority_fee": "45418705646601378",
  "rewards": [
    {
      "reward": 123,
      "type": "Miner Reward | Emission Reward | Chore Reward | Uncle Reward"
    }
  ],
  "size": 49997,
  "state_root": "TODO",
  "timestamp": "2023-07-03T20:09:59.000000Z",
  "total_difficulty": "58750003716598352816469",
  "transactions_count": 120,
  "transaction_fees": "306681898876578498",
  "type": "block",
  "uncles_hashes": [
    "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
  ],
  "withdrawals_count": 16
}

Path Parameters

​
block_number_or_hash
string
required

Block number or hash

Response

block

​
base_fee_per_gas
string
required
Example:

"26618801760"

​
burnt_fees
string
required
Example:

"261263193229977120"

​
burnt_fees_percentage
number
required
Example:

85.19028810863084

​
difficulty
string
required
Example:

"0"

​
extra_data
string
required
Example:

"TODO"

​
gas_limit
string
required
Example:

"30000000"

​
gas_target_percentage
number
required
Example:

-34.56675333333333

​
gas_used
string
required
Example:

"9814987"

​
gas_used_percentage
number
required
Example:

32.71662333333333

​
hash
string
required
Example:

"0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a"

​
height
integer
required
Example:

17615720

​
miner
object
required
​
nonce
string
required
Example:

"0x0000000000000000"

​
parent_hash
string
required
Example:

"0xd464e02d81e2bdf6bc5fa9b8e33f0b564c464a82d821a3e56531f8636dc00dfa"

​
priority_fee
string
required
Example:

"45418705646601378"

​
rewards
object[]
required
​
size
integer
required
Example:

49997

​
state_root
string
required
Example:

"TODO"

​
timestamp
string
required
Example:

"2023-07-03T20:09:59.000000Z"

​
total_difficulty
string
required
Example:

"58750003716598352816469"

​
transactions_count
integer
required
Example:

120

​
transaction_fees
string
required
Example:

"306681898876578498"

​
type
string
required
Example:

"block"

​
uncles_hashes
string[]
required
​
withdrawals_count
integer
required
Example:

16