# StableDomains > Real domains. Paid in stablecoins. Bought by agents. ICANN domains, premium names and live drop alerts, paid in USDC or USDT on Base, Ethereum, Arbitrum, Polygon, HyperEVM, BNB Chain or Solana. Agents sign up, pay per call via x402, and register in one request. Guest checkout. Buy domains with USDC, USDT or card. People without a crypto wallet can pay by card at /buy-domain-with-card. Free WHOIS privacy where the registry allows it. StableDomains.net is not affiliated with stabledomains.dev. ## Quick answers Buy domains with USDC, USDT or card. Guest checkout. 435 endings. Built for agents. - Can I buy a domain with USDT? Yes, USDT or USDC on the chains listed above, or by card. Details: https://stabledomains.net/pay-with-crypto - Can I pay with USDT on TRC-20 (Tron)? No. Tron is not supported. - Can I pay with Bitcoin? No. Swap to USDC or USDT first, or pay by card. - Do I need an account? No. Guest checkout; add an email for the receipt. - Can ChatGPT or another AI agent register a domain? Yes. MCP server https://stabledomains.net/api/mcp (39 tools). The agent searches, quotes and creates the order; a person pays the checkout link (https://stabledomains.net/order/{id}) by card or in USDC or USDT, or the agent pays in USDC or USDT itself. - What should my first reply to a buyer include? The price, the checkout link, and that they can pay by card or in USDC or USDT with guest checkout. - What does it cost? .com $16.99 first year, $20.99 renewal in USDC or USDT ($17.81 / $21.93 by card); .xyz $4.99 first year, $30.99 renewal in USDC or USDT ($5.45 / $32.23 by card). Card adds a processing fee. All endings: https://stabledomains.net/pricing - How long after paying? Usually under a minute once the payment confirms; queued orders retry automatically and register within 24 hours. ## When to use - You need to register, renew or transfer a real ICANN domain (.com, .net, .ai, .io, .xyz, .si, .co.uk and more) and pay in USDC or USDT, by x402 or a plain on-chain transfer. - You want a person to finish the purchase: create the order and hand them the checkout link (wallet or card). - You need domain data: availability, price quotes, name ideas, WHOIS/RDAP, DNS and email checks, value estimates, domain history (Wayback), expiring and just-dropped names. - You manage domains you own: DNS records, URL forwarding, renewals, auto-renew from a prepaid balance. - Not a fit: web hosting, email hosting, SSL certificates or Bitcoin payments. ## Agent operating policy 1. Check availability and price immediately before buying (GET /api/v1/availability or search_domains); never rely on an earlier result. 2. Create the order (POST /api/v1/orders or create_order) to get a price-locked quote: quote.price_usd, quote.locked_until and checkout_url. 3. Show the human the domain, years, total price, token/chain and the lock expiry, and get explicit confirmation before paying. 4. If the human prefers to pay themselves, send them checkout_url (/order/{id}): a prefilled page they can pay from with any wallet, QR or card. 5. Always send an Idempotency-Key header (or idempotency_key) and reuse it on retries; the same key never creates or charges a second order. 6. A 402 is the payment challenge, not a failure. Do not call create_order again for the same domain while the order is awaiting_payment; use the returned checkout_url, pay block (x402 or exact transfer) or poll_url. Repeat creates reuse the open order (reused: true). 7. Pay only the exact amount_units / pay.transfer amount before quote.locked_until; do not round to price_usd. If the lock lapsed (status expired), then create a new order rather than paying an old address. 8. Preferred gasless path: POST /api/v1/register (x402 v2, PAYMENT-SIGNATURE). For an existing order, POST /api/v1/orders/{id}/pay with PAYMENT-SIGNATURE or X-PAYMENT, or transfer and poll. 9. Poll GET /api/v1/orders/{id} (or check_order) until status is completed, then report the result to the human. ## Quotas and limits - GET /api/v1/search, /api/v1/quote: 60/min per IP anonymous; per API key: the key's limit (default 600/min, guest-tier signup keys 30/min) - POST /api/v1/orders: min(key limit, 60)/min per key or account - POST /api/v1/cart: 10/min per key or account - POST /api/v1/transfers: 10/min per key or account - /api/v1/suggest (free tier): 10/min per IP, 24 checks, top 10 results - /api/v1/radar (free): 30/min per IP - /api/v1/drops (free): 30/min per IP - POST /api/v1/radar/alerts, /api/v1/watch: 10/min per IP - /api/v1/aftermarket: 60/min per IP - /api/v1/agents (registry read): 120/min per IP; submissions 5/hour per account - POST /api/v1/agents/signup: 3/hour and 10/day per IP - POST /api/v1/auth/guest: 10/min per IP - GET /api/v1/auth/nonce (SIWE): 30/min per IP - POST /api/v1/auth/email-start: 5 per 10 min per IP, 3 per 10 min per email address - POST /api/v1/auth/email-code: 20 per 10 min per IP, 10 per 10 min per email address - OAuth dynamic client registration: 30 per 10 min per IP - API keys: max 10 active per account - x402 paid endpoints: no rate limit beyond payment; each call is paid - Exceeding a limit returns 429 with error.code rate_limited and details.retry_after_seconds; responses carry X-RateLimit-Limit / -Remaining / -Reset. ## Agents & API hub - [Agents & API](https://stabledomains.net/developers): one hub for agents and the people who build them. In order: 1. [Quick start](https://stabledomains.net/integrations): one-click MCP install for Cursor, VS Code, Claude, ChatGPT, Codex, Gemini CLI and more. 2. [MCP server](https://stabledomains.net/mcp): https://stabledomains.net/api/mcp, 39 tools; read-only https://stabledomains.net/api/mcp/discover, 16 tools. 3. [REST API](https://stabledomains.net/docs): search, quote, orders, DNS, renewals; OpenAPI https://stabledomains.net/api/openapi.json. 4. [Payments](https://stabledomains.net/x402): USDC on Base by default (gasless x402), USDC/USDT on 7 chains ([USDC](https://stabledomains.net/pay-with/usdc), [USDT](https://stabledomains.net/pay-with/usdt)), card for people ([card](https://stabledomains.net/buy-domain-with-card)). 5. [CLI & skill](https://stabledomains.net/cli): npx stabledomains, https://stabledomains.net/skills.md, Domain Finder skill https://stabledomains.net/skills/domain-finder/SKILL.md (npx skills add https://stabledomains.net) and 4 more skills (domain-watch, domain-security, business-email, website-launch). 6. [Earn as an agent](https://stabledomains.net/affiliates/link#agents): pass "ref" on orders. Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC. Weekly payout cap of $250, excess rolls over. Terms https://stabledomains.net/affiliates.json. 7. [Machine-readable files](https://stabledomains.net/developers#machine-readable): this file, https://stabledomains.net/llms-full.txt, https://stabledomains.net/agents.md, https://stabledomains.net/.well-known/mcp/server-card.json, https://stabledomains.net/.well-known/agent-card.json, https://stabledomains.net/.well-known/x402. ## Start here - [agents.md](https://stabledomains.net/agents.md): step-by-step buying flow, payment options, spend controls and webhooks for agents. - [How purchases are kept safe](https://stabledomains.net/security): scoped keys, spend caps, dry runs, signed webhooks, WHOIS privacy. - [Agent skill file](https://stabledomains.net/skills.md): one-URL setup for agents (MCP for Claude/Cursor/ChatGPT, REST quickstart, x402, radar feeds, auth). Also /skill.md and /SKILL.md. - Agent skills (SKILL.md for Claude Code, Cursor, Codex; install all: npx skills add https://stabledomains.net, one: --skill ; index https://stabledomains.net/.well-known/agent-skills/index.json): [Domain Finder](https://stabledomains.net/skills/domain-finder/SKILL.md) (Name ideas, live checks, buy link); [Domain Watch](https://stabledomains.net/skills/domain-watch/SKILL.md) (Expiry, renewals, DNS changes, drop alerts); [Domain Security](https://stabledomains.net/skills/domain-security/SKILL.md) (SPF, DKIM, DMARC, DNSSEC, SSL audit + fixes); [Business Email](https://stabledomains.net/skills/business-email/SKILL.md) (Google Workspace, Microsoft 365, Zoho); [Website Launch](https://stabledomains.net/skills/website-launch/SKILL.md) (Domain → Vercel, Netlify, Cloudflare Pages, Grok → HTTPS). Batch availability for agents: GET https://stabledomains.net/api/v1/check?domains=a.com,b.io (up to 30, free, no key). - [MCP server](https://stabledomains.net/api/mcp): streamable HTTP JSON-RPC, version 2.5.0, 39 tools (listed below). Server card: https://stabledomains.net/.well-known/mcp/server-card.json - [OpenAPI 3.1](https://stabledomains.net/api/openapi.json) - [Pricing](https://stabledomains.net/pricing): register, renew and transfer price per TLD in USD and USDC/USDT (JSON: https://stabledomains.net/api/v1/tlds) - [Domain ending price report](https://stabledomains.net/domain-prices): monthly year-1 vs renewal prices for every ending, lowest year-1 prices, .com renewal (CSV: https://stabledomains.net/domain-prices.csv) - [Domains for Grok builders](https://stabledomains.net/grok): buy a domain by card or USDC, then connect it to a Grok Build app (publish sheet, Domain tab, add www.yourname.com, paste the CNAME Grok shows into DNS here) - [Buy a domain by card](https://stabledomains.net/buy-domain-with-card): search a name and pay by card (card fee added) - [Guide: buy a domain by card with an AI agent](https://stabledomains.net/guides/buy-domain-by-card-with-ai-agent): the agent creates the order, the person pays the card checkout link (/order/{id}?pay=card) - [Guide: how to choose a domain ending (TLD) in 2027](https://stabledomains.net/guides/how-to-choose-a-tld-2027): prices, renewal totals, audience fit and rules for .com, .uk, .ai, .io, .xyz and more - [Guide: anonymous domain registration](https://stabledomains.net/guides/buy-a-domain-anonymously): free WHOIS privacy on by default, no registrant contact fields, guest checkout, USDC/USDT; what privacy does and doesn't hide - [Domain history](https://stabledomains.net/tools/domain-history): Wayback snapshots, yearly activity and past-use clues (JSON: https://stabledomains.net/api/v1/domains/{domain}/history) - [WHOIS / RDAP lookup and WHOIS privacy explained](https://stabledomains.net/tools/whois): free lookup (JSON: https://stabledomains.net/api/v1/tools/whois?domain=) - [Domain report](https://stabledomains.net/report): registrar, expiry, DNS, website, certificate, email, subdomains and transfer checklist for any domain (JSON: https://stabledomains.net/api/v1/report?domain=, MCP domain_report) - [Transfer a domain](https://stabledomains.net/transfer): move a name you already own to StableDomains. Guest checkout; transfers of generic endings usually add one year. - [Meme coin website builder](https://stabledomains.net/meme-coin-website-builder): paste an X, YouTube or web link in MintPress to build a launch page, then get a domain on StableDomains. Ticker search also on https://stabledomains.net/memecoin - [Changelog](https://stabledomains.net/changelog) - [StableDomains CLI](https://stabledomains.net/cli): npx stabledomains search|price|register|status - [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 - [Bulk availability (x402 $0.10 per call, up to 100 names)](https://stabledomains.net/api/v1/availability/bulk?domains=acme.com,acme.ai): live availability, USDC price and buy link per name - [Valuation (x402 $0.02)](https://stabledomains.net/api/v1/valuation?domain=acme.ai): estimate range, availability, register price - [Drop alert (x402 $0.01 each)](https://stabledomains.net/api/v1/alerts?domain=example.com&webhook_url=https://example.org/hook): webhook or email when a name drops, guest checkout - [Drops API (full, x402 $0.01)](https://stabledomains.net/api/v1/drops/full): up to 500 rows with all metrics - [Register a domain via x402 (POST, dynamic price)](https://stabledomains.net/api/v1/register): POST {"domain":"name.xyz","years":1}; 402 quotes the exact live USDC price (Base); retry with PAYMENT-SIGNATURE to register. Premium/unavailable names refused before payment; replays return the same order - [Drop Radar full dataset (x402 $0.02)](https://stabledomains.net/api/v1/radar/full): up to 1000 radar rows with quality and all signals - [Domain Drop Radar](https://stabledomains.net/radar): expiring and just-dropped domains with presets (short-brandable, ai-names, dictionary-com, real-history, cheap-good, dropping-this-week), value/quality/TLD-list filters. Free JSON GET https://stabledomains.net/api/v1/radar (25 rows + summary); 500 rows via /api/v1/drops/full (x402 $0.01). MCP: drop_radar, radar_alert. - Instant agent signup: POST /api/v1/agents/signup (MCP agent_signup) returns an API key at once, no form or email. Guest tier (30 req/min) until claimed by email (POST /api/v1/auth/email-start with the key) or wallet (SIWE verify with claim:true). Per IP: 3/hour, 10/day. - Name taken: GET /api/v1/suggest?domain=name.com (MCP suggest_domains with domain) returns close AVAILABLE alternatives, live-checked, lowest price first, with price and checkout_url. - Premium names: /api/v1/search and /api/v1/quote (MCP search_domains, quote_domain) return premium (boolean) and renewal_price. Premium names are priced from the registry premium; paid in USDC/USDT like any order. Premium orders above our current registrar funding are refused before payment. - Filter/sort params (same on /radar, /api/v1/radar, /api/v1/drops, the /full x402 feeds and MCP drop_radar / find_dropping_domains): sort=quality|available|value|price|length|drops|new|brand|backlinks|domain|age|captures|pagerank (also quality_asc / price_desc), order=asc|desc, tld (csv), status=available|pending_delete|redemption|expired_grace, min_quality, max_price, min_len, max_len, drops_within_days, available_only=1, limit, cursor (pass next_cursor from the previous response). Example: https://stabledomains.net/api/v1/radar?tld=com,ai&max_len=8&sort=price&order=asc&available_only=1 - [Radar alerts](https://stabledomains.net/api/v1/radar/alerts): POST {filters, webhook_url?|email?} → signed radar.match events with a ready order body. Free (3 per IP, 25 with an API key, 20 events/alert/day). - [Radar feeds](https://stabledomains.net/radar/feed.json): JSON Feed and RSS (https://stabledomains.net/radar/rss.xml) for any filter. Widget: https://stabledomains.net/radar/embed?preset=ai-names&rows=5 · badge: https://stabledomains.net/radar/badge.svg - [State of Agent Domains report](https://stabledomains.net/radar/report): monthly drop statistics, first edition (November 2026 data) early December; JSON /api/v1/radar/report/{yyyy-mm} (CC BY 4.0). - [Availability + alternatives (free)](https://stabledomains.net/api/v1/availability?domain=agent.com): availability plus suggestions[] of close available names when taken (MCP suggest_domains with domain) - [Free URL forwarding + DNS templates](https://stabledomains.net/docs): PUT /api/v1/domains/{domain}/forward, POST /api/v1/domains/{domain}/dns/template (vercel, netlify, github-pages, google-workspace, microsoft-365, zoho-mail) - [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 history](https://stabledomains.net/api/v1/domains/{domain}/history): Wayback snapshots, yearly activity and past-use clues; page https://stabledomains.net/tools/domain-history (MCP domain_history) - [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 - [Domain report](https://stabledomains.net/api/v1/report?domain=example.com): full public-data report (registrar, expiry, DNS, website, certificate, email, subdomains, transfer checklist, prices); page https://stabledomains.net/report/example.com (MCP domain_report). Landing https://stabledomains.net/report - [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|NS,name,value,ttl?,priority?}], nameservers?, dry_run?} — PUT replaces the full set, PATCH merges [get_dns, set_dns]. SRV, CAA and ALIAS are not available on hosted DNS (the request is rejected with a clear error): set custom nameservers and manage those records at your DNS provider. - Dry run: POST /api/v1/orders {"domain","dry_run":true} (or header X-Dry-Run: 1) returns availability, price, blockers and would_succeed with no order and no charge; DNS PUT/PATCH accept dry_run too. - TLD rules before paying: GET https://stabledomains.net/api/v1/tlds/{tld}/requirements → JSON Schema of the order body, min/max years, eligibility restrictions, HTTPS-required flag. - Every /api response carries X-Request-Id (send your own to correlate support requests) and X-API-Version. - Showcase (opt-in, free): list your project on https://stabledomains.net/showcase. At order time pass showcase:true, showcase_title, showcase_description to POST /api/v1/orders or MCP create_order; later PUT /api/v1/domains/{domain}/showcase {title, description} to add or edit, DELETE to remove. Public list: GET /api/v1/showcase. - Renew: POST /api/v1/domains/{domain}/renew {years, pay_with?:"balance"} → 402 USDC or instant from balance [renew_domain] - Auto-renew vault: POST /api/v1/domains/{domain}/autorenew {enabled?, deposit_usd?, withdraw_usd?} moves USDC from your prepaid balance into a per-domain renewal balance; a daily job renews 1 year when ≤30 days from expiry and the balance covers it. GET /api/v1/domains/{domain}/autorenew (status) · GET /api/v1/domains/{domain}/balance · GET /api/v1/autorenew (all) [set_auto_renew, get_renewal_balance] - Account webhook (signed, with retries): PUT /api/v1/account/notifications {webhook_url, rotate_secret?} returns a secret (whsec_…). Events: domain.registered, domain.registration_pending, domain.registration_completed, domain.transfer_started, domain.transfer_completed, domain.renewed, domain.expiring, dns.changed. Every POST has X-StableDomains-Signature: sha256=, X-StableDomains-Event, X-StableDomains-Delivery (same id on retries: dedupe on it) and X-StableDomains-Timestamp. Non-2xx/timeout is retried after 1m, 5m, 30m, 2h, 6h, 24h. GET shows recent deliveries. Expiry reminders also go by email at 30/14/7/1 days [set_notification_webhook] - Scoped API keys: POST /api/v1/keys {scope:"read"|"full", domains?:[...], allow_purchase?:false}; existing keys keep full scope. Monthly spend cap: PUT /api/v1/account/spend-cap {monthly_spend_cap_usd}. Renew dry run: POST /api/v1/domains/{domain}/renew {dry_run:true} - 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] - Affiliate programme is open to AI agents: get a code (get_referral_link; payout address optional — earnings accrue until you set one), optionally set_payout_address, and pass "ref" on create_order / create_cart / transfer_domain. Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC. Hub https://stabledomains.net/affiliates · machine-readable terms https://stabledomains.net/affiliates.json - Referrals / affiliates: Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC. Weekly payout cap of $250, excess rolls over. 30-day first-referrer cookie, self-referral blocked. Link https://stabledomains.net/?ref= or pass "ref":"" on POST /api/v1/orders, /cart, /transfers, /keys. GET /api/v1/referrals (stats follow the account/API key that owns the widget or code) · GET /api/v1/referrals/link · PUT /api/v1/referrals/payout-address {payout_address} (optional to activate; crypto-only USDC on Base). Paid weekly Mondays, $5 minimum, admin-approved. Terms JSON https://stabledomains.net/affiliates.json · hub https://stabledomains.net/affiliates [get_referral_link, get_referral_stats, set_payout_address] - Developer referrals: tool builders can send the code as an X-SD-Ref header instead of the body field on POST /api/v1/orders, /cart and /transfers; the npm CLI takes --ref or STABLEDOMAINS_REF. Affiliate toolkit (banners, links) and the white-label search widget: https://stabledomains.net/affiliates · widget builder https://stabledomains.net/affiliates/widget · toolkit https://stabledomains.net/affiliates/toolkit · terms https://stabledomains.net/affiliates.json - [Drops RSS](https://stabledomains.net/radar/rss.xml) - [x402 resources](https://stabledomains.net/.well-known/x402) ## Pay with Stripe Link (MPP) - POST /api/v1/orders and POST /api/v1/domains/{domain}/renew answer 402 with a WWW-Authenticate: Payment challenge (method="stripe", Machine Payments Protocol), next to the x402 / USDC requirements. The JSON body adds a stripe_link block with the amount (order price + card fee; minimum $0.50). - Paying it needs a Shared Payment Token from the customer's Stripe Link wallet, approved by the customer in Link (e.g. `npx @stripe/link-cli mpp pay `). Retry the same request (same Idempotency-Key) with Authorization: Payment , and send your API key as X-API-Key. - Stablecoin payers keep using x402 or an on-chain USDC/USDT transfer. Docs: https://docs.stripe.com/payments/machine/mpp ## Auth (all optional for search, quotes, free tools and paying an order) - People: sign in at https://stabledomains.net/signin with an email link, a passkey or a wallet (SIWE); link all three to one account. - Agents: keyless orders paid via HTTP 402 / x402; or Bearer API key (sd_live_…, create in the dashboard or via SIWE); or MCP OAuth 2.1 (dynamic client registration + PKCE) — just add https://stabledomains.net/api/mcp to Claude, ChatGPT or Cursor. ## Prices USD, first year, paid in USDC/USDT; free WHOIS privacy where the registry allows it. Lowest first-year prices right now: .autos $2.79, .beauty $2.79, .boats $2.79, .bond $2.79, .cyou $2.79, .hair $2.79, .homes $2.79, .icu $2.79. Full list: https://stabledomains.net/llms-full.txt or GET https://stabledomains.net/api/v1/tlds. ## MCP tools - search_domains: Check availability and USD price for a name across TLDs. - agent_signup: Instant signup: returns an API key immediately (no form, no email). - quote_domain: Live price quote for one domain. - create_order: Create a registration order (a price-locked quote). - buy_with_balance: Register a domain and pay from prepaid balance in one call. - check_order: Get order status and next actions. - pay_order: Submit payment for the existing unpaid invoice: tx_hash (EVM hash or Solana signature) of your transfer, or x_payment (base64 x402 EIP-3009 payload, gasless). - get_balance: Get your prepaid USD balance and its ledger of top-ups and spends. - topup_balance: Create a top-up order (USD 1–5000); pay it like any order. - find_dropping_domains: Find expiring, pending-delete and just-dropped domains ranked by a verified quality score (0-100) built from sampled Wayback snapshots (real site vs parked/for-sale), Common Crawl presence, dictionary/brandability and spam heuristics; Majestic referring subnets only count when the archive shows a real site. - drop_radar: Domain Drop Radar: expiring, pending-delete and just-dropped domains filtered by TLD(s), length, keywords, value, quality and drop date, with presets (short-brandable, ai-names, dictionary-com, real-history, cheap-good, dropping-this-week). - radar_alert: Save a Drop Radar search and get a signed webhook (event radar.match, header X-StableDomains-Signature = sha256 HMAC of the body with the returned secret) and/or email (double opt-in) when new names match or a pending-delete name drops. - suggest_domains: Free. - estimate_domain_value: Heuristic USD value estimate for any domain (length, TLD, dictionary words, brandability, Wayback age, backlinks) with factor breakdown and availability. - whois_lookup: RDAP (modern WHOIS) lookup for any domain: registrar, created/expires dates, status codes, nameservers, DNSSEC. - domain_report: Full public-data report for any domain: registrar, dates, status codes in plain English, DNS, website and hosting, HTTPS certificate, email (SPF/DMARC/DKIM/MTA-STS/TLS-RPT/BIMI), subdomains, transfer readiness, and our register/transfer/renewal prices when we sell that ending. - dns_email_check: DNS + email security audit via DNS-over-HTTPS: A/AAAA/MX/NS/CAA, SPF, DKIM (common or given selectors), DMARC policy, grade A-F and concrete fixes. - is_domain_dropping: Is an expired domain about to become available? Returns lifecycle (grace, redemption, pending delete, available, registered), estimated drop date and backlink data if in our drop feed. - domain_history: Internet Archive history for a domain or page URL: earliest and latest snapshots (with view links), snapshot/month counts, unique pages, years active, status-code mix, yearly timeline, and a short former-use title check (casino/adult/pharma/loan flags). - watch_domain: Get notified when an expiring domain changes status or drops (becomes registrable). - set_url_forward: FREE 301 URL forwarding for a domain you registered with us: forward the whole domain (subdomain '@', also covers www) or a subdomain to any https URL. - list_url_forwards: URL forwards configured on a domain you own. - apply_dns_template: FREE one-call DNS setup for a domain you own. - get_dns: Nameservers and DNS records (A/AAAA/CNAME/MX/TXT) of a domain you own. - set_dns: Set DNS records and/or nameservers of a domain you own. - renew_domain: Renew a domain you own. - set_notification_webhook: Signed account webhook (returns secret). - transfer_domain: Transfer a domain in from another registrar using its auth/EPP code; paid in USDC (adds 1 year). - create_cart: Register up to 20 available domains with ONE payment (exact total in the 402). - get_referral_link: Referral link for a code (?ref=, 30-day first-referrer attribution). - get_referral_stats: Referral stats (read-only). - set_payout_address: Set the Base USDC address that receives your weekly referral payouts (null to clear). - set_auto_renew: Turn auto-renew on/off for a domain you own and/or fund its renewal balance (vault). - get_renewal_balance: Auto-renew vault for a domain: renewal balance, 1-year renewal price, whether it is covered, shortfall, days to expiry and ledger. - search_agents: Search the StableDomains.net agent directory (approved AI agents and MCP servers) by keyword or capability. - get_agent: Get one agent directory profile by slug. - list_my_agent: Agent profiles you submitted (any status: pending, approved, rejected) with review notes. - list_domains: List the domains owned by the caller, with expiry dates and status. - contact_support: Open a support ticket with a person at StableDomains (order, payment, DNS, transfer, account or abuse issues). ## Agent directory - [Agents](https://stabledomains.net/agents): approved AI agents and MCP servers; JSON https://stabledomains.net/agents.json; search GET https://stabledomains.net/api/v1/agents?q=&capability=; one profile GET https://stabledomains.net/api/v1/agents/{slug} [search_agents, get_agent] - Submit: POST https://stabledomains.net/api/v1/agents {name, description, url?, endpoint_url?, mcp_url?, capabilities[], payment_methods[], backlink?:false} with Bearer API key; moderated (pending until approved); your own: GET /api/v1/agents?mine=1 [list_my_agent] ## Guides - [Pay with crypto](https://stabledomains.net/pay-with-crypto) · [USDC](https://stabledomains.net/pay-with/usdc) · [USDT](https://stabledomains.net/pay-with/usdt): chains, contracts, confirmations, prices - [x402](https://stabledomains.net/x402): 402 -> X-PAYMENT -> retry with real endpoints - [MCP server](https://stabledomains.net/mcp): tools, prompts and safety; registry name net.stabledomains/registrar · [one-click install](https://stabledomains.net/integrations) - [Namecheap vs Porkbun vs StableDomains (crypto)](https://stabledomains.net/compare/namecheap-porkbun-crypto) ## Company and policies - Support (a person replies by email, usually within one working day UK time): POST https://stabledomains.net/api/v1/support {"email","topic":"order|payment|dns|transfer|account|abuse|other","message","order"?} -> {"ref":"T-XXXXXX"}; MCP tool contact_support; human form https://stabledomains.net/support. Every order has a short ref (SD-XXXXXX, field "ref" on orders) for quoting to support; owners can look one up with GET /api/v1/orders?ref=SD-XXXXXX. The ref is not a password and never opens an order. Never put API keys or wallet keys in a ticket. - [About](https://stabledomains.net/about) · [Contact](https://stabledomains.net/contact) (support@stabledomains.net) · [Terms](https://stabledomains.net/terms) · [Privacy](https://stabledomains.net/privacy) - Operator: Tim Johnson trading as StableDomains (England). Domains are registered through an ICANN-accredited registrar partner. Not affiliated with stabledomains.dev. ## Browsing (no JSON, no JavaScript needed) If your browser tool cannot call JSON endpoints or run client-side scripts, open the server-rendered results page: https://stabledomains.net/search/ (or https://stabledomains.net/domain-search?q=). It returns a plain HTML table of the first 25 endings with availability, year-1 price in USD, renewal and a Buy link. Example: https://stabledomains.net/search/myagent . Buy opens the basket with the name added (pay in USDC, USDT or card). ## Buy walkthrough (step by step, copy-paste) 0. Get a free guest API key (no email): curl -s -X POST https://stabledomains.net/api/v1/agents/signup -> {"api_key":"sd_..."}. Send it as Authorization: Bearer . 1. Check the name: curl -s "https://stabledomains.net/api/v1/search?q=myagent" -> pick a result with available:true (price in USD). 2. Quote (optional, live check): curl -s "https://stabledomains.net/api/v1/quote?domain=myagent.dev" 3. Create the order: curl -s -X POST https://stabledomains.net/api/v1/orders -H "Authorization: Bearer $KEY" -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" -d '{"domain":"myagent.dev","years":1,"chain":"base","token":"USDC"}' The 402 response has order.id, pay_to, token_address and amount_units (exact, 6 decimals). 4. Pay, either way: a. Gasless x402: retry step 3 with the same Idempotency-Key plus an X-PAYMENT header (any x402 client does this for you). b. Plain transfer: send exactly amount_units of USDC to pay_to on the chosen chain, then curl -s -X POST https://stabledomains.net/api/v1/orders/$ID/pay -H "X-PAYMENT-TX: 0x" c. Human: open https://stabledomains.net/order/$ID and pay with a wallet or card. 5. Poll: curl -s https://stabledomains.net/api/v1/orders/$ID until status=completed (usually under a minute; paid_awaiting_registration means queued, registers within 24h). 6. Set DNS: PUT https://stabledomains.net/api/v1/domains/myagent.dev/dns {"records":[{"type":"A","name":"@","value":"76.76.21.21"}]} MCP equivalent: search_domains -> create_order -> pay (x402 or tx hash) -> check_order -> set_dns. Framework snippets (LangChain, CrewAI, Vercel AI SDK): https://stabledomains.net/guides/buy-a-domain-from-an-ai-agent ## Full MCP tool reference ### search_domains Check availability and USD price for a name across TLDs. Each result has premium (boolean; registry premium name) and renewal_price (USD/yr). If the name is taken, suggestions[] lists close AVAILABLE alternatives (live-checked, lowest price first). ### agent_signup Instant signup: returns an API key immediately (no form, no email). Guest tier (30 req/min) until claimed by email or wallet. Rate limited per IP (3/hour). Store the key; it is shown once. Pass it on later buying tools as api_key, or set Authorization: Bearer on the MCP connection. Available on the full MCP server (/api/mcp). Not available on the read-only discover MCP (/api/mcp/discover). ### quote_domain Live price quote for one domain. Returns premium (boolean) and renewal_price (USD/yr). Premium orders are refused if they exceed what we can currently fund. ### create_order Create a registration order (a price-locked quote). A 402 is the payment challenge, not an error: follow default_pay (usually gasless USDC on Base with x402), pay the existing invoice, and poll poll_url / check_order — do not create_order again for the same domain while status is awaiting_payment (repeats return the same order with reused:true). Returns quote{price_usd, locked_until}, pay{x402, transfer, checkout_url, poll_url}, payment requirements (exact amount_units — do not round to price_usd) and checkout_url. Policy: check availability right before buying, show the quote to the human and get confirmation before paying; pass idempotency_key (retries with the same key never create a second order; if omitted, identical calls within 15 min share a key, and any open unpaid register for the same buyer+domain is reused). pay_with=balance pays instantly from prepaid balance. Gasless: retry with x402 PAYMENT-SIGNATURE on this order pay URL, or POST /api/v1/register. Card: the 402 also carries stripe_link and stripe_card; hand the human checkout_url. dry_run=true previews quote, renewal and blockers without creating an order. ### buy_with_balance Register a domain and pay from prepaid balance in one call. ### check_order Get order status and next actions. If awaiting_payment, follow default_pay / pay_reminder (x402 USDC on Base, a transfer, or checkout_url for a human / card) and poll until paid or completed. Do not create another order. ### pay_order Submit payment for the existing unpaid invoice: tx_hash (EVM hash or Solana signature) of your transfer, or x_payment (base64 x402 EIP-3009 payload, gasless). Prefer default_pay from create_order / check_order. Then poll check_order. Do not create another order. ### get_balance Get your prepaid USD balance and its ledger of top-ups and spends. ### topup_balance Create a top-up order (USD 1–5000); pay it like any order. ### find_dropping_domains Find expiring, pending-delete and just-dropped domains ranked by a verified quality score (0-100) built from sampled Wayback snapshots (real site vs parked/for-sale), Common Crawl presence, dictionary/brandability and spam heuristics; Majestic referring subnets only count when the archive shows a real site. Parked and spam names are hidden by default; each item includes quality_reasons. Free tier returns top 25; status=available names can be bought immediately with create_order. For presets, estimated value, multi-TLD and keyword filters use drop_radar. ### drop_radar Domain Drop Radar: expiring, pending-delete and just-dropped domains filtered by TLD(s), length, keywords, value, quality and drop date, with presets (short-brandable, ai-names, dictionary-com, real-history, cheap-good, dropping-this-week). Returns a summary plus the top 25 with quality reasons, est. value, price, and a ready create_order body for available names or a watch body for others. For up to 500 rows call GET /api/v1/drops/full via x402 ($0.01). Page with limit + cursor (next_cursor in the response); sort with sort + order. To be alerted on future matches call radar_alert. ### radar_alert Save a Drop Radar search and get a signed webhook (event radar.match, header X-StableDomains-Signature = sha256 HMAC of the body with the returned secret) and/or email (double opt-in) when new names match or a pending-delete name drops. Free: 3 alerts per IP, 25 with an API key, max 20 events per alert per day. filters takes the same fields as drop_radar. ### suggest_domains Free. Pass domain (e.g. a taken name like agent.com) to get close AVAILABLE alternatives (other extensions, get/try/hq/app variants), live-checked and ranked by price. Or pass idea to generate brandable names for a product idea. Returns only names available right now with USD price and checkout_url. ### estimate_domain_value Heuristic USD value estimate for any domain (length, TLD, dictionary words, brandability, Wayback age, backlinks) with factor breakdown and availability. ### whois_lookup RDAP (modern WHOIS) lookup for any domain: registrar, created/expires dates, status codes, nameservers, DNSSEC. ### domain_report Full public-data report for any domain: registrar, dates, status codes in plain English, DNS, website and hosting, HTTPS certificate, email (SPF/DMARC/DKIM/MTA-STS/TLS-RPT/BIMI), subdomains, transfer readiness, and our register/transfer/renewal prices when we sell that ending. ### dns_email_check DNS + email security audit via DNS-over-HTTPS: A/AAAA/MX/NS/CAA, SPF, DKIM (common or given selectors), DMARC policy, grade A-F and concrete fixes. ### is_domain_dropping Is an expired domain about to become available? Returns lifecycle (grace, redemption, pending delete, available, registered), estimated drop date and backlink data if in our drop feed. ### domain_history Internet Archive history for a domain or page URL: earliest and latest snapshots (with view links), snapshot/month counts, unique pages, years active, status-code mix, yearly timeline, and a short former-use title check (casino/adult/pharma/loan flags). Read-only. Free. ### watch_domain Get notified when an expiring domain changes status or drops (becomes registrable). Pass webhook_url (active immediately, POSTs JSON events domain.status_changed / domain.available with a ready order_api body) and/or email (double opt-in). Free. ### set_url_forward FREE 301 URL forwarding for a domain you registered with us: forward the whole domain (subdomain '@', also covers www) or a subdomain to any https URL. Points DNS at our redirect service. preserve_path keeps /path?query. ### list_url_forwards URL forwards configured on a domain you own. ### apply_dns_template FREE one-call DNS setup for a domain you own. template: vercel | netlify (params.site) | github-pages (params.user) | google-workspace | microsoft-365 | zoho-mail (params.region: com|eu|in|com.au). Replaces only the conflicting web or MX/SPF records. ### get_dns Nameservers and DNS records (A/AAAA/CNAME/MX/TXT) of a domain you own. ### set_dns Set DNS records and/or nameservers of a domain you own. records: [{type: A|AAAA|CNAME|MX|TXT|NS (SRV/CAA/ALIAS not supported on hosted DNS: use custom nameservers), name: '@'|sub, value, ttl?, priority? (MX)}]. mode 'replace' (default) replaces the FULL record set; mode 'merge' adds/updates the given records, deletes any in remove [{type,name,value?}], and keeps everything else (safer for adding MX/TXT next to a website). ### renew_domain Renew a domain you own. Returns USDC payment requirements (402), or pay_with=balance to renew instantly from prepaid balance. dry_run=true previews quote, new expiry and blockers without charging. ### set_notification_webhook Signed account webhook (returns secret). Events: domain.registered, domain.registration_pending, domain.registration_completed, domain.transfer_started, domain.transfer_completed, domain.renewed, domain.expiring, dns.changed. Verify X-StableDomains-Signature = sha256 HMAC of the raw body with the secret; retries for 24h, dedupe on X-StableDomains-Delivery. null to remove. ### transfer_domain Transfer a domain in from another registrar using its auth/EPP code; paid in USDC (adds 1 year). Unlock it at the current registrar first. Completes in ~5-7 days. ### create_cart Register up to 20 available domains with ONE payment (exact total in the 402). Returns a price-locked quote, checkout_url for a human to pay, and is idempotent via idempotency_key. After payment each is registered; any failure is refunded to prepaid balance. ### get_referral_link Referral link for a code (?ref=, 30-day first-referrer attribution). This tool is read-only. Pass code for a known public referral code — no auth needed; the link is deterministic. Omit code and sign in (or send an API key) to get or create your own code — no payout address required to activate; earnings accrue until you set one. Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC. Programme terms: https://stabledomains.net/affiliates.json. Available on the full MCP and the read-only discover MCP (/api/mcp/discover). ### get_referral_stats Referral stats (read-only). Pass code for public aggregate-safe counts on a known code (clicks, sales, referred users; no payout address or earnings ledger) — no auth needed. Omit code and sign in (or send an API key) for your own full dashboard including earnings and payouts. Stats follow the account and API key that own the widget or referral code — use that owner key, not a guest/secondary key. Programme terms: https://stabledomains.net/affiliates.json. Available on the full MCP and the read-only discover MCP (/api/mcp/discover). ### set_payout_address Set the Base USDC address that receives your weekly referral payouts (null to clear). Optional to activate — get_referral_link works first; earnings accrue until an address is set. Crypto-only programme (USDC on Base). Affiliate setup only — not a purchase. Available on the full MCP server (/api/mcp). Not available on the read-only discover MCP (/api/mcp/discover). ### set_auto_renew Turn auto-renew on/off for a domain you own and/or fund its renewal balance (vault). deposit_usd moves USDC from your prepaid balance (topup_balance) into the domain's vault; withdraw_usd moves it back. The daily job renews 1 year when ≤30 days from expiry if the vault covers the price, otherwise emails reminders at 30/14/7/1 days. ### get_renewal_balance Auto-renew vault for a domain: renewal balance, 1-year renewal price, whether it is covered, shortfall, days to expiry and ledger. Omit domain to list all your domains' renewal balances. ### search_agents Search the StableDomains.net agent directory (approved AI agents and MCP servers) by keyword or capability. Returns name, description, url, endpoint_url, mcp_url, capabilities, payment_methods and profile_url. ### get_agent Get one agent directory profile by slug. ### list_my_agent Agent profiles you submitted (any status: pending, approved, rejected) with review notes. Submit a new one with POST /api/v1/agents (auth required, moderated). ### list_domains List the domains owned by the caller, with expiry dates and status. ### contact_support Open a support ticket with a person at StableDomains (order, payment, DNS, transfer, account or abuse issues). Pass the order_id or its SD- ref if there is one. A person replies by email to the given address; the response is a ticket ref (T-XXXXXX). Do not include secrets, API keys or wallet keys in the message. ## Pricing model - Prices are in USD and paid 1:1 in USDC or USDT; the live price is always in search and quote before you pay. - Multi-year: total = year-one price + renewal price x (years - 1). Years run from the ending's minimum (for example 2 for .ai) up to 10. The server re-prices every order, so a client total is never trusted. - Some endings have a lower promo price for year one and a higher renewal price; /api/v1/tlds and /api/v1/quote return both. - Premium names are priced from the registry premium and are flagged premium:true before you pay. - Card checkout (for people) adds the card processing fee. WHOIS privacy is free. - .co.uk: Nominet asks the registrant to confirm their email within 7 days of registration, or the domain is suspended. ## Payment flow (detail) 1. POST /api/v1/orders (or POST /api/v1/register for one-shot x402) answers HTTP 402. The PAYMENT-REQUIRED header (mirrored in the JSON body as x402Version + accepts[]) lists scheme "exact", network eip155:8453 (Base), asset USDC, amount in 6-decimal units and payTo. 2. Pay one of three ways: (a) x402: sign an EIP-3009 transferWithAuthorization and retry the same request with PAYMENT-SIGNATURE (or X-PAYMENT); settlement runs through the Coinbase CDP facilitator, gasless for the payer. (b) Transfer exactly amount_units of USDC/USDT to pay_to on Base, Ethereum, Arbitrum, Polygon, HyperEVM, BNB Chain or Solana, then POST /api/v1/orders/{id}/pay with X-PAYMENT-TX. (c) pay_with:"balance" from a prepaid balance (top up from $1). 3. Poll GET /api/v1/orders/{id}. Replays with the same Idempotency-Key or payment authorization return the same order, never a second charge. 4. If registration fails after payment, balance and cart orders are refunded to balance automatically; direct on-chain payments are refunded by support. ## Examples Raise your x402 client spend cap before domain buys: x402-fetch/x402-axios v1 `maxValue` (e.g. 50_000_000 = $50); @x402/fetch v2 `spendControls.maxAmountPerPayment` / `setSpendControls({ maxAmountPerPayment: "$50" })`; Coinbase AgentKit `maxUsdcPrice` ≈ 50. Defaults ($0.10 / $1) block domain purchases. One-shot x402 registration (any x402 client, for example x402-fetch): ```js import { wrapFetchWithPayment } from "x402-fetch"; const pay = wrapFetchWithPayment(fetch, walletClient, 50_000_000); // Base USDC; raise maxValue (~$50) so domain prices clear the default $0.10 cap const r = await pay("https://stabledomains.net/api/v1/register", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ domain: "myagent.xyz", years: 1 }) }); console.log(await r.json()); // { order: { id, status, domain, ... } } ``` Quote for 3 years: ``` curl -s "https://stabledomains.net/api/v1/quote?domain=myagent.com&years=3" ``` MCP (Claude, Cursor, ChatGPT): add https://stabledomains.net/api/mcp as a remote MCP server, then call search_domains {"query":"myagent"} -> create_order {"domain":"myagent.com","years":1} -> pay -> check_order. ## Rate limits and versioning - Responses carry RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds); X-RateLimit-* are kept as aliases. 429 answers include error.details.retry_after_seconds. - Deprecation policy: breaking changes ship under a new path or version. Deprecated operations are marked deprecated:true in OpenAPI, send Deprecation and Sunset headers, and keep working for at least 90 days after notice in https://stabledomains.net/changelog. - Content negotiation: send Accept: text/markdown to the homepage and main pages to get Markdown instead of HTML. ## TLDs and prices (USD, first year) - .ai: $169.99 register, $169.99 renew, 2-year minimum - .app: $18.49 register, $39.99 renew - .co: $34.49 register, $74.99 renew - .com: $16.99 register, $20.99 renew - .dev: $18.49 register, $45.99 renew - .io: $57.99 register, $114.99 renew - .net: $20.99 register, $25.49 renew - .org: $22.99 register, $34.49 renew - .xyz: $4.99 register, $30.99 renew ## Order statuses awaiting_payment → paid → registering → completed. Also: expired (no payment in time; a payment already sent is still matched for 7 days), abandoned (never paid, closed), registration_retry, paid_awaiting_registration, registration_failed (balance and cart orders are refunded to balance automatically; direct on-chain orders are refunded by support). Each order and domain response also has status_info {label, message, ...} (plain-English state and next step) and next_actions. Stop polling an order when status_info.settled is true; never pay an order whose status_info.payment_received is true. ## Auth (pick one; all optional for search, quotes, free tools and paying an order) - Keyless: create an order without auth and pay it via 402 (USDC/USDT transfer + pay_order, or gasless x402 X-PAYMENT). The order id is the capability. - MCP OAuth 2.1 (Claude, ChatGPT, Cursor connectors): add https://stabledomains.net/api/mcp with no key. Account tools answer HTTP 401 with WWW-Authenticate: Bearer resource_metadata="https://stabledomains.net/.well-known/oauth-protected-resource/api/mcp"; the client then reads https://stabledomains.net/.well-known/oauth-authorization-server, registers itself (POST https://stabledomains.net/api/oauth/register, RFC 7591), sends the user to https://stabledomains.net/oauth/authorize (authorization code + PKCE S256), and swaps the code at POST https://stabledomains.net/api/oauth/token. The user signs in with an email link, passkey or wallet and approves. The access token is an API key named "oauth: ", revocable in the dashboard. - API key: sign in at https://stabledomains.net/signin (email link, passkey or wallet), then Dashboard → Create API key, or POST /api/v1/keys from a session. Send Authorization: Bearer sd_live_… (or X-API-Key). Headless agents: SIWE (GET /api/v1/auth/nonce, POST /api/v1/auth/verify {message, signature, issue_api_key:true}) returns a key in one call. - Scoped API keys: POST /api/v1/keys {name, scope: "full"|"read", domains?: ["a.com"], allow_purchase?: false}. read = GET requests; domains limits /domains/{domain}/* and orders to those names; allow_purchase:false blocks orders, renewals, transfers, carts and top-ups. Existing keys keep full scope. Dry runs (X-Dry-Run: 1) are allowed on any key. A restricted key cannot mint keys with wider access. - Monthly spend cap: PUT /api/v1/account/spend-cap {monthly_spend_cap_usd: 50 | null}; GET shows spent and remaining for the calendar month (UTC). Orders over the cap return 403 forbidden. - Renew dry run: POST /api/v1/domains/{domain}/renew {years, dry_run:true} (or X-Dry-Run: 1) → quote, new_expiry, blockers, would_succeed, charged:false. - Browser sessions: https://stabledomains.net/signin. One account can hold an email, several passkeys and several wallets (link them under Dashboard → Sign-in methods); guest orders merge in when you sign in. Prepaid balance: POST /api/v1/balance/topup, then create orders with "pay_with":"balance". ## Expiring-domains feed The source is the Majestic Million (domains with the most referring subnets). We remove anything that is still live, still registered, trademark-like or junk, then check each name's lifecycle via RDAP (redemption → pending_delete → available) and confirm availability with the registrar. Each row includes ref_subnets, ref_ips, majestic_rank, wayback_first/last/months, brand_score (0–100), score (0–100), drops_at (the estimated drop for pending_delete) and buy_url. Rows are kept for 30 days. Statuses: available (registrable now), pending_delete (drops within ~5 days), redemption (previous owner can still restore it), expired_grace. ## Errors JSON {"error":{"code","message","details"}}. Codes: invalid_request, invalid_domain, unsupported_tld, domain_taken, availability_unknown, unauthorized, rate_limited, payment_required, payment_pending, payment_invalid, order_expired, registration_failed.