Rate Limits

​

Current Limits

​

Rate Limit Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1704067200

​

Handling Rate Limits

​

When You Hit the Limit

{
  "detail": "Rate limit exceeded. Retry after 60 seconds."
}

​

Implementing Exponential Backoff

import requests
import time

def api_request_with_retry(method, url, max_retries=5, **kwargs):
    for attempt in range(max_retries):
        response = requests.request(method, url, **kwargs)
        
        if response.status_code != 429:
            return response
        
        wait_time = 2 ** attempt  # 1s, 2s, 4s, 8s, 16s
        time.sleep(wait_time)
    
    return response

async function apiRequestWithRetry(url, options = {}, maxRetries = 5) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    const response = await fetch(url, options);
    
    if (response.status !== 429) {
      return response;
    }
    
    const waitTime = 2 ** attempt;
    await new Promise(resolve => setTimeout(resolve, waitTime * 1000));
  }
  
  throw new Error('Max retries exceeded');
}

​

Best Practices

1. Batch operations — Space out your requests when processing multiple items
2. Cache responses — Don’t repeatedly poll the same endpoint. Cache for 5+ minutes.
3. Use webhooks — For real-time updates, configure webhooks instead of polling
4. Check remaining requests — Monitor X-RateLimit-Remaining headers before bulk operations

​

Contacting Support

• Your account ID
• Expected request volume
• Detailed use case description