# Blockscout Block Details by Chain

> Blockscout Block Details by Chain is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-10).

Retrieve detailed metadata for a specific block by hash or number on a given blockchain network via Blockscout's multichain explorer API

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/blocks/%7Bblock_hash_or_number_param%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-block-details-by-chain-24224ad7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xelQVCFlj0nJG3Lbhwt9h

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-block-details-by-chain-24224ad7
```

Example prompt: Pull up the full details for block number 19500000 on Ethereum using Blockscout — I want to see the miner, gas usage, transaction count, and any block rewards.

## When to prefer this

Use this endpoint when you need detailed, structured block-level data (gas, miner, rewards, transaction counts, timestamps) for a specific block on a specific chain. Prefer this over generic RPC calls when you need Blockscout's enriched data model including burnt fees, priority fees, and chain-specific metadata like Arbitrum batch info. Ideal for multichain scenarios where you need a unified API across networks rather than chain-native RPCs.

## Known failure modes

- Invalid chain_id returns 404 or empty response
- Block hash or number not found on the specified chain returns 404
- Malformed block hash format returns 400 bad request
- Chain not supported by Blockscout returns error
- Payment not included or insufficient USDC balance causes 402 Payment Required
- Rate limiting or network timeout causes 5xx error

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a JSON object with comprehensive block metadata including: block hash, height, size, type, miner info, nonce, timestamp, gas used and limit, burnt fees, base fee per gas, difficulty, total difficulty, parent hash, priority fee, transaction fees, transaction count, internal transaction count, withdrawals count, uncle hashes, gas used/target/burnt percentages, block rewards breakdown, and chain-specific fields (e.g. Arbitrum batch/commitment data).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "block_hash_or_number_param": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hash": "string",
  "size": 0,
  "type": "string",
  "miner": {},
  "nonce": "string",
  "height": 0,
  "rewards": [
   {
    "type": "string",
    "reward": "string"
   }
  ],
  "arbitrum": {
   "status": "string",
   "send_root": "string",
   "send_count": 0,
   "batch_number": 0,
   "l1_block_number": 0,
   "delayed_messages": 0,
   "batch_data_container": "string",
   "commitment_transaction": {
    "hash": "string",
    "status": "string",
    "timestamp": "string"
   },
   "confirmation_transaction": {
    "hash": "string",
    "status": "string",
    "timestamp": "string"
   }
  },
  "gas_used": "string",
  "gas_limit": "string",
  "timestamp": "string",
  "burnt_fees": "string",
  "difficulty": "string",
  "parent_hash": "string",
  "priority_fee": "string",
  "uncles_hashes": [
   {
    "hash": "string"
   }
  ],
  "base_fee_per_gas": "string",
  "total_difficulty": "string",
  "transaction_fees": "string",
  "is_pending_update": true,
  "withdrawals_count": 0,
  "transactions_count": 0,
  "gas_used_percentage": 0,
  "burnt_fees_percentage": 0,
  "gas_target_percentage": 0,
  "internal_transactions_count": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-block-details-by-chain-24224ad7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)