Skip to main content

​
Per-Minute Rate Limit

Each API key is limited to 100 requests per minute using a fixed-window counter. The window resets every 60 seconds.

​
Monthly Credits

Every API key has a monthly credit allowance that varies by tier. Use GET /v1/usage (free, 0 credits) to check your real-time consumption and remaining budget.

​
Tiers

TierCredits/MonthUse Case
Free1,000Evaluation, lite dashboard
Analyst1,000Full dashboard, watchlists
Pro+10,000API-first, batch endpoints
Enterprise25,000Dashboard + API + white glove

​
Usage Examples

  • Radar-only dashboard (5-min poll): 1 credit x 288 calls/day = ~8,640/month (Pro)
  • Full radar + signal (5-min poll): 3 credits x 288 calls/day = ~25,920/month (Enterprise)
  • Agent monitoring 20 orgs (3x/day batch): 60 credits x 30 days = 1,800/month (Pro)
  • Agent monitoring 50 orgs (3x/day batch): 150 credits x 30 days = 4,500/month (Pro)

​
Response Headers

Every response includes rate limit and credit headers:
HeaderDescription
X-RateLimit-LimitMaximum requests per window (100)
X-RateLimit-RemainingRequests remaining in the current window
X-Monthly-LimitTotal credits for the billing month
X-Monthly-UsedCredits consumed so far this month
X-Monthly-RemainingCredits remaining this month
X-Request-IdUnique identifier for the request (useful for support)

​
Exceeding Limits

​
Per-Minute Rate Limit

{
  "error": "Rate limit exceeded. Maximum 100 requests per 60 seconds."
}
  • Status: 429 Too Many Requests
  • Check X-RateLimit-Reset header for seconds until the window resets

​
Monthly Credit Limit

{
  "error": "API usage limit reached. Please upgrade your plan or contact support."
}
  • Status: 403 Forbidden
  • Check X-Monthly-Limit and X-Monthly-Used headers for your quota status
  • Credits reset on the 1st of each month (UTC)

​
Best Practices

  • Use the since parameter to poll incrementally instead of re-fetching everything
  • Batch requests where possible (use limit/offset)
  • Check X-RateLimit-Remaining before sending bursts
  • Monitor X-Monthly-Remaining to avoid hitting your credit cap
  • The /v1/usage endpoint is free (0 credits) — use it to track consumption
  • On 429, wait for the X-RateLimit-Reset duration before retrying
  • Implement exponential backoff on non-2xx responses