# StableDomains API
> Domain registration via x402/MPP micropayments. No accounts. Pay USDC on Base, Solana, or Tempo.

## Base URL
https://stabledomains.dev

## Auth
- x402/MPP: HTTP 402 payment protocol. Paid endpoints.
- SIWX: Wallet signature. Domain management endpoints.

## Endpoints

### POST /api/check
Check availability and pricing. Auth: x402/MPP.
Body: { "domain": "example.com" }
Response: { "domain", "available", "basePrice", "currentPrice", "bondingMultiplier", "dailySlotsRemaining" }
If available is false, the domain cannot be registered.

### POST /api/register
Register a domain. Auth: x402/MPP.
Body: { "domain": "example.com", "notificationEmail": "you@example.com" }
notificationEmail is optional. Used for ICANN verification and expiry reminders.
Response: { "domain", "status", "nameservers", "hostedZoneId", "orderId" }
Usually synchronous (~3s). If status is "pending", poll GET /api/domain/status until "active".

### POST /api/domain/renew
Renew for 1-10 years. Auth: x402/MPP.
Body: { "domain": "example.com", "count": 3 }
count defaults to 1. Price = per-year renewal price × count.

### GET /api/domain/list
List domains owned by authenticated wallet. Auth: SIWX.
Response: array of { domain, status, expiresAt, daysRemaining, renewalPrice, icannVerified }

### GET /api/domain/status?domain=example.com
Registration status and DNS propagation. Auth: SIWX.
Response: { domain, status, nsPropagated, nameservers, dnsRecords, expiresAt }
After registration, poll until nsPropagated is true before configuring DNS.

### GET/POST /api/domain/dns
Read or modify DNS records. Auth: SIWX.
GET query: ?domain=example.com
POST body: { "domain": "example.com", "action": "upsert"|"delete", "records": [{ "type": "A", "name": "example.com", "value": "1.2.3.4", "ttl": 300 }] }
Supported types: A, AAAA, CNAME, MX, TXT, SRV, CAA. NS cannot be modified.
MX values include priority (e.g., "10 mail.example.com"). ttl defaults to 300.

### POST /api/domain/transfer-out
Transfer to another registrar. Auth: SIWX.
Body: { "domain": "example.com" }
60-day lock after registration per ICANN policy.

## TLDs and Pricing
- .com/.org/.net/.info/.biz: $20 reg, $20 renew, $0.01 check
- .xyz: $20 reg, $20 renew, $0.05 check
- .dev/.app: $25 reg, $25 renew, $0.05 check
- .io: $85 reg, $85 renew, $0.05 check
- .ai: $150 reg, $150 renew, $0.05 check

## Bonding Curve
Prices increase as daily slots fill (max 10/day): slots 1-5 at 1.0x, 6-7 at 1.5x, 8-9 at 2.5x, slot 10 at 5.0x.