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

example.py

import time
import requests

def make_request_with_retry(url, headers):
    response = requests.get(url, headers=headers)
    
    if response.status_code == 429:
        retry_after = int(response.headers.get('Retry-After', 60))
        time.sleep(retry_after)
        return make_request_with_retry(url, headers)
    
    return response.json()

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