Skip to main content

​
Rate Limit Overview

To ensure fair usage and platform stability, the API enforces rate limits on all requests.

​
Current Limits

PlanRequests per MinuteRequests per Day
Agent AI6010,000

​
Rate Limit Headers

Every API response includes rate limit information in the headers: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1640000000
HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the window resets

​
Rate Limit Exceeded

When you exceed the rate limit, the API returns a 429 Too Many Requests response: 
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please wait before retrying.",
    "retry_after": 45
  }
}
The retry_after field indicates seconds until you can make another request.

​
Best Practices

Use Caching

Cache responses locally to reduce API calls

Implement Backoff

Use exponential backoff when rate limited

Batch Requests

Use pagination efficiently instead of many small requests

Use Webhooks

Subscribe to webhooks for real-time updates instead of polling

​
Exponential Backoff Example

async function fetchWithBackoff(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) {
      return response;
    }

    const retryAfter = response.headers.get('Retry-After') || Math.pow(2, i);
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
  }

  throw new Error('Max retries exceeded');
}

​
Webhook Alternative

For real-time signal notifications, use webhooks instead of polling: 
# Instead of polling every minute
GET /v1/signals?since=...

# Use webhooks for instant notifications
POST /v1/webhooks
{
  "url": "https://your-server.com/signals",
  "events": ["signal.new"]
}
Webhooks don’t count against your rate limit and provide faster notifications than polling.

​
Need Higher Limits?

Contact us if you need higher rate limits for your use case. We can discuss custom plans for high-volume applications.