Rate Limiting

The Gaudio Developers API operates a rate limiting policy to protect the platform and ensure a stable service for all users.
Rate limiting restricts the number of requests that can be sent from an IP address within a specific time window. When requests are made excessively, the system automatically returns a blocking response.

Policy

The rate limit behavior and scope are as follows:

• Basis: IP address
• Allowance: up to 100 requests per minute
• When exceeded:
  • Returns HTTP status code 429 Too Many Requests
  • Blocks further requests from that IP for the next 60 seconds
• Affected endpoints: the entire API under https://restapi.gaudiolab.io/developers/api/~

Response Example:

{
  "error": "too_many_requests",
  "message": "You’ve hit the rate limit. Please wait 60 seconds before retrying."
}

Error Handling

When a 429 response is received, clients are recommended to:

• Detect the 429 status code and retry after waiting at least 60 seconds
• If you have automatic retry logic, apply exponential backoff or a fixed wait time

Avoiding Errors

To avoid hitting the rate limit, consider the following:

• Optimize requests: reduce unnecessary or duplicate requests, and batch requests when possible
• Add spacing between requests: when making consecutive API calls, add a consistent interval to distribute load

The Gaudio Developers API currently uses a Fixed Window algorithm to calculate rate limits.
In other words, the request count resets every 1 minute. Be careful not to exceed the limit within a window.