Get records for a domain
GET /domains/<name>
GET https://unstoppabledomains.g.alchemy.com/domains/<domain name>
The domains endpoint is the main endpoint to resolve Unstoppable domain name into records. All known records will be returned In a single response.
At the time of writing, the Resolution Service supports the following TLD’s:
  • .zil
  • .crypto
  • .nft
  • .blockchain
  • .bitcoin
  • .coin
  • .wallet
  • .888
  • .dao
  • .x

URL Params

  • domain name: This can be any domain name or TLD. To simplify communication resolution service will not return error in case of invalid domain or unsupported TLD.

Query Params

  • none

Returns

A single object with the following fields:
  • records: This field is a key-value dictionary with all domain records that were set on chain. This includes cryptocurrency addresses and IPFS website hashes. To get more details - visit the Unstoppable Domains records reference section: https://docs.unstoppabledomains.com/domain-registryessentials/records-reference
  • meta: This field is a key-value dictionary with general information about the domain:
    • domain: (string) Domain name
    • blockchain: (string) On what blockchain the domain is located. Blockchain names are coin types according to SLIP-0044
    • networkId: (number) Blockchain network ID
      • 1 - Ethereum or Zilliqa Mainnet
      • 137 - Polygon (Matic) Mainnet
      • 80001 - Polygon (matic) Mumbai Testnet
      • 4 - Ethereum Rinkeby Testnet
      • 5 - Ethereum Goerli Testnet
  • resolver - (string) resolver smart contract address. This contract is responsible for managing domain records.
  • registry - (string) registry smart contract address. Registry is the most essential smart contract in UNS. This is the contract that defines ownership rules, how domains are minted, provides ERC-721 token metadata, and stores a metadata-enriched list of all domains.

Example

Here is an example request to query for the records and metadata for the domain brad.crypto.

Request

1
curl \
2
--request GET 'https://unstoppabledomains.g.alchemy.com/domains/brad.crypto' \
3
--header 'Authorization: Bearer <YOUR API KEY>'
Copied!

Response

1
{
2
"records": {
3
"ipfs.html.value": "QmVHmG6BDRsDuzcFrWw6m5ByDnzcvfQbmdQF9bbSFTUeD1",
4
"crypto.ADA.address": "DdzFFzCqrhsuwQKiR3CdQ1FzuPAydtVCBFTRdy9FPKepAHEoXCee2qrio975M4cEbqYwZBsWJTNyrJ8NLJmAReSwAakQEHWBEd2HvSS7",
5
"crypto.BTC.address": "bc1q359khn0phg58xgezyqsuuaha28zkwx047c0c3y",
6
"crypto.ETH.address": "0x8aaD44321A86b170879d7A244c1e8d360c99DdA8",
7
"gundb.username.value": "0x8912623832e174f2eb1f59cc3b587444d619376ad5bf10070e937e0dc22b9ffb2e3ae059e6ebf729f87746b2f71e5d88ec99c1fb3c7c49b8617e2520d474c48e1c",
8
"social.picture.value": "1/erc1155:0xc7e5e9434f4a71e6db978bd65b4d61d3593e5f27/14317",
9
"gundb.public_key.value": "pqeBHabDQdCHhbdivgNEc74QO-x8CPGXq4PKWgfIzhY.7WJR5cZFuSyh1bFwx0GWzjmrim0T5Y6Bp0SSK0im3nI",
10
"ipfs.redirect_domain.value": "https://abbfe6z95qov3d40hf6j30g7auo7afhp.mypinata.cloud/ipfs/Qme54oEzRkgooJbCDr78vzKAWcv6DDEZqRhhDyDtzgrZP6"
11
},
12
"meta": {
13
"domain": "brad.crypto",
14
"blockchain": "ETH",
15
"networkId": 1,
16
"owner": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
17
"resolver": "0xb66dce2da6afaaa98f2013446dbcb0f4b0ab2842",
18
"registry": "0xd1e5b0ff1287aa9f9a268759062e4ab08b9dacbe"
19
}
20
}
Copied!
Last modified 24d ago