Query Examples

Search…

Query Examples

sidebar_position: 3 title: Sample Queries
​
Querying
Below are some sample queries you can use to gather information from the ENS contracts.
You can build your own queries using a GraphQL Explorer and enter your endpoint to limit the data to exactly what you need.
Get the top domain for an account based on the longest registry.
query getDomainForAccount {
  account(id: "0xfee51ebbf276c1c3d91910a0b9a029e3ce731619") {
    registrations(first: 1, orderBy: expiryDate, orderDirection: desc) {
      domain {
        name
      }
    }
    id
  }
}
Search for subdomain
query getSubDomains($Account: String = "vitalik.eth") {
  domains(where: { name: "vitalik.eth" }) {
    name
    id
    subdomains(first: 10) {
      name
    }
    subdomainCount
  }
}
Get an expiration for an ENS domain
{
 query getDomainExp($Account: String = "vitalik.eth") {
  registrations(
    where: {domain_: {name: $Account}}
    first: 1
    orderBy: expiryDate
    orderDirection: desc
  ) {
    expiryDate
  }
}

Entities

Next - Contract Developer Guide

Resolving Names On-chain

Last modified 1mo ago

Copy link

Edit on GitHub

On this page

Querying

Get the top domain for an account based on the longest registry.

Search for subdomain

Get an expiration for an ENS domain