Skip to content
Resolution/
/
Get reverses

Resolution Service (1.0.0)

The Resolution Service provides APIs for resolving domain metadata and records from multiple blockchain and naming services. The service currently supports the following naming services:

  • Unstoppable Domain's UNS and CNS with TLDs: .x, .polygon, .nft, .crypto, .blockchain, .bitcoin, .dao, .888, .wallet, .binanceus, .hi, .klever, .kresus, .anime, .manga, .go, .zil

  • Ethereum Naming Service - ENS with TLDs: .eth



The service caches blockchain events in a database for easy retrieval without accessing any blockchain APIs. With the Resolution Service API, you can quickly build applications directly communicating with the blockchain to get UD domain data with a single API request.
Overview
Unstoppable Domains (Partner Engineering)
partnerengineering@unstoppabledomains.com
Languages
Servers
Production
https://api.unstoppabledomains.com/resolve/
Sandbox
https://api.ud-sandbox.com/resolve/

Domains

Operations

Reverse

Operations

Get reverse

Request

Get Reverse Record for an Address
Note: The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.

Security
apiKeyAuth
Path
addressstring[^\/#\?]+?required

A wallet address to query for reverse record

curl -i -X GET \
  'https://api.unstoppabledomains.com/resolve/reverse/{address}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json
dataArray of objects(DomainResponse)
Response
application/json
{
  "data": [
    { … }
  ]
}

Get reverses

Request

Get Records for Multiple Domains

The API only supports Unstoppable Domains' naming services for backward compatibility. A new API version is coming soon for other naming services

  • Unstoppable Domain's UNS and CNS with TLDs: .x, .polygon, .nft, .crypto, .blockchain, .bitcoin, .dao, .888, .wallet, .binanceus, .hi, .klever, .kresus, .anime, .manga, .go, .zil

  • Unstoppable Domain's Zilliqa with TLDs: zil


**Note:** The API should be used in a backend system. If you need the data in client apps, please build a proxy backend to hide the API key.
Security
apiKeyAuth
Query
resolutionobject

See this list for all the resolution keys supported

ownersobject

Wallet addresses of the owners of domains

tldsobject

Domain ending supported such as crypto, x, or polygon. See supported tlds for the full list

sortBystring

Sort key to specify how the returned domain list is sorted

sortDirectionstring

Sort order of the returned domain list

startingAfterstring

Query offset to skip a number of record, example: 100

perPagenumber

Number of domains returned in the list, example: 50

Bodyapplication/json

BulkReverseQueryParams

addressesArray of strings[ 1 .. 1000 ] itemsuniquerequired
curl -i -X POST \
  'https://api.unstoppabledomains.com/resolve/reverse/query?data=string%2Cstring%2Cx&sortBy=string&sortDirection=string&startingAfter=string&perPage=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses": [
      "string"
    ]
  }'

Responses

Bodyapplication/json
dataArray of objects(DomainResponse)required
data[].​metaobject(DomainMetadata)required
data[].​meta.​resolverstring
data[].​meta.​blockchainstring
data[].​meta.​networkIdnumber
Enum15137133780001
data[].​meta.​registrystring
data[].​meta.​typestringrequired
Enum"Uns""Zilliqa""Ens"
data[].​meta.​customMetaobject
data[].​meta.​domainstringrequired
data[].​meta.​namehashstring
data[].​meta.​tokenIdstring
data[].​meta.​ownerstring
data[].​meta.​reversebooleanrequired
data[].​recordsobjectrequired
metaobject
Response
application/json
{
  "data": [
    { … }
  ],
  "meta": {}
}

Rpc Proxy

Operations

Status

Operations

Owner

Operations