{"uid":"cap_zyz7RqPzlBGpf7unmM86F","slug":"blockscout-bens-batch-resolve-addresses-d95acab1","name":"Blockscout BENS Batch Resolve Addresses","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/bens/api/v1/addresses:batch-resolve","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"$ref":"#/definitions/v1BatchResolveAddressesMultichainRequest"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"names":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DPeeLZNcZ9Z3jZ59SJXHy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a batch of blockchain addresses to their human-readable names across multiple chains using Blockscout's Name Service","exampleAgentPrompt":"Can you resolve these wallet addresses to their human-readable names using Blockscout — 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B, and 0x71C7656EC7ab88b098defB751B7401B5f6d8976F?","exampleUseCases":[{"title":"Enrich transaction history with names","prompt":"I have a list of addresses that sent transactions to my contract — 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B, 0x71C7656EC7ab88b098defB751B7401B5f6d8976F — can you resolve them to readable names using Blockscout so I can display them in my dashboard?"},{"title":"Identify wallet holders by name","prompt":"Look up these three Ethereum wallet addresses on Blockscout and tell me if any of them have registered ENS or blockchain names: 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe, 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8, 0x742d35Cc6634C0532925a3b844Bc454e4438f44e"},{"title":"Display named senders in portfolio app","prompt":"For my portfolio tracker, can you batch resolve these addresses to their human-readable blockchain names using Blockscout: 0x1f9090aaE28b8a3dCeaDf281B0F12828e676c326, 0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5, 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97?"}],"resultDescription":"Returns a map (names object) of input addresses to their resolved human-readable names (e.g. ENS names or other blockchain name service labels). Addresses without registered names may return empty or null entries.","failureModes":["Empty names map returned if none of the input addresses have registered names","Invalid address format causes validation error","Too many addresses in a single batch may result in a timeout or error","Network or chain unavailability may prevent resolution for some addresses","Payment failure (402) if x402 micropayment is not properly included"],"whenToPreferThis":"Use this endpoint when you need to resolve multiple blockchain addresses to human-readable names in a single API call rather than one at a time. Prefer it over single-address lookups when enriching lists of addresses, displaying wallet holders, or annotating transaction history with names across multiple chains via Blockscout's unified name service index.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:45.259Z","isFirstParty":false}