# StableDomains API
> Domain registration via x402 micropayments. No accounts. Pay USDC on Base.

## Base URL
https://stabledomains.dev

## Authentication
- x402: HTTP 402 micropayment protocol. Send request, receive 402 with payment details, pay USDC on Base, resend.
- SIWX: Sign-In with X (wallet signature). Required for managing domains you own.

## Endpoints

### POST /api/check
Check domain availability and get pricing. Costs $0.01-$0.05 depending on TLD. Auth: x402.
Request body: { "domain": "example.com" }
Response: { "available": true, "domain": "example.com", "tld": "com", "priceUsd": 20, "renewalPriceUsd": 20, "multiplier": "1.0x", "slotsRemaining": 8 }

### POST /api/register
Register a domain. Costs $20-$150 depending on TLD (bonding curve applies). Auth: x402.
Request body: { "domain": "example.com" }
Response: { "jobId": "job-abc123", "domain": "example.com", "status": "pending" }
Registration is async — poll /api/job/status to track progress.

### POST /api/domain/renew
Renew a domain for another year. Costs $20-$150 depending on TLD. Auth: x402.
Request body: { "domain": "example.com" }

### GET /api/domain/status
Check domain registration status and details. Free. Auth: SIWX.
Query: ?domain=example.com

### POST /api/domain/dns
Manage DNS records for your domain. Free. Auth: SIWX.
Request body: { "domain": "example.com", "action": "upsert", "records": [...] }

### POST /api/domain/transfer-out
Initiate transfer to another registrar. Free. Auth: SIWX.
Request body: { "domain": "example.com" }

### GET /api/job/status
Poll registration job progress. Free. Auth: SIWX.
Query: ?jobId=job-abc123

## Supported TLDs and Base Pricing
- .com: $20 registration, $20 renewal, $0.01 check
- .org: $20 registration, $20 renewal, $0.01 check
- .net: $20 registration, $20 renewal, $0.01 check
- .info: $20 registration, $20 renewal, $0.01 check
- .biz: $20 registration, $20 renewal, $0.01 check
- .xyz: $20 registration, $20 renewal, $0.05 check
- .dev: $25 registration, $25 renewal, $0.05 check
- .app: $25 registration, $25 renewal, $0.05 check
- .io: $85 registration, $85 renewal, $0.05 check
- .ai: $150 registration, $150 renewal, $0.05 check

## Bonding Curve
Registration prices increase as daily slots fill (max 10/day):
- Slots 1-5: 1.0x (base price)
- Slots 6-7: 1.5x
- Slots 8-9: 2.5x
- Slot 10: 5.0x

## Discovery
- x402 resource discovery: /.well-known/x402
- OpenAPI spec: /openapi.json