Rate Limits

📘

Note:

At present, the total number of requests per Account per day is 100,000 (the total number of requests will be adjusted according to related needs later).

Currently, Trongrid rate limiting will be triggered in the following two situations:

  1. When a user’s usage exceeds the total amount allowed per day, only a very low frequency such as 1/s will be allowed, and access beyond this limit will be denied.
  2. When a user’s usage is below the total amount allowed per day, the frequency will be limited to 15/s. Access beyond this limit will be denied and there will be a penalty mechanism of not responding to service within 30s.

How to tell whether I’m rate-limited?

If you are subject to rate limiting, your request will return with an HTTP status code “4xx” and an error message. You can adjust according to the error message received.

{
     "Success": false,
     "Error": "The key exceeds the frequency limit(15), and the query server is suspended for 30s",
     "StatusCode": 403
}
{
     "Error": "The key exceeds the frequency limit(15), and the query server is suspended for 30s"
}

What should I do if I’m rate-limited?

If you continue to be rate-limited, try these work-arounds:

  • Make sure you have the API Key in the URL. Requests without API Key will be subject to strict rate limiting or even complete rejection.
  • Limit the number of requests when launching the Dapp.
  • Don't use polling for Trongrid very often, the TRON network produces a block around every 3s, and thus it usually doesn’t make sense to request new data at a faster speed.