# Blockscout Chain Withdrawals Endpoint

> Blockscout Chain Withdrawals Endpoint 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-11).

Retrieves paginated withdrawal records (e.g. validator exits, beacon chain withdrawals) for a specified blockchain network via Blockscout's multichain explorer API

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/withdrawals
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-chain-withdrawals-endpoint-dc602e28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XjueoieElOEDwfmY6h1UI

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-chain-withdrawals-endpoint-dc602e28
```

Example prompt: Can you pull the latest 25 validator withdrawal records on Ethereum using Blockscout, starting from index 100? I want to see the receiver addresses, amounts, and block numbers.

## When to prefer this

Use this endpoint when you need on-chain validator or beacon-chain withdrawal data for a specific network supported by Blockscout. It is ideal for paginating through withdrawal history with rich receiver metadata (ENS names, scam flags, contract info). Prefer this over generic block explorers when you need structured, machine-readable withdrawal records across multiple EVM chains in a single API surface.

## Known failure modes

- Invalid or unsupported chain_id returns an error or empty result
- Malformed index/items_count parameters cause a 400 bad request
- Chain with no withdrawal history returns empty items array
- Rate limiting or payment failure returns a 402 or 429 response
- Pagination cursor mismatch may return duplicate or skipped records

## 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 withdrawal objects, each containing the withdrawal index, token amount (as a string), receiver address details (hash, name, scam flag, contract status, ENS domain, tags), the block number, timestamp, and validator index. Also includes next_page_params for cursor-based 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"
      }
     }
    },
    "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-chain-withdrawals-endpoint-dc602e28/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)