# Blockscout BENS Address Lookup by Chain

> Blockscout BENS Address Lookup by Chain 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 blockchain name service (ENS-style) domain and address metadata for a given address on a specific chain via Blockscout's multichain explorer

## Facts

- Endpoint: GET https://api.blockscout.com/services/bens/api/v1/%7Bchain_id%7D/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-lookup-by-chain-d12bc768
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KJk2Wsx5Q8G8zxuHRPeSD

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-lookup-by-chain-d12bc768
```

Example prompt: Can you look up the blockchain name service domain details for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum (chain ID 1) using Blockscout?

## When to prefer this

Use this endpoint when you need to resolve a specific blockchain address to its name service domain (ENS-style) metadata on a particular chain, and want rich protocol/dapp context alongside ownership and expiry data. Prefer this over generic ENS resolvers when you need multichain support, protocol-level metadata, or Blockscout's cross-chain indexing. It's ideal for wallet identity enrichment, domain ownership verification, or auditing dapp affiliations tied to a blockchain address.

## Known failure modes

- Invalid or malformed chain_id returns an error or empty result
- Address not found on the specified chain returns null domain
- Unsupported chain_id returns a 404 or empty response
- Rate limiting or payment failure returns a 402 Payment Required
- Invalid address format returns a validation error
- Protocol ID filter returns no results if the address isn't registered under that protocol

## 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 JSON object containing the blockchain name service domain record for the given address and chain, including the domain name, owner hash, ENS domain name, registrant, resolved address, resolver address, expiry date, registration date, associated tokens, protocol metadata (title, docs URL, icon, TLD list, short name, description, deployment base URL), wrapped owner, and resolved domains count. If no domain is found, the domain object may be null or empty.

## 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"
      },
      "chain_id": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "protocol_id": {
       "type": "string"
      }
     }
    }
   },
   "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-lookup-by-chain-d12bc768/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)