ENS Batch Resolution API - Technical Specification

Batch-resolve Ethereum addresses to ENS names and social profile fields.

5|2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/buzzbysolcex/buzz-bd-agent --skill ens-batch-resolution-api-technical-specification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ENS Batch Resolution API - Technical Specification
Source: https://github.com/buzzbysolcex/buzz-bd-agent/tree/main/bake/skills/atv-batch-skill
Command: npx skills add https://github.com/buzzbysolcex/buzz-bd-agent --skill ens-batch-resolution-api-technical-specification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly enrich Ethereum addresses by resolving their ENS names and optionally pulling matching social profile fields in a single batch workflow.

Core Features & Use Cases

  • Batch ENS reverse lookup: Resolve up to 100 comma-separated addresses per request.
  • Selective enrichment via include: Control which fields are returned (name, avatar, twitter, github, discord, email, url) and avoid unnecessary data.
  • Structured responses with metadata: Read results per address plus operational details like cache hits, processing time, and free-tier usage.

Example use case: enrich a list of token deployer addresses during security research so you can score identities based on ENS and social proof.

Quick Start

Use the batch-resolve endpoint to resolve a comma-separated list of addresses with include=name,twitter,github.

Frequently Asked Questions about ENS Batch Resolution API - Technical Specification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve multiple Ethereum addresses to ENS names in a single request?

Batch ENS reverse lookup resolves multiple Ethereum addresses to ENS names by sending a GET request with comma-separated addresses to the batch-resolve endpoint. You can process up to 100 addresses per call for efficient identity enrichment.

Can I retrieve social profiles like Twitter and GitHub when resolving ENS names?

Yes, social profiles like Twitter and GitHub can be retrieved during ENS resolution by specifying the include parameter with desired fields. Supported fields include name, avatar, twitter, github, discord, email, and url for selective enrichment.

What is the maximum number of addresses I can resolve per batch API call?

The maximum batch size for resolving Ethereum addresses to ENS names is 100 addresses per API call. This limit ensures efficient handling of address annotation tasks while providing structured responses with per-address results and operational metadata.

How does the batch ENS resolution API handle caching metadata?

The batch ENS resolution API returns caching metadata alongside per-address results, indicating cache hits and processing time. This caching metadata helps optimize subsequent identity enrichment workflows and monitor free-tier usage during security research.

What metadata is included in the response when resolving ENS names in batches?

Responses include per-address ENS resolution results plus operational metadata such as cache hits, processing time, and free-tier usage guidance. This structured response format supports identity enrichment and security research workflows effectively.

When should I use batch ENS resolution instead of individual address lookups?

Batch ENS resolution is ideal for identity enrichment, security research, and address annotation tasks involving multiple Ethereum addresses. Processing up to 100 addresses per call reduces request overhead and provides structured social profile data for comprehensive analysis.