CUPS (Rate Limit)

Explanation of Compute Unit Per Second (CUPS), and how MegaNode uses it as rate limit

Why Rate Limit?

MegaNode enabled rate limits to ensure customers utilize our service fairly, in order to provide a more stable and sustainable service. The rate limits will be implemented based on each second, that means in most cases, as long as you've handled retries when receiving rate limits error, the requests will go through in the following second, and it will not affect your experience.

We use CUPS to measure and implement the rate limit, and provide different CUPS for different tiers of MegaNode users.

What is CUPS?

Compute Unit Per Second (CUPS) is a measure of the number of Compute Units (CUs) used per second when making requests. The weight of each RPC method is different, it will be more efficient than just calculating the number of requests sent in a second in different use cases.

See below the CUPS for different tiers of users

Tier of usersCUPS
Free300
Growth700
Team1500
Business3000

If your account reached the CUPS capacity, you will see the below error msg in the API response. You will need to enable retries to send the requests again. If you need higher rate limit, please upgrade to Growth or Enterprise tier.

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32005,
        "message": "Your account has exceeded its Compute Units Per Second capacity. Please check out https://docs.nodereal.io/docs/cups-rate-limit and upgrade to Growth or Enterprise tier for higher rate limit."
    }
}

What’s Next