# StableDomains

> Agent-first domain registrar. Search, price and register domains and pay in USDC/USDT (Base, Ethereum, Arbitrum, Polygon, HyperEVM, BNB Chain, Solana) — or gasless via x402 on Base. Free WHOIS privacy. Also: a daily feed of expiring / just-dropped domains that still have real backlinks.

## Start here
- [MCP server](https://stabledomains.net/api/mcp): streamable HTTP JSON-RPC. Tools: search_domains, quote_domain, create_order, pay_order, check_order, find_dropping_domains, buy_with_balance, get_balance, topup_balance, list_domains, suggest_domains, estimate_domain_value, whois_lookup, dns_email_check, is_domain_dropping
- [OpenAPI 3.1](https://stabledomains.net/api/openapi.json)
- [Docs for agents](https://stabledomains.net/docs)
- [Expiring domains](https://stabledomains.net/expiring): pending-delete and just-dropped names with backlinks, Wayback history and a brandability score
- [Drops API (free)](https://stabledomains.net/api/v1/drops): top 25, filter by tld, status, q, min_len, max_len, min_backlinks, min_age, min_brand, max_price, no_hyphen, no_digits, include_spam (spam hidden by default), sort
- [Drops API (full, x402 $0.01)](https://stabledomains.net/api/v1/drops/full): up to 500 rows with all metrics
- [Name generator API (free)](https://stabledomains.net/api/v1/suggest): POST {"idea","tlds"?,"max_price"?} -> available names with price, checkout_url and create_order body (top 10). Bulk (90 checks, 50 results): GET https://stabledomains.net/api/v1/suggest/bulk?idea=… x402 $0.02
- [Domain value estimate](https://stabledomains.net/api/v1/tools/value?domain=example.com): free JSON; page https://stabledomains.net/tools/domain-value
- [WHOIS/RDAP lookup](https://stabledomains.net/api/v1/tools/whois?domain=example.com): free JSON; page https://stabledomains.net/tools/whois
- [DNS + SPF/DKIM/DMARC checker](https://stabledomains.net/api/v1/tools/dns?domain=example.com): free JSON; page https://stabledomains.net/tools/dns-checker
- [Is it dropping?](https://stabledomains.net/api/v1/tools/dropping?domain=example.com): lifecycle + drop date; page https://stabledomains.net/tools/is-it-dropping
- [Drop alerts](https://stabledomains.net/api/v1/watch): POST {domain, webhook_url?, email?} → webhook events domain.status_changed / domain.available (MCP tool watch_domain)
- [Per-domain drop pages](https://stabledomains.net/expiring/example.com): status, backlinks, archive history, buy link
- [Domain name ideas by niche](https://stabledomains.net/ideas): available names for ~200 niches
- [All free tools](https://stabledomains.net/tools)

## Manage domains you own (auth: Bearer API key; MCP tool names in brackets)
- DNS: GET/PUT /api/v1/domains/{domain}/dns {records:[{type:A|AAAA|CNAME|MX|TXT,name,value,ttl?,priority?}], nameservers?} — PUT replaces the full set [get_dns, set_dns]
- Renew: POST /api/v1/domains/{domain}/renew {years, pay_with?:"balance"} → 402 USDC or instant from balance [renew_domain]
- Auto-renew: PATCH /api/v1/domains/{domain} {auto_renew:true} — renews from prepaid balance 7 days before expiry [set_auto_renew]
- Expiry reminders: email at 30/7/1 days + optional account webhook PUT /api/v1/account/notifications {webhook_url} → events domain.expiring, domain.renewed, domain.transfer_completed [set_notification_webhook]
- Transfer in: POST /api/v1/transfers {domain, auth_code} → 402 USDC (adds 1 year) [transfer_domain]
- Bulk cart: POST /api/v1/cart {domains:[...≤20]} → ONE 402 payment for all; failures refunded to balance [create_cart]
- Referrals: earn 10% of our margin on every order from users/agents you refer, credited to your USDC balance. Pass "ref":"<code>" on POST /api/v1/orders, /cart, /transfers, /keys, or link https://stabledomains.net/?ref=<code>. Stats GET /api/v1/referrals [referral_stats]; withdraw POST /api/v1/referrals/payout {amount_usd,address} (manual approval) [request_referral_payout]
- [Drops RSS](https://stabledomains.net/expiring/rss.xml)
- [x402 resources](https://stabledomains.net/.well-known/x402)

## Buy flow (3 calls)
1. GET /api/v1/search?q=name
2. POST /api/v1/orders {"domain":"name.com","chain":"base","token":"USDC"} with an Idempotency-Key header. The 402 response carries exact payment requirements.
3. Transfer the exact amount and POST /api/v1/orders/{id}/pay with X-PAYMENT-TX: <tx hash> — or retry with an X-PAYMENT x402 header (gasless). Poll GET /api/v1/orders/{id} until status=completed.