# ENSWhois API

> Public API for querying ENS (Ethereum Name Service) domain data - WHOIS lookups, search, events, ownership history, resolver records, reverse resolution, and more.

## Base URL

```
https://api.enswhois.com
```

## Authentication

- **API Key**: Pass via `X-API-Key` header. Sign up at https://enswhois.com/signup for 1,000 free credits.
- **Micropayments (MPP)**: Pay per request using the MPP protocol (https://www.mpp.dev/). No account needed.
- **Unauthenticated**: Limited to 5 requests per minute.

CORS is enabled for all endpoints.

## Sections

- [How It Works](https://docs.enswhois.com/api/how-it-works)
- [Domains](https://docs.enswhois.com/api/domains): 14 endpoints
- [Addresses](https://docs.enswhois.com/api/addresses): 5 endpoints
- [System](https://docs.enswhois.com/api/system): 5 endpoints

## Endpoints

- `GET /whois/:name`
- `POST /whois/bulk`
- `GET /search-domains`
- `GET /domain/:name/events`
- `GET /domain/:name/subdomains`
- `GET /domain/:name/registration-history`
- `GET /domain/:name/records`
- `GET /domain/:name/records/text/:key`
- `GET /domain/:name/ownership-history`
- `GET /domain/:name/resolver-history`
- `GET /domain/:name/records/text/:key/history`
- `GET /lookup-hash/:hash`
- `GET /lookup-namehash/:hash`
- `GET /lookup-labelhash/:hash`
- `GET /address/:address/domains`
- `GET /address/:address/domain-count`
- `GET /address/:address/primary-name`
- `POST /address/primary-names/bulk`
- `GET /address/:address/summary`
- `GET /stats`
- `GET /pending-stats`
- `GET /ens-stats`
- `GET /ens-stats/registrations`
- `GET /ens-stats/distribution`

## Full Documentation

- [Complete API reference (markdown)](https://docs.enswhois.com/llms-full.txt)
- [Interactive API docs](https://docs.enswhois.com/api)
- [How the indexer works](https://docs.enswhois.com/indexer/how-it-works)