# OpenVerbs ENS Records Lookup

> OpenVerbs ENS Records Lookup is a paid API for AI agents from chain.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Resolves an ENS name to its Ethereum address and text records (avatar, URL, email, Twitter, GitHub, etc.) in a single live call from the Ethereum mainnet resolver.

## Facts

- Endpoint: POST https://chain.openverbs.com/v1/ens-records
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-ens-records-lookup-43e3a777
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AXiDmQ_9mU5_q9gMELW83

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 openverbs-ens-records-lookup-43e3a777 -d '<json body>'
```

Example prompt: Look up the Ethereum address, avatar, Twitter, GitHub, and email linked to vitalik.eth — fetch all the default text records in one shot.

## When to prefer this

Use this endpoint when you need to resolve an ENS name to its Ethereum address AND retrieve associated text records (social handles, avatar, email, website) in a single call. It reads live from mainnet with automatic fallback, making it more reliable than a single-node RPC call. Prefer this over generic RPC calls when you want structured, pre-parsed ENS profile data rather than raw ABI-encoded resolver responses.

## Known failure modes

- ENS name does not exist or is unregistered — empty or error response
- ENS name is expired — resolver may return no records
- No records set for the requested keys — empty records object returned
- Invalid ENS name format — validation error
- Rate limiting or RPC node unavailability — fallback attempted, then error
- Network timeout on slow Ethereum node response

## How this service works

Read an ENS name's address plus its text records (avatar, url, email, description, com.twitter, com.github and more) in one call, live from the resolver on Ethereum mainnet. Pass `keys` to fetch specific records, or omit it for a sensible default set. Only records that are set are returned. Live reads with automatic endpoint fallback.

## Output

Returns a JSON object containing the resolved Ethereum address for the ENS name and any text records that are set (e.g. avatar, description, url, email, com.twitter, com.github, org.telegram, com.discord). Only records with values are included in the response. Records are read live from the Ethereum mainnet ENS resolver with automatic endpoint fallback.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string",
       "description": "ENS name, e.g. vitalik.eth."
      },
      "keys": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "maxItems": 12,
       "description": "Text-record keys to read (max 12). Omit for defaults: avatar, description, url, email, com.twitter, com.github, org.telegram, com.discord."
      }
     },
     "required": [
      "name"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-ens-records-lookup-43e3a777/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.openverbs.com](https://www.zero.xyz/host/chain.openverbs.com/llms.txt)