# Blockscout Block Withdrawals API

> Blockscout Block Withdrawals API 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).

Retrieves a paginated list of beacon chain withdrawals for a specific block on a given blockchain network

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/blocks/%7Bblock_hash_or_number_param%7D/withdrawals
- 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-withdrawals-api-236199da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lW5ZP2YjgZOw6Vl1BAKSC

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-withdrawals-api-236199da
```

Example prompt: Can you pull up all the beacon chain withdrawals for block 19500000 on Ethereum using Blockscout's multichain explorer?

## When to prefer this

Use this endpoint when you need structured, paginated withdrawal data for a specific block on a supported blockchain network via Blockscout. Prefer this over generic RPC calls when you need enriched receiver metadata (ENS names, scam flags, tags, contract status) alongside withdrawal amounts. Ideal for analytics, auditing, or monitoring beacon chain staking withdrawals block by block.

## Known failure modes

- Invalid chain_id returns 404 or empty response
- Non-existent block hash or number returns 404
- Block with no withdrawals returns empty items array
- Invalid pagination parameters may cause unexpected truncation
- Rate limiting or payment failure returns 402 or 429
- Unsupported chain_id may return an error or unsupported response

## 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 beacon chain withdrawal objects, each containing the withdrawal index, amount, receiver address details (including hash, name, scam flag, contract status, ENS domain, proxy type, public/private tags), block number, validator index, and timestamp. Also returns 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"
      },
      "block_hash_or_number_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "index": {
       "type": "integer"
      },
      "items_count": {
       "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": [
   {
    "index": 0,
    "amount": "string",
    "receiver": {
     "hash": "string",
     "name": "string",
     "is_scam": true,
     "metadata": {},
     "proxy_type": "string",
     "reputation": "string",
     "is_contract": true,
     "is_verified": true,
     "public_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "private_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "ens_domain_name": "string",
     "implementations": [
      {
       "name": "string",
       "address_hash": "string"
      }
     ],
     "watchlist_names": [
      {
       "label": "string",
       "display_name": "string"
      }
     ]
    },
    "timestamp": "string",
    "block_number": 0,
    "validator_index": 0
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-block-withdrawals-api-236199da/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)