Rate Limits & Quotas
- API key cap: up to
api_keys.max_keys_per_orgkeys per organization (default 10). Past that,429 api_key.limit_reached. - Idempotency cache: 24 hours per
(api_key_id, idempotency_key)pair. - Confirm concurrency: confirm endpoints are concurrency-limited at 10 per service instance — bursts above that briefly queue or shed (
503with retry). - Freemium testnet quota: small organizations on testnet may have a per-period limit on registrations to prevent abuse. The cap is enforced at
confirmtime and surfaces as429 common.quota_exceededwithdetails.resets_at. Mainnet has no freemium quota — every transaction is paid in credits. - Per-network credit balance: every confirm pre-debits the price quoted at prepare. If the org’s balance is insufficient, confirm fails with
403 common.forbidden. Top up via the Billing dashboard.