# Blockscout Optimism Batch Blocks Lookup

> Blockscout Optimism Batch Blocks Lookup 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-14).

Retrieves the list of L2 blocks included in a specific Optimism batch on a given blockchain network via Blockscout's multichain explorer API

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/blocks/optimism-batch/%7Bbatch_number_param%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-optimism-batch-blocks-lookup-f9eb1332
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BrAA72e3E0ZRJ6t6ocrCt

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-optimism-batch-blocks-lookup-f9eb1332
```

Example prompt: Can you pull up all the L2 blocks included in Optimism batch number 8432 on chain ID 10 using Blockscout?

## When to prefer this

Use this endpoint when you need to enumerate the specific L2 blocks that were included in a particular Optimism rollup batch, especially when you need Optimism-specific metadata like commitment/confirmation transaction status, send root, and L1 block anchoring. Prefer this over generic block list endpoints when your query is batch-centric rather than block-height-centric.

## Known failure modes

- Invalid chain_id returns 404 or empty response
- Non-existent batch_number_param returns empty items array
- Malformed batch_number_param (non-integer) returns 400 bad request
- Chain not supported by Blockscout returns 404
- Rate limiting or payment failure returns 402 Payment Required
- Network timeout on slow chains returns 5xx

## 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 paginated list of L2 block objects included in the specified Optimism batch. Each block contains its hash, height, size, miner, nonce, timestamp, gas used, gas limit, burnt fees, priority fee, base fee per gas, transaction count, internal transaction count, withdrawals count, uncle hashes, and Optimism-specific metadata including batch number, L1 block number, send root, send count, batch data container, and the commitment and confirmation transaction details (hash, status, timestamp). Also includes next_page_params for pagination.

## 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"
      },
      "batch_number_param": {
       "type": "integer"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "items_count": {
       "type": "integer"
      },
      "block_number": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "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
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-optimism-batch-blocks-lookup-f9eb1332/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)