{"uid":"cap_32VYvVgMZRbMziNcgM-dy","slug":"blockscout-optimism-withdrawals-api-77f3f664","name":"Blockscout Optimism Withdrawals API","description":"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","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/optimism/withdrawals","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-NDts-uukl1vJxC8oY-ZF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves paginated list of Optimism L2-to-L1 withdrawal transactions for a given chain, including status, value, nonce, and transaction hashes","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Monitor pending bridge withdrawals","prompt":"Show me all pending Optimism withdrawals on chain 10 so I can see which ones are still in the challenge period and haven't settled on L1 yet."},{"title":"Track a specific withdrawal by nonce","prompt":"I submitted an Optimism withdrawal with nonce 42 on chain 8453 — can you look it up on Blockscout and tell me if it's been proven or finalized on L1?"},{"title":"Audit withdrawal history for compliance","prompt":"Pull the last 50 Optimism withdrawal records from chain 10 on Blockscout, including sender addresses, values, and L1 transaction hashes, so I can audit our bridge activity."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:30:01.535Z","isFirstParty":false}