Get records for owner addresses

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.0xF5FFF32CF83A1A614e15F25Ce55B0c0A6b5F8F2c
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!

Get records for a domain

Get domain transfer events

Last modified 22d ago

Copy link

Contents