Skip to content
Registry/
/
Check domain name availab...

Registry API v1 (2.0.0)

The Registry API v1 allows to purchase domains on-chain. No authorization required.

Overview
Unstoppable Domains (Partner Engineering)
partnerengineering@unstoppabledomains.com
Languages
Servers
Production Server
https://api.unstoppabledomains.com/registry/v1/

domains

Check domain availability and request on-chain purchase data

Operations

Check domain name availability

Request

Check domain name availability

Path
domainNamestringrequired
Example: beresnev.crypto
curl -i -X GET \
  https://api.unstoppabledomains.com/registry/v1/domains/beresnev.crypto

Responses

Successful

Bodyapplication/json
domainstring

Domain name

availabilityobject(Availability)
Response
application/json
{
  "domain": "string",
  "availability": {
    "status": "AVAILABLE",
    "price": { … }
  }
}

Request on-chain purchase parameters

Request

Request on-chain purchase parameters. There parameters contain all necessary data to make a purchase on-chain. It includes tx parameters with signatue. Parameters are valid for 4 hours.

Path
domainNamestringrequired
Example: beresnev.crypto
Bodyapplication/jsonrequired
ownerobject(DomainOwner)required
owner.​addressstringrequired

Ethereum address

Example: "0x1234567890123456789012345678901234567890"
recordsobject(DomainRecords)required

Domain crypto records

Example: {"crypto.ETH.address":"0x6EC0DEeD30605Bcd19342f3c30201DB263291589","crypto.BTC.address":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"}
Domain records reference
records.​property name*stringadditional property
currencystringrequired

Purchase cryptocurrency

Value"MATIC"
Example: "MATIC"
curl -i -X POST \
  https://api.unstoppabledomains.com/registry/v1/domains/beresnev.crypto/parameters/purchase \
  -H 'Content-Type: application/json' \
  -d '{
    "owner": {
      "address": "0x1234567890123456789012345678901234567890"
    },
    "records": {
      "crypto.ETH.address": "0x6EC0DEeD30605Bcd19342f3c30201DB263291589",
      "crypto.BTC.address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
    },
    "currency": "MATIC"
  }'

Responses

Valid

Bodyapplication/json
domainstring

Domain name

availabilityobject(Availability)
txobject(DomainPurchaseParametersTx)
Response
application/json
{
  "domain": "string",
  "availability": {
    "status": "AVAILABLE",
    "price": { … }
  },
  "tx": {
    "chainId": 0,
    "function": "string",
    "arguments": { … },
    "params": { … }
  }
}