Rate limits

What are rate limits? Rate limits are the amount of calls you can make within a certain time span. Rate limits are specific to your plan:

  • Free: 1 call / minute
  • Basic: 1 call / second
  • Pro: 10 calls / second
  • Expert: 20 calls / second

Blocks & duration

Calls made are accumulated and rotated by the minute for all plans. This means for the free user, 1 call per minute is allowed. For a pro user, 10 * 60 = 600 calls per minute defines the block limit. If the limits are exceeded, blocks will be enforced with the following durations:

  • Free: 10 minutes
  • Basic: 5 minutes
  • Pro: 3 minutes
  • Expert: 2 minutes

The API will respond with a 429 status code, with the following response (as an example):

{
    "error":{
       "message":"429: You have exceeded your request limit (TAAPI.IO rate-limit)!",
       "maxHitsAllowed":10,
       "maxHitsTimeframe":"1s",
       "blockTime":"180 seconds",
       "reason":"Rate limits exceeded!"
    }
 }

Max calculations per request

There’s an upper limit to how many calculations are allowed per request. This limit is 20, unless you’re on a VPS or an Enterprise plan where other limits are individually agreed.

This max calculation limit includes the total number of calculations in one request, including bulk calculations and multiple backtracks. As an example, consider the following:

  • A single GET request with no backtracks == 1 calculation. Passes
  • A single GET request with backtracks set to 10 == 10 calculations. Passes
  • A bulk request with 5 indicators where each indicator request queries 3 backtracks == 15 calculations. Passes
  • A single GET request with backtracks set to 30 == 30 calculations. Fails
  • A bulk request with 5 indicators where each indicator request queries 10 backtracks == 50 calculations. Fails

The max calculations per request will not result in a block with the above block times. The call will simply be denied.

If you have any questions or comments, please get in touch!