API Documentation | Intrinio

API Documentation

Limits

Limits

The Intrinio API employs several reasonable limits to ensure that stable, reliable service is provided to all users. These limits can vary based on the type of API request you are making. If you hit an API limit, the response will contain a 429 code and an explanation of the limit.

Daily Request Limits

Most data feed subscriptions have limited daily usage. This means that you can make up to a certain number of API requests in a 24-hour period (resetting at midnight Eastern). To view the limits for a data feed subscription, go to your Account page, click on Subscriptions, click on the subscription in question, and click on Limits.

Per-Minute Request Limits

Some data feed subscriptions have limited usage per x minutes. This means that you can make up to a certain number of API requests in x minutes. Common timeframes are 10 minutes and 1 minute.

Per-Second Request Limits

Certain high-workload API request are limited by the second. This means that you can make up to a certain number of API requests per second.

Paging Limits

API endpoints that return a list of data often employ paging to allow users to retrieve the rest of the data. Below are the default and maximum page sizes for various endpoints:

Endpoint Default Page Size Maximum Page Size
historical_data 1,000 10,000
All others 100 10,000

Certain requests are considered "high-paging" and are subject to additional limits:

  • Requests with a page size that is higher than the Default Page Size
  • Requests with a page offset greater than or equal to the Maximum Page Size

These request are limited by:

User Type High-Paging Request Limit
Free 1 per minute
Paid 1 per second
Custom Contact Sales

Bulk Request Limits

Certain API endpoints allow you to make "bulk" requests that return all of the available data. These requests are limited by:

User Type Bulk Request Limit
Free 1 per minute
Paid 1 per second
Custom Contact Sales

Throttle Limits

Users enjoying free data feed subscriptions only are limited to 100 requests per second.

Timeout Limits

Each request must be fulfilled within 25 seconds, otherwise it will be dropped with a 503 error. Given the flexibility of our endpoints and the complexity of potential API requests, we leave it to the users to fashion requests which can be satisfied in a