Example ENS Data Requests

Explore our collection of example ENSNode GraphQL queries.

Categories

Showing all 32 examples

Domain

Get Latest Domains

Retrieves the most recently created domains in descending order by creation time.

Open in ENSAdmin
Registrar

Get Latest Registrations

Retrieves the most recent domain registrations ordered by registration date in descending order. Shows registration details including expiry dates and ownership information for newly registered domains.

Open in ENSAdmin
Domain

Get Domains with Pagination

Fetches domains with pagination support, ordered by creation time in ascending order. Use this when you need to iterate through all domains systematically or implement pagination in your application.

Open in ENSAdmin
Domain

Get All Domains with Pagination by Creation Time

Retrieves domains in batches for pagination, ordered by creation time in ascending order. Excludes reverse records and null names. Use the lastCreatedAt parameter to paginate through all domains by passing the createdAt timestamp of the last domain from the previous batch.

Open in ENSAdmin
Domain

Get Domain by Namehash

Retrieves a specific domain using its namehash (the unique identifier for ENS names). The namehash is the cryptographic hash of the domain name.

Open in ENSAdmin
Domain

Get Domain by Name

Looks up a domain by its human-readable name (e.g., 'ens.eth'). This is user-friendly for ad-hoc queries, but not recommended for programmatic access because names are not stable identifiers. Use the 'Get Domain by Namehash' query for reliable lookups.

Open in ENSAdmin
Domain

Get Domains by the childmost-label substring

Searches for domains containing a specific substring in their label (the leftmost part of the domain name). For example, searching for 'ens' would find 'ens.eth', 'myens.eth', etc. Useful for finding related domains or performing fuzzy searches.

Open in ENSAdmin
Label

Get Label by Labelhash

Reverse lookup to find the human-readable label from its labelhash. This is useful when you have a labelhash and need to determine what the actual text label is.

Open in ENSAdmin
Domain

Get Complete Domain History

Retrieves the complete historical timeline of events for a domain, including ownership transfers, resolver changes, registrations, renewals, and all resolver record updates. This provides an audit trail of activities related to the domain.

Open in ENSAdmin
Domain

Get Domain Events Only

Retrieves only the domain-level events (transfers, ownership changes, wrapping events) without registration or resolver events. Use this when you're specifically interested in domain ownership and management events.

Open in ENSAdmin
Resolver

Get Resolver Events Only

Retrieves only the resolver-related events (address changes, text record updates, contenthash changes) for a domain. Useful when you're tracking how a domain's records have been updated over time.

Open in ENSAdmin
Account

Get Domains for Address (owner, registrant, wrappedOwner, or resolvedAddress)

Finds all domains associated with an Ethereum address in any capacity - as owner, registrant, wrapped owner, or as the resolved address. Excludes reverse records and expired domains. This is a comprehensive way to find domains connected to an address.

Open in ENSAdmin
Account

Get Owned In Registry Domains Only

Retrieves domains where the specified address is the owner in the ENS registry (not registrant or wrapped owner). This shows domains where the address has direct control over the ENS records but may not be the original registrant.

Open in ENSAdmin
Account

Get Registered Domains Only

Retrieves domains where the specified address is the original registrant (the one who initially registered the .eth domain). This shows domains the address actually purchased and registered, not just ones they received or control.

Open in ENSAdmin
Account

Get Names Including Expired

Retrieves all domains associated with an address (as owner, registrant, or wrapped owner) including those that have expired. Useful for historical analysis or when you need to see the domain portfolio of an address.

Open in ENSAdmin
Registrar

Get Registrant by Labelhash

Looks up registration information using a labelhash. This is primarily used for .eth domains and provides details about who registered the domain, when it was registered, when it expires, and what it cost. Note: This mainly works with .eth domains.

Open in ENSAdmin
Domain

Get Subdomains

Retrieves all subdomains under a given parent domain, filtering out expired domains and empty records. This is useful for exploring the subdomain hierarchy and finding active subdomains under a particular domain.

Open in ENSAdmin
Domain

Search Subdomains by Label

Searches for subdomains under a parent domain that contain a specific text string in their label. This enables fuzzy searching within a domain's subdomain space, useful for finding related or similarly named subdomains.

Open in ENSAdmin
Domain

Get Subdomains Including Expired

Retrieves all subdomains under a parent domain, including those that have expired. This provides a complete historical view of all subdomains that have ever existed under the parent domain.

Open in ENSAdmin
Registrar

Get Latest Subdomains

Retrieves the most recently created subdomains under a parent domain, ordered by creation time. This is useful for monitoring new subdomain activity and tracking the growth of a domain's subdomain ecosystem.

Open in ENSAdmin
Resolver

Get Domain Records (Inherited Resolver)

Retrieves a domain's resolver information including the types of records it supports (text records and coin types). This uses the domain's current resolver and shows what kind of records are available for the domain.

Open in ENSAdmin
Resolver

Get Domain Records (Custom Resolver)

Retrieves domain information along with records from a specific resolver address.

Open in ENSAdmin
Resolver

Get Resolver Details by Address

Retrieves detailed information about a resolver by its contract address. This shows the domains using this resolver and what types of records it supports.

Open in ENSAdmin
Resolver

Get Domain Text Records

Retrieves the current text record keys for a domain and all resolver events history. The 'texts' field shows currently set text record keys, while 'events' shows all resolver events including TextChanged, ContenthashChanged, AddrChanged, and MulticoinAddrChanged.

Open in ENSAdmin
Resolver

Get Historical Resolver Records Evolution

Provides a comprehensive view of how a domain's resolver records have evolved over time. This tracks resolver changes and the history of text records, address records, and contenthash changes across all resolvers the domain has used.

Open in ENSAdmin
Meta

Get Indexer Metadata

Retrieves metadata information about the indexer including indexing status and current block number. Use this to check if the indexer has indexing errors and to monitor synchronization with the blockchain.

Open in ENSAdmin
Resolver

Check if Resolver Exists

Checks if a specific resolver exists by its ID. The resolver ID is constructed as 'resolverAddress-namehash' where resolverAddress is the contract address and namehash is the domain's namehash. Used to verify resolver existence before operations.

Open in ENSAdmin
Registrar

Get Registration Data by Labelhash

Retrieves registration information for a domain using its labelhash (hash of the label without the TLD). Returns the registration date and the most recent registration transaction ID. Primarily used for .eth domains.

Open in ENSAdmin
Domain

Get Domain with Resolver Address

Retrieves domain information including resolver address and text records. Unlike other domain queries, this specifically includes the resolver's address field along with standard domain information.

Open in ENSAdmin
Domain

Get .eth Domain by Labelhash

Retrieves .eth domains by their labelhash under the .eth parent domain. This is specifically for finding .eth domains using their labelhash identifier.

Open in ENSAdmin
Registrar

Get Registration by Token ID

Retrieves registration information by token ID (labelhash), including label name, registration date, and expiry date. Ordered by registration date in descending order.

Open in ENSAdmin
Domain

Get Wrapped Domain

Retrieves wrapped domain information including owner, fuses, expiry date, and domain name. Used for ENS domains that have been wrapped using the Name Wrapper contract.

Open in ENSAdmin

Founded in 2022, Namehash Labs is a technology organization dedicated to infrastructure-level solutions that helps the Ethereum Name Service (ENS) Protocol grow.

© NameHash Labs. All Rights Reserved

Made with❤️byNameHash Labs