429: rate limits and daily limits

Published by Argorant

What a 429 means on the Argorant API: rate limits and daily limits that scale with your tier, how to back off and resume, and why no request or credit is ever lost.

A 429 means you hit a rate limit or the daily limit for that action. Limits scale with your tier, and the account endpoint tells you exactly where you stand. Requests a minute are per key; searches and counts a minute are shared by the whole account, so a second key does not add more. On a plan, searches and counts have no daily limit; during the trial they have one, higher through an AI assistant.

See your position first

npx argorant whoami

The command shows what you used today against the daily limit, for each action: count requests, preview rows, reveal rows, export rows and verification requests. Accounts without a daily cap are reported as unlimited.

What to do

  1. Back off. An exponential retry with jitter is the right shape, not a tight loop.
  2. Batch instead of iterating. One export of 1,000 rows is one job. A thousand single reveals is a thousand requests.
  3. For verification, send batches of up to 500 addresses per request instead of one call per address.
  4. If you hit a daily limit rather than a burst limit, the fix is time or a higher tier, not retries.
whoami showing today's use against each daily limit
whoami showing today's use against each daily limit

For agents

The CLI exits with code 4 on a 429. Treat that as a scheduling signal: pause the run, report the remaining work, and pick it up later. Anything already created is safe. Exports that were already billed stay downloadable with argorant export download, so a rate limit never costs you a finished job.

Counts and previews are free but still rate limited, because a runaway loop is a runaway loop regardless of price.

Still stuck? support@argorant.com