What are rate limits? Rate limits are the amount of requests you can make within a certain time span. Rate limits are specific to your plan:
- Free: 1 API request / 15 seconds
- Basic: 5 API requests / 15 seconds
- Pro: 30 API requests / 15 seconds
- Expert: 75 requests / 15 seconds
Blocks
The API will respond with a 429 status code, with the following response:
{
"error": "429: You have exceeded your request limit (TAAPI.IO rate-limit)!"
}Max calculations per request
There’s an upper limit to how many calculations are allowed per request. This limit is 20, unless you’re 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, multiple backtracks and number of constructs used. 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
If you have any questions or comments, please get in touch!