{"uid":"cap_-pJ47Xidt1AYo0bT47OlR","slug":"blockscout-bens-address-lookup-f5fd63c2","name":"Blockscout BENS Address Lookup","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/%7Bchain_id%7D/addresses:lookup","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":{"sort":{"type":"string"},"order":{"type":"string"},"address":{"type":"string"},"owned_by":{"type":"boolean"},"page_size":{"type":"integer"},"protocols":{"type":"string"},"page_token":{"type":"string"},"only_active":{"type":"boolean"},"resolved_to":{"type":"boolean"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"id":"string","name":"string","owner":{"hash":"string","ens_domain_name":"string"},"protocol":{"id":"string","title":"string","docs_url":"string","icon_url":"string","tld_list":["string"],"short_name":"string","description":"string","deployment_blockscout_base_url":"string"},"expiry_date":"string","wrapped_owner":{"hash":"string","ens_domain_name":"string"},"resolved_address":{"hash":"string","ens_domain_name":"string"},"protocol_dapp_url":"string","registration_date":"string","protocol_dapp_logo":"string"}],"next_page_params":{"page_size":0,"page_token":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_avI5LvFwAmup4xF9kHLNb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up blockchain domain name records (ENS-style) by address on a specific chain, returning name, owner, resolver, and protocol metadata","exampleAgentPrompt":"Can you look up any blockchain domain names registered to wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum (chain ID 1), including only names that resolve to that address?","exampleUseCases":[{"title":"Wallet identity resolution for dApp","prompt":"I need to find all the ENS-style domain names that resolve to the address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Ethereum mainnet — show me their owner info and expiry dates."},{"title":"Domain ownership audit","prompt":"Can you check what blockchain domain names are owned by 0x1234567890abcdef1234567890abcdef12345678 on Polygon (chain ID 137)? I want to see the protocols they belong to and when they expire."},{"title":"Cross-chain identity lookup for KYC","prompt":"Look up any active blockchain name service registrations associated with wallet 0xDe0B295669a9FD93d5F28D9Ec85E40f4cb697BAe on chain 56 — filter for only active records and include the resolved address info."}],"resultDescription":"Returns a paginated list of blockchain domain name records matching the address query, each containing the domain name ID, human-readable name, owner address with optional ENS name, resolved address, wrapped owner, protocol details (name, docs, icon, TLD list), registration date, expiry date, and dapp URL. Also includes next_page_params for pagination.","failureModes":["Invalid or unsupported chain_id returns empty results or 404","Malformed wallet address format causes 400 bad request","Address with no registered domains returns empty items array","Protocol filter string with unknown protocol ID returns no results","Pagination token mismatch or expiry causes empty or repeated results","Rate limiting or payment failure (x402) returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve or enumerate blockchain naming service (ENS-style) records for a specific wallet address on a known chain. It is ideal for identity enrichment, displaying human-readable names for addresses, auditing domain ownership, and cross-checking domain resolution — especially when you know the chain ID and need protocol-level metadata. Prefer this over generic blockchain explorers when you specifically need name service lookup with protocol and expiry metadata across multiple naming systems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:40:51.938Z","isFirstParty":false}