{"uid":"cap_EZslnKosg_PlJbAMF672U","slug":"blockscout-multichain-block-search-bbb3e930","name":"Blockscout Multichain Block Search","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/services/multichain/api/v1/clusters/%7Bcluster_id%7D/search/blocks","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":{"cluster_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"q":{"type":"string"},"chain_id":{"type":"array"},"page_size":{"type":"integer"},"page_token":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"hash":"string","chain_id":"string","hash_type":"string"}],"next_page_params":{"page_size":0,"page_token":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jv0ttYsQ0A5LT59GJpYUg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for blocks by query across one or more blockchain networks within a Blockscout cluster","exampleAgentPrompt":"Search Blockscout for any blocks matching hash 0x3f5b2a across all chains in cluster mainnet-evm, returning up to 10 results.","exampleUseCases":[{"title":"Cross-chain block hash lookup","prompt":"I have a block hash 0xa1b2c3d4e5f6... and I'm not sure which chain it's on — can you search for it across all networks in the Blockscout mainnet cluster and tell me where it appears?"},{"title":"Blockchain forensics across EVM chains","prompt":"Search for any blocks related to hash 0xdeadbeef123 across Ethereum and Polygon in the Blockscout multichain cluster and show me the first 5 results."},{"title":"Cross-chain block explorer for dApp auditing","prompt":"I need to audit block data — can you look up blocks matching the query '19000000' across all chains in the Blockscout mainnet-evm cluster with a page size of 20?"}],"resultDescription":"Returns a paginated list of block records matching the search query, each containing the block hash, the chain ID it was found on, and the hash type. Also includes next_page_params with page_token and page_size for fetching additional results.","failureModes":["Invalid or unknown cluster_id returns a 404 or empty result","Missing required query parameter 'q' may return an error or empty items array","Invalid chain_id values in the array may be silently ignored or return an error","Pagination with an expired or invalid page_token may return unexpected results","Rate limiting or payment failure (x402) if USDC payment is not properly attached"],"whenToPreferThis":"Use this endpoint when you need to search for blocks by hash or number across multiple blockchain networks simultaneously within a Blockscout cluster. Prefer this over single-chain block lookup endpoints when you don't know which chain a block belongs to, or when you need cross-chain coverage in a single API call. Best suited for multichain explorers, forensic tools, and agents that operate across EVM-compatible networks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T00:48:05.217Z","isFirstParty":false}