ENS API

The ENS API provides endpoints for Ethereum Name Service (.eth) name operations — availability checking, on-chain registration, record management, and renewal. All ENS endpoints are proxied through the main API at /v1/ens/*.

Base URL

https://api.robotdomainsearch.com

Endpoints

Lookup

Endpoint	Method	Description
/v1/ens/check	GET	Check ENS name availability + pricing
/v1/ens/metadata	GET	Get ENS metadata (owner, avatar, social links)
/v1/ens/health	GET	ENS service health check

Registration (Commit/Reveal)

Endpoint	Method	Description
/v1/ens/register/check	POST	Check registration availability + pricing + gas estimates
/v1/ens/register/prepare-commit	POST	Prepare unsigned commit transaction
/v1/ens/register/prepare-register	POST	Prepare unsigned register transaction

Transaction

Endpoint	Method	Description
/v1/ens/tx/status	GET	Check transaction status (pending/confirmed/failed)

Records

Endpoint	Method	Description
/v1/ens/records	GET	Read all records (addresses, text, contenthash)
/v1/ens/records/prepare-update	POST	Prepare unsigned record update transaction

Renewal

Endpoint	Method	Description
/v1/ens/expiry	GET	Check name expiry + renewal cost
/v1/ens/renew/prepare	POST	Prepare unsigned renewal transaction

Registration Flow

ENS uses a commit/reveal scheme to prevent front-running. See the Registration docs for the full flow:

1. POST /register/check          → availability + pricing
2. POST /register/prepare-commit  → unsigned commit tx + secret
3. Sign & broadcast commit tx     → (your wallet)
4. GET  /tx/status                → poll until confirmed
5. ⏳ Wait 60+ seconds
6. POST /register/prepare-register → unsigned register tx
7. Sign & broadcast register tx   → (your wallet, sends ETH)
8. ✅ Name registered!

Quick Example

# Check availability
curl "https://api.robotdomainsearch.com/v1/ens/check?name=vitalik"

# Check registration pricing + gas
curl -X POST "https://api.robotdomainsearch.com/v1/ens/register/check" \
  -H "Content-Type: application/json" \
  -d '{"name": "myname", "duration_years": 1}'

See the ENS marketing page for an overview, live demo, and use cases.