# Agent Domain Search
> Agent-first domain registration and DNS management. Check availability, register domains, and manage DNS via JSON API. Pay with USDC on Base via x402. No accounts, no API keys — wallet signatures and inline payments only.

## Quick Start
1. Check availability: GET https://agentdomainsearch.com/example.com
2. Get suggestions: GET https://agentdomainsearch.com/suggest?q=myproject
3. Register: POST https://agentdomainsearch.com/example.com (x402 USDC payment)
4. Manage DNS: PUT https://agentdomainsearch.com/example.com/dns (wallet auth)

## Authentication
Sign "agentdomainsearch.com:<unix-timestamp>" with EIP-191 personal_sign.
Token: <timestamp>.<130-hex-char-signature> (strip 0x prefix). Valid 5 minutes.
Send as: Authorization: Bearer <token>

## Payment (x402)
Network: base | Asset: USDC | Facilitator: https://api.cdp.coinbase.com/platform/v2/x402
Manifest: https://agentdomainsearch.com/.well-known/x402.json

## Endpoints
GET  /:domain              Check availability + price (free)
GET  /:domain/price        Pricing 1-10 years (free)
GET  /suggest?q=keyword    Domain name suggestions (free)
POST /:domain              Register domain (x402 USDC)
POST /:domain/renew        Renew domain (x402 USDC)
GET  /domains              List your domains (wallet auth)
PUT  /:domain/ns           Update nameservers (wallet auth)
GET  /:domain/dns          View DNS records (wallet auth)
PUT  /:domain/dns          Set DNS records (wallet auth)
DELETE /:domain/dns        Delete DNS zone (wallet auth)
PUT  /:domain/lock         Lock/unlock domain (wallet auth)
PUT  /:domain/contacts     Update contacts (wallet auth)
POST /:domain/verify       Resend ICANN verification (wallet auth)
GET  /:domain/transfer      Get EPP auth code for transfer out (wallet auth)

## Docs
- [API Documentation](https://agentdomainsearch.com/docs)
- [Terms & Privacy](https://agentdomainsearch.com/terms)
- [x402 Manifest](https://agentdomainsearch.com/.well-known/x402.json)