Errors
Every failure is{ "ok": false, "error": "…" } with a short reason in plain words and a matching HTTP status:
Rate limits
Limits are per address and per endpoint, in one-minute windows. Every response carries the standard headers:429 adds Retry-After. Each endpoint’s limit is on its reference page. Reads are cached at the edge for a few seconds, so two calls in a row can return the same figures; writes are never cached.