API docs / How it works

Rate limits and alerts

How many requests a key can make, and how admins find out when a key's requests keep failing.

Rate limits

Each key can make 120 requests a minute, counted in fixed one-minute windows. Over that, requests get a 429 with a Retry-After header giving the number of seconds to wait.

Separately, an address that sends more than 60 requests with rejected keys in a minute gets a 429 before its key is checked. If several tools share one outgoing address, a misconfigured one can slow the others down, so fix rejected keys quickly.

For bulk changes and backfills, use Create or update in a batch, which takes up to 100 contributions in one request.

When a key’s requests keep failing

Equity Matrix keeps track of requests it rejects for each key. That covers a revoked key that’s still being used, an inactive plan, validation errors and rate limits.

  • On the API Keys page, each active key shows its most recent error and when it happened. Revoked keys aren’t listed, so for a revoked key that’s still in use, the email is how you find out.
  • By email, after 5 rejected requests in a row, every active admin of the organization gets an email naming the key and the problem. It’s sent at most once a day per key, and stops once a request with that key succeeds. For a revoked key that’s still in use, admins get one email.

A single rejected request between successful ones won’t send an email, but it will show as the key’s last error.