{"uid":"cap_82lv487bdgdAnevtSDxJB","slug":"blockscout-bens-domain-lookup-by-chain-24684104","name":"Blockscout BENS Domain Lookup by Chain","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/domains/%7Bname%7D","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":{"name":{"type":"string"},"chain_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"only_active":{"type":"boolean"},"protocol_id":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":"string","name":"string","owner":{"hash":"string","ens_domain_name":"string"},"tokens":[{"id":"string","type":"string","contract_hash":"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"},"registrant":{"hash":"string","ens_domain_name":"string"},"expiry_date":"string","wrapped_owner":{"hash":"string","ens_domain_name":"string"},"other_addresses":{},"stored_offchain":true,"resolved_address":{"hash":"string","ens_domain_name":"string"},"resolver_address":{"hash":"string","ens_domain_name":"string"},"protocol_dapp_url":"string","registration_date":"string","protocol_dapp_logo":"string","resolved_with_wildcard":true}},"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_i7W9F3__Oq7EV9yjR2-Pf","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":"Retrieves detailed ENS-style domain name information for a specific domain on a given blockchain network via Blockscout's Name Service (BENS)","exampleAgentPrompt":"Can you look up the domain 'vitalik.eth' on Ethereum (chain ID 1) using Blockscout and tell me who owns it, what address it resolves to, and when it expires?","exampleUseCases":[{"title":"Resolve wallet address from crypto domain","prompt":"I want to send funds to 'alice.eth' on Ethereum mainnet — can you use Blockscout to look up what wallet address that domain resolves to right now?"},{"title":"Check domain expiry before bidding","prompt":"Before I try to register 'cooldomain.eth' on chain 1, can you check Blockscout to see if it's still active and when it expires?"},{"title":"Audit domain ownership for a dapp","prompt":"I need to verify who currently owns the domain 'myprotocol.base' on the Base network (chain ID 8453) — can you pull the owner, registrant, and protocol info from Blockscout?"}],"resultDescription":"Returns a JSON object containing the domain's owner address (with optional ENS name), resolved address, registrant, wrapped owner, resolver address, registration and expiry dates, associated token IDs and types, protocol metadata (title, description, docs URL, icon, TLD list), dapp URL, dapp logo, and flags for off-chain storage and wildcard resolution.","failureModes":["Domain not found on the specified chain — returns empty or 404 response","Invalid chain_id — may return an error or unsupported chain response","Malformed domain name — endpoint may reject or return no results","Network timeout for heavily loaded chains","Domain exists but has no resolved address set — resolved_address field will be null"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured domain name resolution data for a specific blockchain network and domain name, including ownership, expiry, protocol, and token details. Prefer it over generic ENS libraries when you need cross-chain support, protocol metadata, or dapp-level context that Blockscout's BENS aggregates. Best when the chain_id and domain name are both known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:40.772Z","isFirstParty":false}