# Blockscout BENS Address Domain Lookup

> Blockscout BENS Address Domain Lookup is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-10).

Looks up ENS-compatible domain name records associated with a blockchain address across multiple protocols and chains via Blockscout's name service (BENS)

## Facts

- Endpoint: GET https://api.blockscout.com/services/bens/api/v1/addresses/%7Baddress%7D
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-bens-address-domain-lookup-1f52f54a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i5jWNWXflSvQH7Kxzmnil

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-bens-address-domain-lookup-1f52f54a
```

Example prompt: Can you look up what domain name is associated with the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum using Blockscout's naming service?

## When to prefer this

Use this endpoint when you need to resolve a raw blockchain address to its human-readable ENS or naming-protocol domain name, especially across multiple chains or protocols simultaneously. Prefer this over generic ENS resolvers when you need cross-chain coverage, protocol metadata, expiry/registration dates, or token associations in one call. Best suited for agents enriching address data with web3 identity context.

## Known failure modes

- Address not found — no domain registered or resolvable for the given address
- Invalid address format — malformed or non-checksummed address returns an error
- Unsupported chain ID — the specified chain is not indexed by Blockscout BENS
- Protocol filter mismatch — specified protocol not available for the given chain
- Payment failure — x402 micropayment not completed, access denied
- Rate limiting or service unavailability — 429 or 503 responses

## How this service works

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

## Output

Returns a domain object containing the domain name, ID, owner hash and ENS name, registrant details, resolved address, resolver address, expiry and registration dates, associated tokens, protocol metadata (title, docs URL, icon, TLD list), and a count of resolved domains. Also indicates whether the domain is stored offchain or resolved via wildcard.

## Request schema (JSON Schema)

```json
{
 "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": {
      "address": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "protocols": {
       "type": "string"
      },
      "all_protocols": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "domain": {
   "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
  },
  "resolved_domains_count": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-bens-address-domain-lookup-1f52f54a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)