# Blockscout Optimism Withdrawals API

> Blockscout Optimism 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-11).

Retrieves paginated list of Optimism L2-to-L1 withdrawal transactions for a given chain, including status, value, nonce, and transaction hashes

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/optimism/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-optimism-withdrawals-api-77f3f664
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_32VYvVgMZRbMziNcgM-dy

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-withdrawals-api-77f3f664
```

Example prompt: Can you pull up the latest Optimism withdrawal transactions for chain ID 10 using Blockscout — I want to see their statuses, nonces, and whether any have finalized on L1?

## When to prefer this

Use this endpoint when you specifically need Optimism L2-to-L1 bridge withdrawal data — including status, challenge periods, and settlement hashes — for an OP-stack chain. Prefer it over generic transaction search when you need structured withdrawal-specific fields like msg_nonce, challenge_period_end, or portal_contract_address_hash.

## Known failure modes

- Invalid or unsupported chain_id returns empty results or 404
- Missing required path parameter chain_id causes routing failure
- Pagination with incorrect items_count or nonce may return unexpected page boundaries
- Chain not running Optimism stack returns no withdrawal data
- Rate limiting or payment failure (402) blocks the request

## 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 JSON response containing an array of Optimism withdrawal items, each with sender address details (including ENS, tags, scam flags), withdrawal status, message data, nonce, value, gas limit, L1 and L2 transaction hashes, challenge period end time, and portal contract address, plus 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"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "nonce": {
       "type": "string"
      },
      "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": [
   {
    "from": {
     "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"
      }
     ]
    },
    "status": "string",
    "msg_data": "string",
    "msg_nonce": 0,
    "msg_value": "string",
    "l2_timestamp": "string",
    "msg_gas_limit": "string",
    "msg_nonce_raw": "string",
    "msg_nonce_version": 0,
    "l1_transaction_hash": "string",
    "l2_transaction_hash": "string",
    "challenge_period_end": "string",
    "msg_sender_address_hash": "string",
    "msg_target_address_hash": "string",
    "portal_contract_address_hash": "string"
   }
  ],
  "next_page_params": {}
 }
}
```

## More

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