# Blockscout Address Withdrawals

> Blockscout Address Withdrawals 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-13).

Retrieves paginated withdrawal records for a specific address on a given blockchain network via Blockscout's multichain explorer

## Facts

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

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-address-withdrawals-0b36ba2c
```

Example prompt: Can you pull up all the withdrawal records for the address 0x1234...abcd on the Ethereum mainnet chain using Blockscout, and show me the first 25 entries?

## When to prefer this

Choose this endpoint when you need to specifically retrieve withdrawal records (e.g. beacon chain validator withdrawals, staking withdrawals) for a particular address on a specific blockchain network. It is more targeted than general transaction history endpoints and includes validator-specific fields like validator_index. Prefer this over general transaction search when the user's focus is on withdrawal-type operations rather than all transactions.

## Known failure modes

- Invalid or malformed address_hash_param returns an error or empty result
- Unsupported or incorrect chain_id returns a 404 or empty response
- Pagination index out of range returns empty items array
- Network timeout or upstream chain node unavailability causes 5xx errors
- Address with no withdrawal history returns empty items list

## 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 withdrawal records for the specified address on the given chain. Each item includes the withdrawal index, amount (as string), timestamp, block number, validator index, and detailed receiver address metadata (hash, name, ENS domain, proxy type, reputation, scam flag, contract status, verification status, public/private tags, watchlist names, and implementations). 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"
      },
      "address_hash_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-address-withdrawals-0b36ba2c/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)