TurbineHub API Rate Limits & Request Guidelines

This document outlines the request limits and best practices for interacting with the TurbineHub API to ensure optimal performance and reliability.

API Rate Limits

To maintain stability and equitable usage, TurbineHub enforces the following rate limits:

API Endpoint Category	Requests per Minute	Requests per Day
Project Data	60	5,000
Financial Data	45	3,500
GIS & Mapping	30	2,500
Risk & Analytics	20	1,500
Market Data	25	2,000
Administrative	15	1,000

All rate limits apply per API key.

Exceeding Rate Limits

When you exceed the above limits, the API returns an HTTP status code 429 Too Many Requests. The response body will include:

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

The retry_after field indicates the number of seconds to wait before making another request.

Best Practices

To efficiently manage your API requests:

• Implement exponential backoff when encountering rate limit errors.

• Cache responses to reduce unnecessary API calls.

• Monitor your request usage to avoid hitting daily caps.

• Contact Support to request higher rate limits for enterprise needs.

Requesting Rate Limit Increases

To request an increased API rate limit, please contact our support team at [e-mail] with:

• Your API key

• Requested rate limits

• Brief justification for the increase

Requests are typically reviewed and processed within 48 hours.