Get records for owner addresses
GET /domains
GET https://unstoppabledomains.g.alchemy.com/domains/?owners=<OWNER 1 ADDRESS>&owners=<OWNER 2 ADDRESS>
Request domain name records and metadata given multiple owner addresses. Returns domains and their records associated with each address.

URL Params

  • none

Query Params

  • owners - a list of wallet addresses to query for domains information. Note that if your request must include multiple addresses, and you need to use a new query param instance for each address.
  • tlds - optional parameter to filter domains by TLDs. Currently supported:
    • .zil
    • .crypto
    • .nft
    • .blockchain
    • .bitcoin
    • .coin
    • .wallet
    • .888
    • .dao
    • .x
  • sortBy - which field to use for sorting of the list
    • id - sort by domain id
    • name - sort by domain name according alphabetic ordering
  • sortDirection
    • ASC - ascending order
    • DESC - descending order
  • startingAfter - skip all elements before this value. Value depends on sortBy value. Use nextStartingAfter field from the response to get the next page of the list.

Returns

An object with a data field that contains a list of domain details along with some meta about the request.
  • data - contains a list of domain details. Details are the same as for GET domain response.
  • meta - contains list metadata
    • perPage - number of elements in the list in single response
    • nextStartingAfter - a value that can be passed in the startingAfter query parameter to get the next page of the domains list
    • sortBy - which field is used to sort domains list
    • sortDirection - order of applied sorted (ascending or descending)
    • hasMore - whether response has more domains to show in the next pages

Example

Here is an example request to query for the records and metadata for two owner addresses:
  1. 1.
    0xF5FFF32CF83A1A614e15F25Ce55B0c0A6b5F8F2c
  2. 2.
    0x8aad44321a86b170879d7a244c1e8d360c99dda8

Request

1
curl \
2
--request GET "https://unstoppabledomains.g.alchemy.com/domains/?owners=0xF5FFF32CF83A1A614e15F25Ce55B0c0A6b5F8F2c&sortBy=id&sortDirection=DESC&perPage=2&owners=0x8aad44321a86b170879d7a244c1e8d360c99dda8" \
3
--header 'Authorization: Bearer <YOUR API KEY>'
Copied!

Response

1
{
2
"data": [
3
{
4
"id": "porpoise.nft",
5
"attributes": {
6
"meta": {
7
"domain": "porpoise.nft",
8
"blockchain": "MATIC",
9
"networkId": 137,
10
"owner": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
11
"resolver": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f",
12
"registry": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f"
13
},
14
"records": {
15
"crypto.ETH.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
16
"social.picture.value": "1/erc1155:0xc7e5e9434f4a71e6db978bd65b4d61d3593e5f27/14317",
17
"crypto.MATIC.version.ERC20.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
18
"crypto.MATIC.version.MATIC.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8"
19
}
20
}
21
},
22
{
23
"id": "whereyoucantypeinadomain.crypto",
24
"attributes": {
25
"meta": {
26
"domain": "whereyoucantypeinadomain.crypto",
27
"blockchain": "MATIC",
28
"networkId": 137,
29
"owner": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
30
"resolver": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f",
31
"registry": "0xa9a6a3626993d487d2dbda3173cf58ca1a9d9e9f"
32
},
33
"records": {
34
"crypto.ETH.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
35
"crypto.MATIC.version.ERC20.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8",
36
"crypto.MATIC.version.MATIC.address": "0x8aad44321a86b170879d7a244c1e8d360c99dda8"
37
}
38
}
39
}
40
],
41
"meta": {
42
"perPage": 2,
43
"nextStartingAfter": "556766",
44
"sortBy": "id",
45
"sortDirection": "DESC",
46
"hasMore": true
47
}
48
}
Copied!
The response has more data that is not included in the first page, so the query for the next page would use the nextStartingAfter response value:
1
curl \
2
--request GET "https://unstoppabledomains.g.alchemy.com/domains/?owners=0xF5FFF32CF83A1A614e15F25Ce55B0c0A6b5F8F2c&sortBy=id&sortDirection=DESC&perPage=2&owners=0x8aad44321a86b170879d7a244c1e8d360c99dda8&startingAfter=556766" \
3
--header 'Authorization: Bearer <YOUR API KEY>'
Copied!
Last modified 22d ago