# Blockscout Arbitrum Batch Blocks Lookup

> Blockscout Arbitrum 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-12).

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

## Facts

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

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-arbitrum-batch-blocks-lookup-d479fc53
```

Example prompt: Can you pull up all the L2 blocks included in Arbitrum batch number 12345 on the Arbitrum One chain using Blockscout?

## When to prefer this

Use this endpoint when you specifically need to enumerate all L2 blocks within a single Arbitrum rollup batch, particularly for auditing batch composition, verifying L1 finalization status, or analyzing gas metrics at the batch level. Prefer it over general block search endpoints when you have a known Arbitrum batch number and need the full list of included blocks with Arbitrum-specific rollup metadata.

## Known failure modes

- Invalid or unknown chain_id returns an error or empty response
- Non-existent batch_number_param returns empty items array
- Malformed batch_number_param (non-integer) causes a 400 or validation error
- Rate limiting or payment failure returns a 402 or 429 response
- Chain not supported by Blockscout returns a 404 or empty result

## 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

A paginated list of L2 block objects included in the specified Arbitrum batch, each containing block hash, height, size, miner, timestamp, gas used/limit/percentage, burnt fees, transaction count, internal transaction count, and detailed Arbitrum-specific metadata (batch number, L1 block number, send root, send count, delayed messages, batch data container, commitment transaction hash/status/timestamp, confirmation transaction 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-arbitrum-batch-blocks-lookup-d479fc53/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)