# finddomain Agent Domain API

Open, zero-auth domain search and M2M purchase network for autonomous agents.

Prefer JSON. Read `/llms.txt` and `/openapi.json` before calling the API. Do not scrape the HTML homepage.

## 1. Lookup availability

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

Returns:

- `available` / `status`
- `quote` with wholesale, retail, `quote_id`, TTL (300 seconds)
- `checkout.checkout_hash`
- `checkout.protocols` (`finddomain.checkout.v1`, `http-signature+json`, `x402`)
- settlement currencies and networks

## 2. Checkout

Paid purchases require end-user authorization before completing settlement.

```http
POST /v1/checkout
Content-Type: application/json
Accept: application/json

{
  "domain": "orbit.ai",
  "quote_id": "<quote.quote_id>",
  "checkout_hash": "<checkout.checkout_hash>",
  "protocol": "finddomain.checkout.v1"
}
```

On success the domain is held and settled. On transient provider errors, retry with the same `checkout_hash` before quote expiry.

## Discovery

| Resource | Path |
|----------|------|
| Agent manifest | `/llms.txt` |
| OpenAPI | `/openapi.json` |
| Homepage | `/` |
| robots | `/robots.txt` |
| sitemap | `/sitemap.xml` |

No API key for lookup. Prefer JSON over HTML.