# Blockscout BENS Domain Lookup by Chain

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

Retrieves detailed ENS-style domain name information for a specific domain on a given blockchain network via Blockscout's Name Service (BENS)

## Facts

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

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-by-chain-24684104
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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"
      },
      "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"
    }
   }
  }
 }
}
```

## 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-by-chain-24684104/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)