ENS Indexer API

List all domains associated with an address.

Parameters

Name	Type	Description
address	string	Ethereum address (42-char hex)

Query Parameters

Name	Type	Description
sort_by	string	full_name (default) or expiry_timestamp
include_expired	boolean	Include expired domains beyond the 90-day grace period (premium + available). Default false. Names still in their grace period are always included.
address_type	string	effective_owner (default), registry_owner, registrar_owner, wrapper_owner, resolver

Example Response

{
  "address": "0xd8da6bf2...",
  "address_type": "effective_owner",
  "results": [
    {
      "name": "vitalik.eth",
      "label": "vitalik",
      "expiry_timestamp": "1754000000",
      "ownership": {
        "owner": "0xd8dA6BF2...",
        "registry": "0xd8dA6BF2...",
        "is_wrapped": false
      },
      "resolver": {
        "address": "0x231b0Ee1..."
      }
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 25
}

Lightweight count-only endpoint. Returns domain counts for an address by type. active_count covers names still recoverable by the owner (registered + 90-day grace); expired_count covers names past grace (premium + available).

Parameters

Name	Type	Description
address	string	Ethereum address (42-char hex)

Query Parameters

Name	Type	Description
address_type	string	effective_owner (default), registry_owner, registrar_owner, wrapper_owner, resolver

Example Response

{
  "address": "0xd8da6bf2...",
  "address_type": "effective_owner",
  "count": 42,
  "active_count": 40,
  "expired_count": 2
}

Reverse resolve an address to its primary ENS name. Optionally returns full history of reverse name changes.

Parameters

Name	Type	Description
address	string	Ethereum address (42-char hex)

Query Parameters

Name	Type	Description
history	boolean	Include full reverse name history (default false)

Example Response (default)

{
  "address": "0xd8da6bf2...",
  "primary_name": "vitalik.eth",
  "registrar": "addr.reverse"
}

Example Response (history=true)

{
  "address": "0xd8da6bf2...",
  "current": {
    "primary_name": "vitalik.eth",
    "registrar": "addr.reverse"
  },
  "history": [
    {
      "name": "vitalik.eth",
      "registrar": "addr.reverse",
      "block_number": 9412610,
      "transaction_hash": "0xabc..."
    }
  ]
}

Bulk reverse resolution for multiple addresses. Maximum 200 per request.

Request Body

{
  "addresses": ["0xd8da6bf2...", "0x225f137..."]
}

Example Response

{
  "results": {
    "0xd8da6bf2...": {
      "primary_name": "vitalik.eth",
      "registrar": "addr.reverse"
    },
    "0x225f137...": {
      "primary_name": null,
      "registrar": null
    }
  }
}

Combined address summary: active domain count (effective owner, includes grace), primary name, domains expiring soon, and previously-owned count.

Parameters

Name	Type	Description
address	string	Ethereum address (42-char hex)

Example Response

{
  "address": "0xd8da6bf2...",
  "domain_count": 42,
  "primary_name": "vitalik.eth",
  "primary_name_source": "addr.reverse",
  "domains_expiring_30d": 1,
  "previously_owned_count": 12
}

List domains the address used to control. A domain qualifies if the address ever appeared as to_address, new_owner_address, or owner_address on an event for that domain, and is no longer in control (current effective owner differs, or the name has lapsed past the 90-day grace period). Sorted by most-recently-touched first.

Parameters

Name	Type	Description
address	string	Ethereum address (42-char hex)

Query Parameters

Name	Type	Description
page	integer	Page number, 25 per page (default 1)
sort_dir	string	desc (default, most recent first) or asc

Example Response

{
  "address": "0xd8da6bf2...",
  "results": [
    {
      "name": "old-name.eth",
      "label": "old-name",
      "expiry_timestamp": "1700000000",
      "ownership": {
        "owner": "0xabc...",
        "is_wrapped": false
      },
      "last_owned_block_number": 19500000,
      "last_owned_block_timestamp": 1710000000
    }
  ],
  "total": 12,
  "page": 1,
  "page_size": 25
}