Domains

API-first domain registrar for AI agents. Register domains, manage DNS — all programmatically with Ed25519 auth.

agentdomains.dev →API Docs →OpenAPI Spec →llms.txt →

Quick Start

1. Authenticate

# Generate an Ed25519 keypair
ssh-keygen -t ed25519 -f agent_key -N ""

# Request a challenge
curl -X POST https://auth.gentik.io/challenge \
  -H "Content-Type: application/json" \
  -d '{"publicKey": "'"$(cat agent_key.pub)"'"}'

# Sign the challenge
echo -n "<challenge>" | ssh-keygen -Y sign -f agent_key -n gentik

# Verify and receive API key
curl -X POST https://auth.gentik.io/verify \
  -H "Content-Type: application/json" \
  -d '{"challengeId": "...", "signature": "-----BEGIN SSH SIGNATURE-----..."}'

2. Register a domain

curl -X POST https://agentdomains.dev/api/domains/register \
  -H "Authorization: Bearer gtk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myagent.dev",
    "years": 1,
    "registrant": {
      "firstName": "...", "lastName": "...",
      "address1": "...", "city": "...",
      "stateProvince": "...", "postalCode": "...",
      "country": "US", "phone": "+1.5551234567",
      "email": "owner@example.com"
    }
  }'

# Response includes a relay channel for real-time updates:
# "channel": { "id": "invoice:clx...", "relay": "...",
#   "endpoints": { "poll": "/channels/...", "ws": "/channels/.../ws" } }

Key Endpoints

Method	Endpoint	Description
POST	/api/auth/challenge	Get signing challenge
POST	/api/auth/verify	Verify signature, get API key
GET	/api/domains/check?domain=x	Check availability + pricing
POST	/api/domains/register	Register domain (returns payment URL)
GET	/api/domains/{domain}	Domain details (status, expiry, DNS config)
GET	/api/domains/{domain}/dns	Manage DNS records
GET	/api/account	Account info + domains

Features

Domain Registration

DNS Management

Full DNS control — A, AAAA, CNAME, MX, TXT, NS, SRV, CAA records via Cloudflare.

Human-in-the-Loop Payments

Agent requests registration, human approves payment via Stripe. Automatic fulfillment after payment.

Real-Time Updates

Registration responses include a Relay channel for tracking payment and registration status via WebSocket or polling.

Pricing

Wholesale cost + tiered markup based on TLD wholesale price
Multi-year discount: 50% off markup for years 2+
Markup scales with wholesale cost — budget TLDs ($3), standard TLDs ($8), premium TLDs ($10–$19)
Payments via Stripe (credit/debit cards)