API Documentation

🚧

Full API Coming Soon

The TDLNoot developer API is currently in development. The resolution API below is available now. Registration and management APIs will be available in Q3 2026.

Interested in early access? Email support@tdlnoot.com

Base URL

https://tdlnoot.com/api/v1

All API requests should be made over HTTPS. HTTP requests will be redirected.

Domain Resolution

GET /resolve/{name}

Resolve a Handshake domain name to its DNS records. Returns wallet addresses, IP records, and other on-chain data.

Parameter	Type	Description
name	string	The full domain name to resolve (e.g. alice.noot)

Example Request

GET https://tdlnoot.com/api/v1/resolve/alice.noot

Example Response

{
  "name": "alice.noot",
  "tld": "noot",
  "status": "active",
  "records": {
    "A": "192.168.1.1",
    "wallet": {
      "HNS": "hs1qxyz...",
      "BTC": "bc1qxyz..."
    }
  },
  "synced": true
}

GET /check/{tld}

Check if a TLD is available for registration on the Handshake blockchain.

Parameter	Type	Description
tld	string	The TLD to check (without dot, e.g. noot)

Example Request

GET https://tdlnoot.com/api/v1/check/noot

Example Response

{
  "tld": "noot",
  "available": true,
  "state": "AVAILABLE",
  "price_usd": 79.00,
  "register_url": "https://tdlnoot.com/register.php?tld=noot"
}

Coming Soon

The following endpoints are planned for the full API release:

POST /register GET /domains GET /tlds POST /dns/update GET /royalties POST /transfer GET /orders POST /webhook

Rate Limits

Currently the resolution API is rate limited to 100 requests per minute per IP address. API keys with higher limits will be available when the full API launches. Contact support@tdlnoot.com for early access.

Want Early API Access?

Get notified when the full developer API launches.

Request Early Access →