Rate Limit

The Currents News API enforces rate limits to ensure fair usage and maintain performance. Rate limits define the number of requests you can make within a specific time period. All authenticated endpoints are subject to these limits. Persistent or excessive violations may lead to account suspension.


Rate Limit Headers

Every authenticated API response includes the following HTTP headers to help you track your quota:

  • X-RateLimit-Remaining: Indicates the remaining number of API calls available for your key.
  • X-RateLimit-Limit: Displays the total daily limit of API calls for your key.

These headers enable you to monitor and balance your API usage, preventing throttling and avoiding additional charges for exceeding quotas.


Rate Limit Dashboard

Easily monitor your API usage and remaining calls through the account dashboard. The dashboard provides real-time insights into your daily quota and usage trends.


Best Practices for Managing Rate Limits

  • Space your queries at reasonable intervals to avoid overwhelming the system.
  • Use filters to minimize response sizes and reduce redundant or overlapping requests.
  • Leverage the X-RateLimit-Remaining header to dynamically adjust your call volume.
  • Plan your API usage to align with your daily quota and prioritize essential calls.

By following these recommendations, you can efficiently manage your API interactions and prevent disruptions to your applications.