Rate limits

Synth API enforces rate limits based on your subscription plan.

Limits by Plan

Plan
Requests/Minute
Requests/Day

Professional

20

1,000

Enterprise

Custom

Custom

Response Headers

Every response includes rate limit information:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1738329660

Handling Rate Limits

When you exceed the limit, you'll receive 429 Too Many Requests:

{
  "error": "Rate limit exceeded",
  "message": "Please try again in 42 seconds",
  "retry_after": 42
}

Retry Logic

Best Practices

  • Cache responses — Predictions don't change frequently.

  • Batch requests — Use the limit parameter to get multiple miners.

  • Monitor usage — Check headers on every response.

  • Implement backoff — Use exponential backoff for retries.

Next Steps

  • View pricing

  • Handle errors

Last updated