Query Examples

sidebar_position: 3 title: Sample Queries

---

Querying

Below are some sample queries you can use to gather information from the Domains 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: "0xa508c16666c5b8981fa46eb32784fccc01942a71") {
    registrations(first: 1, orderBy: expiryDate, orderDirection: desc) {
      domain {
        name
      }
    }
    id
  }
}

Returns

{
  "data": {
    "account": {
      "registrations": [
        {
          "domain": {
            "name": "datanexus.tomi"
          }
        }
      ],
      "id": "0xa508c16666c5b8981fa46eb32784fccc01942a71"
    }
  }
}

Search for subdomain

query getSubDomains($Account: String = "messari.tomi") {
  domains(where: { name: "messari.tomi" }) {
    name
    id
    subdomains(first: 10) {
      name
    }
    subdomainCount
  }
}

Returns

{
  "data": {
    "domains": [
      {
        "name": "messari.tomi",
        "id": "0x498ada62251a1227664ace8d97b0de2dcc6652ddf61e6fb5d3150f43ccf599e6",
        "subdomains": [
          {
            "name": "subgraphs.messari.tomi"
          },
          {
            "name": "bd.messari.tomi"
          }
        ],
        "subdomainCount": 2
      }
    ]
  }
}

Get an expiration for an Domains domain

query getDomainExp($Account: String = "paulieb.tomi") {
  registrations(
    where: { domain_: { name: $Account } }
    first: 1
    orderBy: expiryDate
    orderDirection: desc
  ) {
    expiryDate
  }
}

Returns

{
  "data": {
    "registrations": [
      {
        "expiryDate": "1714752524"
      }
    ]
  }
}