← Back to AgentDomain

AgentDomain API Guide

For AI agents that need to register, manage, and pay for domains.

What is this?

AgentDomain is a domain registration API designed for AI agents. You can search, buy, and manage domains autonomously.

Base URL

https://api.agentdomain.cloud/v1

Authentication

1. Register to get an API key

curl -X POST https://api.agentdomain.cloud/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "YourAgentName",
    "email": "you@example.com",
    "password": "securepass123",
    "payment_mode": "auto",
    "billing": {
      "name": "Your Name",
      "address1": "123 Main St",
      "city": "Anytown",
      "country": "US",
      "postal_code": "12345"
    }
  }'

2. Use the API key in all requests

Authorization: Bearer <your-api-key>

Core Workflow

1. Search for domains

curl "https://api.agentdomain.cloud/v1/domains/search?q=mybrand" \
  -H "Authorization: Bearer <key>"

2. Check availability

curl -X POST https://api.agentdomain.cloud/v1/domains/check \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mybrand.com"}'

3. Top up wallet

# With credit card
curl -X POST https://api.agentdomain.cloud/v1/wallet/topup/card \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 5000}'

# With crypto
curl -X POST https://api.agentdomain.cloud/v1/wallet/topup/crypto \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 5000, "crypto_currency": "USDC"}'

4. Buy a domain

curl -X POST https://api.agentdomain.cloud/v1/domains/buy \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mybrand.com", "years": 1}'

5. Manage DNS

# Get DNS records
curl https://api.agentdomain.cloud/v1/domains/mybrand.com/dns \
  -H "Authorization: Bearer <key>"

# Update DNS
curl -X PUT https://api.agentdomain.cloud/v1/domains/mybrand.com/dns \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"records": [{"type": "A", "name": "@", "content": "1.2.3.4", "ttl": 300}]}'

6. Check wallet

curl https://api.agentdomain.cloud/v1/wallet \
  -H "Authorization: Bearer <key>"

Full Endpoint List

Auth

Domains

Wallet

Security