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

Looks up blockchain domain names (ENS and other naming protocols) across multiple chains, returning owner, resolved address, protocol, and registration metadata

## Facts

- Endpoint: GET https://api.blockscout.com/services/bens/api/v1/domains:lookup
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-bens-domain-lookup-790760c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZqJEJmw53PodmifROlRUn

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-790760c0
```

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

## When to prefer this

Choose this endpoint when you need to resolve or look up blockchain domain names (ENS, BENS, or other naming protocols) across multiple chains and want rich metadata including owner, resolved address, expiry, and protocol details. Prefer it over generic blockchain explorers when you need cross-chain domain name service lookups in a single call, especially when filtering by protocol or chain ID matters.

## Known failure modes

- No results returned if the domain name does not match any registered records
- Invalid chain_id returns empty results or an error
- Unsupported protocol name causes empty result set
- Pagination token mismatch causes unexpected result ordering
- Rate limiting or payment failure (402) if USDC micropayment is not supplied
- Domain records may be stale if on-chain state has changed recently

## 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 paginated list of domain records, each containing the domain name and ID, owner address with optional ENS name, resolved wallet address, wrapped owner, registration and expiry dates, protocol details (name, title, docs, icon, TLDs, description, Blockscout base URL), and a link to the protocol dapp. Also returns pagination params for fetching subsequent pages.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "sort": {
       "type": "string"
      },
      "order": {
       "type": "string"
      },
      "chain_id": {
       "type": "string"
      },
      "page_size": {
       "type": "integer"
      },
      "protocols": {
       "type": "string"
      },
      "page_token": {
       "type": "string"
      },
      "only_active": {
       "type": "boolean"
      },
      "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": {
  "items": [
   {
    "id": "string",
    "name": "string",
    "owner": {
     "hash": "string",
     "ens_domain_name": "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"
    },
    "expiry_date": "string",
    "wrapped_owner": {
     "hash": "string",
     "ens_domain_name": "string"
    },
    "resolved_address": {
     "hash": "string",
     "ens_domain_name": "string"
    },
    "protocol_dapp_url": "string",
    "registration_date": "string",
    "protocol_dapp_logo": "string"
   }
  ],
  "next_page_params": {
   "page_size": 0,
   "page_token": "string"
  }
 }
}
```

## More

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