# Blockscout BENS Domain Lookup

> Blockscout BENS 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-12).

Resolves a blockchain domain name (e.g. ENS) to its owner, resolved address, tokens, and protocol metadata across chains

## Facts

- Endpoint: GET https://api.blockscout.com/services/bens/api/v1/domains/%7Bname%7D
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-bens-domain-lookup-81439ac7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H1zQOuXMeJODtyz6A5Hu1

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-domain-lookup-81439ac7
```

Example prompt: Can you look up the domain 'vitalik.eth' on Blockscout and tell me what address it resolves to, who owns it, and when it expires?

## When to prefer this

Choose this endpoint when you need to resolve or inspect a specific blockchain domain name (such as ENS, Unstoppable Domains, or other naming protocols) and want structured metadata including owner, resolved address, tokens, and protocol info. It is preferable over generic blockchain explorers when you need cross-chain domain resolution in a single API call, or when you want protocol-level details alongside address resolution.

## Known failure modes

- Domain name not found — returns empty or 404 if the domain does not exist on the specified chain or protocol
- Invalid chain_id — may return an error or empty result if the chain is unsupported
- Expired or inactive domain — if only_active is true, expired domains will be excluded from results
- Malformed domain name — improperly formatted names may return errors
- Protocol not supported — specifying an unsupported protocol_id returns no results

## 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 with the domain's resolved address, owner hash and ENS name, registrant, wrapped owner, resolver address, associated tokens (with type and contract), protocol details (name, title, docs URL, icon, TLD list), registration date, expiry date, whether it is stored offchain, whether it was resolved via wildcard, and the dapp URL and logo for the underlying naming protocol.

## 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": {
      "name": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "only_active": {
       "type": "boolean"
      },
      "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": {
  "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-bens-domain-lookup-81439ac7/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)