Domains API
Learn all the detailed references of Domains API that provide ENS domains onchain and offchain (cb.id & Namestone) information, including the input filters, supported chains, and output fields.
The Domain API fetches information on blockchain domains, which are user-friendly names linked to specific blockchain addresses. Example: ENS.
This API can also resolve a domain name into a wallet/contract address.
Inputs
filter
Name | Type | Description |
---|---|---|
|
| allows to filter out domains which are set/not set as primary |
|
| Domain name, e.g. "vitalik.eth" or a subdomain, e.g. "illionaire.illionaire.eth" |
|
| Identity: blockchain address, domain name, social identity |
|
| Blockchain address to which the domain resolves to |
blockchain
For Domains API, the blockchain
input will fetch all ENS either onchain (Ethereum) or offchain (Namestone & cb.id).
Enum | Description |
---|---|
| Ethereum mainnet |
order
Name | Description |
---|---|
| Sort the result by the ENS expiry timestamp, either in ascending ( |
| Sort the result by the creation block timestamp of the ENS domain, either in ascending ( |
| Sort the result by the last block timestamp of updates on the ENS domain, either in ascending ( |
Output
Name | Type | Description |
---|---|---|
avatar |
| Link to the ENS Avatar or NFT PFP |
|
| Blockchain, where the domain is located |
|
| Unique blockchain identifier |
|
| Block number when the domain was created |
|
| Timestamp when the domain was created |
|
| DApp name associated with the domain (e.g.,ENS) |
|
| DApp slug (contract version) associated with the domain |
|
| Timestamp when the domain registration expires; note - ENS has a 3-month grace period after the expiry timestamp |
|
| Registration cost for the domain |
|
| Registration cost in the native token |
|
| Registration cost in USDC |
|
| Airstack unique identifier for the domain |
isNameWrapped | Boolean | Indication if the ENS name is Wrapped (ERC1155) or not (ERC721). |
|
| Indicates if the domain is set to be primary |
|
| Airstack unique domain hash |
|
| Domain name wihtout the domain ending, eg. 'vitalik' instead of 'vitalik.eth' |
|
| Block number when the domain was last updated |
|
| Timestamp when the domain was last updated |
manager | Address! | Domain manager address |
managerDetails | Domain manager's details â domains, socials, etc. | |
|
| Domain name |
|
| Domain owner address |
| Domain owner's details â domains, socials, etc. | |
|
| Airstack unique hash to retrieve on-chain data to be used in filters |
| Nested query - can retrieve payment token data (name, symbol, etc.) | |
|
| Domain registration cost in blockchain native token |
|
| Domain registration cost in USDC |
|
| Registration cost for the domain |
|
| Registration cost in the native token |
|
| Registration cost in USDC as a string |
|
| Address to which the domain is resolved |
| Resolved address details â domains, socials, etc. | |
|
| Count of subdomains linked to the domain |
| Nested query - all subdomain-related data | |
texts | [DomainTexts!] | ENS domain additional onchain records set by the user, such as links, socials, etc. |
|
| Domain Token ID associated with the domain, if applicable |
| Nested query - NFT details of the ENS domain NFT | |
|
| Time-to-live value for the domain |
For ENS, the ENS domain name by default references the resolved address. In some rare cases, the owner and resolved addresses may differ (the owner set it to resolve to another wallet).
Last updated