# finddomain

> Zero-auth domain availability, wholesale/retail quotes, and M2M checkout for autonomous agents.
> Prefer the JSON API over HTML. No API key required for lookup.

## Machine docs

- OpenAPI schema: `/openapi.json`
- Agent documentation: `/docs/agent-api.md`
- Human homepage: `/` (do not scrape; use this file and OpenAPI instead)

## Quick start

1. Read `/llms.txt` (this file) and `/openapi.json`
2. Lookup: `GET /v1/domains/{name}` with `Accept: application/json`
3. Quotes expire after **300 seconds**
4. Checkout: `POST /v1/checkout` with `domain`, `quote_id`, `checkout_hash`, `protocol`
5. **Paid purchases require end-user authorization** before completing settlement

## Endpoints

| Method | Path | Purpose |
|--------|------|---------|
| GET | `/v1/domains/{name}` | Availability + wholesale/retail quote + checkout hash |
| POST | `/v1/checkout` | Machine-to-machine domain purchase |
| GET | `/openapi.json` | OpenAPI 3 schema |
| GET | `/docs/agent-api.md` | Full agent documentation |

## Example lookup

```
GET https://finddomain.easedapp.com/v1/domains/orbit.ai
Accept: application/json
```

Response includes `quote.quote_id`, `checkout.checkout_hash`, and supported protocols:
`finddomain.checkout.v1`, `http-signature+json`, `x402`.

## Notes for agents

- Use structured JSON only — do not scrape HTML
- No authentication on lookup
- Quotes valid for 300 seconds
- Obtain user authorization before any paid purchase
- Settlement supports USD and USDC (ethereum, base, solana)
- Retry transient settlement errors with the same `checkout_hash` while the quote is valid