The Rated API employs a number of safeguards against bursts of incoming traffic to help maximise its stability. Users who send many requests in quick succession may see error responses that show up as status code 429 Too many requests. For Free tier users, Rated allows up to 2 requests per second with a 10,000 Lifetime request safeguard. For paid tiers, rate limit details can be found at our Plans page. Once you get rate limited you can use Retry-After and Age headers to compute how long you need to wait before being able to continue using the API.

​
Handling Rate Limits

When you receive a 429 status code, check the response headers:
  • Retry-After: Number of seconds to wait before making another request
  • Age: How long the current rate limit window has been active

​
Examples

import time
import requests

response = requests.get('https://api.rated.network/v0/eth/network/overview')

if response.status_code == 429:
    retry_after = int(response.headers.get('retry-after', 1))
    print(f"Rate limited. Retry after {retry_after} seconds")
    
    # Wait before retrying
    time.sleep(retry_after)
    # Make your request again
We may reduce limits to prevent abuse, or increase limits to enable high-traffic applications. To request an increased rate limit, please contact us.