To ensure fair usage and maintain service quality, the Beyond API implements rate limiting on all endpoints.

​
Current Limits

​
Free Tier

  • Limit: 100 requests per 15-minute window
  • Scope: Applied per API key or IP address
  • Reset: Limits automatically reset after the 15-minute window

​
Rate Limit Headers

Rate limit information is included in the response headers: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200
  • X-RateLimit-Limit: Total requests allowed in the window
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: Unix timestamp when the rate limit resets

​
Rate Limit Exceeded

When you exceed the rate limit, you’ll receive a 429 Too Many Requests response: 
{
  "error": {
    "message": "Rate limit exceeded. Please try again later.",
    "code": 429
  }
}

​
Best Practices

  • Implement retry logic with exponential backoff
  • Monitor your usage through rate limit headers
  • Cache responses when possible to reduce API calls
  • Consider request batching for bulk operations

​
Coming Soon

A paid tier with USDC payments is in development, which will offer:
  • Higher rate limits
  • Priority access
  • Additional features