Skip to main content

Documentation Index

Fetch the complete documentation index at: https://guide.withvayu.com/llms.txt

Use this file to discover all available pages before exploring further.

The Vayu API enforces rate limits via AWS API Gateway to ensure reliability and fair usage across all customers.

Limits

Value
Rate limit500 requests/second
Burst limit100 requests
Need higher limits? Contact help@withvayu.com to discuss increases.

Handling 429 responses

When you exceed the rate limit, the API returns HTTP 429 with the standard error format:
{
  "type": "rate_limit_error",
  "code": "rate_limit_exceeded",
  "message": "Too many requests"
}
async function withRetry<T>(fn: () => Promise<T>, retries = 3): Promise<T> {
  for (let i = 0; i < retries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.type === 'rate_limit_error' && i < retries - 1) {
        await new Promise(resolve => setTimeout(resolve, 1000));
      } else {
        throw error;
      }
    }
  }
}