Rate limits
- Each token has its own limit per minute: 120 by default, set between 10 and 1,000 when the token is created. Sandbox keys: 60 a minute.
- Every answer carries
X-RateLimit-LimitandX-RateLimit-Remaining. - Over the limit you get
429 rate_limitedwith aRetry-Afterheader (seconds). Wait, then retry — do not hammer. - MCP calls count against the same token limit. Incoming signed actions: 240 a minute per address.
Errors
{"error": {"code": "insufficient_scope", "message": "This token does not have the \"registrations:write\" scope."}}
| Status | Code | Meaning |
|---|---|---|
| 401 | unauthenticated | Missing, unknown, revoked or expired token. |
| 401 | account_inactive | The account that owns the token was switched off. |
| 403 | insufficient_scope | The token lacks the scope this endpoint needs. |
| 403 | ip_not_allowed | The request came from an address outside the token’s allow-list. |
| 404 | not_found | Not found — or not visible to this token (other clients’ events, non-demo events for sandbox keys). |
| 409 | duplicate | The person is already registered (the answer includes registration_id). |
| 422 | — | Validation failed: message + errors per field. |
| 429 | rate_limited | Too many requests. See Retry-After. |
Pagination
Lists take page and per_page (1–100, default 25) and answer {"data": [...], "meta": {"page", "per_page", "total", "last_page"}, "links": {"next", "prev"}}. Follow links.next until it is null.
Dates and money
Dates are ISO 8601 (2026-11-02, 2026-11-02T08:41:00+00:00). Amounts are decimal numbers with a separate three-letter currency.