Edit this page

Resolution Service API

The Resolution Service provides an API for getting domain data and metadata regardless of the blockchain in which the domain is stored. 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.

Supported Domains Endings

The Resolution Service API supports decentralized domains across two main zones:

Name Service Supported Domains
Zilliqa Name Service (ZNS) .zil
Unstoppable Name Service (UNS) .crypto, .nft, .blockchain, .bitcoin, .coin, .wallet, .888, .dao, .x

Unstoppable Domains periodically releases new domain endings, and our Resolution libraries and APIs will automatically detect and support any new domain endings. It is imperative for future proofing your resolution integration to allow all domain inputs to pass through rather than implementing a front end filter (e.g. avoid hard coding domains or placing a regex filter for just .crypto, .nft, etc.).

Getting Started With Alchemy

Generating an API Key

Before being able to make any requests to the API, you must create an API key via the Alchemy dashboard.

Making Requests to the API

All requests made to the Resolution Service API must contain the following headers:

Header Name Description
API KEY The Alchemy API key as a string

Quickstart Guide

Here’s a guide on setting up your Alchemy account and querying the Unstoppable Domains Resolution Service API.

API Endpoints Overview

Endpoint Short Description Documentation
Get records for a domain returns all the records attached to a domain name. Get Domain Records Docs
Get records for owner addresses returns all the domain names, records, and metadata owned by a wallet address or configured to a resolution record. Get Records for Owner Docs
Get domain transfer events returns the transfer history of a domain name. Get Domain Transfers Docs

Asking For Help

Having troubles using our services? We’re here to help. Join our Discord Community for real-time support from UD and the community if you need assistance integrating your app.