Status 429

rate_limited

Too many requests

Why it happens

A limit closed. With no key, the limits are 60 calls an hour and 100 a day from one address, all free callers share a daily ceiling, and the free tier reads one word's market and one ending outside the public set a day. A member key sends at most 10 calls a second, and each paying caller runs at most 200 live checks a day.

What to do

Wait for Retry-After, in seconds. From version 0.2.0, @uniquedomains/sdk retries a short wait for you with createClient({ retry: true }), and throws on one longer than its maxDelayMs. A member key or a paid subscription replaces the free tier's limits.

API status

Example

429 · application/problem+json · Retry-After: 3600

{
  "type": "https://unique.domains/api/problems/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "You reached the free tier's 100 calls a day per address. Retry in 3600 seconds, or use a subscription for more.",
  "instance": "/v1/names/harbor.io",
  "code": "rate_limited"
}