Edit this page

Get Reverse Record for Multiple Addresses

Copy
Copied
https://resolve.unstoppabledomains.com/reverse/query

This endpoint will return the reverse record of multiple wallet addresses in a single response.

Request Method

  • POST

Authentication

  • Bearer Token

Request Body

The request body contains information about your query and must be in JSON format for the API. Here’s the structure:

Copy
Copied
{
    "addresses": [
        "0x..." // wallet addresses to query for reverse records
    ]
}
info

The addresses field can accept a maximum of 1000 wallet addresses per request to query for reverse resolution records.

Returns

An object with a data field that contains a list of reverse resolution records:

  • data : (array) An array with the metadata of domains that reverses to the provided wallet addresses.
    • meta : A key-value dictionary with general information about the domain.
      • domain : (string) Name of the domain.
      • tokenId : (string) The unique identifier of the domain used by smart contracts.
      • namehash : (string) The hexadecimal representation of the domain's token ID .
      • owner : (string) The wallet address that owns the domain.
      • reverse : (boolean) A boolean indicating if the domain has a reverse record.
info

If a wallet addresses does not have a reverse record, it will not be returned by the Resolution Service.

Example

Here is an example request to query for the reverse record for following wallet addresses:

  • 0x88bc9b6c56743a38223335fac05825d9355e9f83
  • 0x3EAA674612f79A97ad451fCF860A51Ad41aC2C19
RequestResponse
Copy
Copied
curl --location --request POST 'https://resolve.unstoppabledomains.com/reverse/query' \
--header 'Authorization: Bearer {SECRET_API_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "addresses": [
        "0x88bc9b6c56743a38223335fac05825d9355e9f83",
        "0x3EAA674612f79A97ad451fCF860A51Ad41aC2C19"
    ]
}'
Copy
Copied
{
    "data": [
        {
            "meta": {
                "domain": "lordghostx.wallet",
                "tokenId": "80857839086949982994991786364369016617620430153731374656890181041655083653945",
                "namehash": "0xb2c3ea44b9e0d14f5c6c783bb59cf15a476279dff6fdb7d17d17ea2b6e775b39",
                "owner": "0x3eaa674612f79a97ad451fcf860a51ad41ac2c19",
                "reverse": true
            }
        },
        {
            "meta": {
                "domain": "jim-unstoppable.x",
                "tokenId": "79577619103421681308616456791817211704484961220433918391016311189913909952757",
                "namehash": "0xafef56165acf49408e6280cf683899f6e31402793e9eba29cbc985422ee980f5",
                "owner": "0x88bc9b6c56743a38223335fac05825d9355e9f83",
                "reverse": true
            }
        }
    ]
}

Asking For Help

If you are experiencing difficulties using our services, please know that we are here to help. You can join our Discord Community for real-time support from UD and the community, where you can receive assistance with integrating your app