Getting Started

Rate Limits

Best practices for using the HypeProxy.io API responsibly.

General Guidelines

To ensure the stability and availability of the API for all users, please follow these guidelines when making requests:

• Avoid rapid successive calls to the same endpoint. Space your requests with reasonable intervals.
• Cache responses when possible. For example, account information doesn't change frequently and doesn't need to be fetched on every request.
• IP rotation requests should be spaced according to your proxy plan's rotation interval. Sending rotation requests faster than your plan allows won't provide any benefit.

Recommended Intervals

Endpoint	Recommended Interval
DirectRenewIp	Depends on your plan (e.g., every 5-10 minutes)
GetResponseTime	Every 30-60 seconds if monitoring
GetExternalIp	After each IP rotation to confirm the change
GetInformations	Once per session or on-demand

Error Handling

If you receive a 429 Too Many Requests response, back off and retry after a short delay. Implement exponential backoff in your automation scripts to handle rate limiting gracefully:

async function fetchWithRetry(url, headers, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, { headers });
    if (response.status !== 429) return response;
    await new Promise(resolve => setTimeout(resolve, Math.pow(2, i) * 1000));
  }
  throw new Error('Max retries exceeded');
}