llms.txt Content
# 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
## Pricing
`price` in check/price responses is per-year retail (USDC). Total = `price × period`.
Some TLDs require multi-year registration; `min_period` in responses indicates the minimum (e.g. 2 for .ai). POST /:domain defaults `period` to `min_period` and rejects lower values with 400.
## Example: Register a domain
Two-step x402 flow. First call returns 402 + payment details; sign the EIP-3009 authorization with your wallet, base64-encode the x402 payload, then retry with the PAYMENT-SIGNATURE header.
curl -X POST https://agentdomainsearch.com/example.com \
-H "Content-Type: application/json" \
-H "PAYMENT-SIGNATURE: <base64(JSON.stringify({x402Version:2,scheme:"exact",network:"base",payload:{signature,authorization:{from,to,value,validAfter,validBefore,nonce}}}))>" \
-d '{
"contacts": {
"first_name": "Ada",
"last_name": "Lovelace",
"org_name": "Analytical Engines Ltd",
"email": "ada@example.com",
"phone": "+1.5555551234",
"address1": "123 Main St",
"city": "London",
"state
OpenAPI Spec (preview)
{"openapi":"3.0.3","info":{"title":"Agent Domain Search","description":"Agent-first domain registration and DNS management. Pay with USDC on Base via x402.","version":"1.0.0","contact":{"email":"support@agentdomainsearch.com"}},"servers":[{"url":"https://agentdomainsearch.com"}],"x-payment-required":true,"x-payment-info":{"protocol":"x402","currency":"USDC","network":"base","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","manifest":"https://agentdomainsearch.com/.well-known/x402.js