Legacy Plan Credits and Pricing#
Important
Here is information on credits and pricing for IEX Cloud legacy plans. For credits and pricing on current plans, see Credits and Pricing.
Legacy Individual Plans and Business Plans#
Included with Individual plans ($9 per month with an annual subscription, or $19 per month with a monthly subscription):
Five million credits (or messages) per month.
One API token.
One user login.
Additional features, such as free access to Cloud Cache.
Both commercial and personal use.
Included with Business plans ($199 per month with an annual subscription, or $299 per month with a monthly subscription):
150 million credits (or messages) per month.
Four API tokens.
Four user logins.
Full feature access – everything included with Individual plus more. More detail coming soon.
Both commercial and personal use.
Both plans provide the following:
Credits (previously called messages): Use credits to make more API calls and request more data from IEX Cloud.
Tokens: Tokens connect your project or application to your account. You can track, control, and throttle data usage by token. Examples of when you’ll use multiple tokens include using IEX Cloud to support multiple applications, projects, teams, or user accounts. For instance, if you support three applications, you would likely use a different token for each app.
User logins: Adding user logins to your plan adds room for more teammates to join your IEX Cloud account and use its data.
If you need to add more credits, API tokens, or user logins to your account, you can upgrade your plan or add packages.
Credits in Legacy Plans#
Credits are the fundamental units used to access data and make API calls on IEX Cloud legacy plans. Each API endpoint has a certain “data weight,” or a given number of credits that are used every time you make an API call with that endpoint.
For example, the Earnings endpoint has a data weight of 1,000 credits per symbol per period. This means you would use 1,000 credits to see a company’s earnings for one specific quarter.
Credits make your legacy subscription with IEX Cloud flexible and adjustable to your use case. You may use a higher volume of lower-weighted endpoints, fewer higher-weighted endpoints, or a combination. Note that certain endpoints are only available with paid legacy plans on IEX Cloud.
The IEX Cloud Console Credits → Credit Use tab automatically keeps track of how many credits you have used so far in the month. Check out our legacy API documentation to see the data weights for different endpoints on IEX Cloud.
Why do different API endpoints use different numbers of credits?#
Data weights are determined by a number of factors, including agreements between IEX Cloud and our third-party data providers, the cost of sourcing the data further upstream, and other computational costs.
Rather than requiring customers to pay for a preset selection of data in bulk, credits give you the flexibility to choose exactly the data you want to use with your subscription and how often you want to use it. IEX Cloud serves a diverse range of use cases and is designed to make data accessible for everyone.
How many credits do I need, and which plan should I choose?#
Each IEX Cloud legacy plan provides a different monthly allocation of credits, tokens for connecting your applications to your account, and user logins. The different plans also come with a designated set of tools and available datasets, which you can see on our pricing page.
You can choose your plan based on your use case:
The legacy Individual plan: This plan is ideal for personal use, projects, students, building basic applications, testing, freelancers, and light use.
The legacy Business plan: This plan allows for more scale and flexibility for growing technology companies and larger enterprises. With more credits, tokens, and user logins, it’s built to help growing businesses scale, bring flexibility to how firms build and make it easier to integrate IEX Cloud into your team’s workflow.
In addition to choosing your base plan, you can also further customize it by adding legacy packages. Packages add credits for more data usage, tokens for connecting more apps to your account, and user logins.
To help choose your plan and how many packages you need, it can be helpful to estimate how many credits you’ll need on a monthly basis. Once you know what data you would like to use on IEX Cloud, you can estimate your monthly credit usage by referencing those endpoints’ data weights in our documentation and multiplying that weighting by how frequently you will request this data.
Our calculator here can help assist with a rough estimation. Alternatively, use the following formula as a guideline:
Data Weight x Number of Symbols x Frequency = Credit Use for that API Endpoint
For example, let’s say you were looking to see the last three quarters’ earnings for a list of 5,000 companies. The Earnings endpoint uses 1,000 credits per symbol per period.
Your credit usage for that endpoint would be:
(1,000 credits) x (5,000 symbols) x (3 periods) x (1 call per symbol) = 15,000,000 credits
Core legacy credits vs. Pay-as-you-go Credits (For legacy Launch, Grow, and Scale plans only)#
On our legacy plans, each IEX Cloud plan provides a different number of monthly core credits, as well as different pay-as-you-go credits.
Core credits represent the base number of credits included with your subscription each month. Core credits can be used towards any of the Core Data endpoints included with your plan. Your core credit usage is reset at the beginning of each calendar month.
Pay-as-you-go credits can be used in addition to your core credits as needed and are priced at a discounted rate. After you’ve used your core credits for a given month, you can use pay-as-you-go credits to continue accessing as much data as you need. With legacy Launch, Grow, and Scale plans, pay-as-you-go credits can also be used to access Premium Data — specialized datasets that can be added onto your subscription.
It’s recommended that you enable the automatic use of pay-as-you-go credits in the IEX Cloud Console. This setting helps prevent disruption in your service and allows IEX Cloud to default over to using pay-as-you-go credits after you have used all of your core credits for the month.
If you do not have the automatic use of pay-as-you-go credits enabled, IEX Cloud will pause access to data after you have used all of your core credits and will restore access at the beginning of the next month.
Best practices for legacy credits#
Make the most of your credits by checking out these IEX Cloud features:
Cloud Cache – automatically enabled with Individual and Business plans: More efficiently use your credits by storing and reusing the data that you’ve already requested from IEX Cloud. Let us handle the work for you with Cloud Cache. Cloud Cache is automatically included with Individual and Business plans. Learn more.
Packages (for Individual and Business plans only): If you need more credits with your Individual and Business plans, you can simply add packages. Learn more about packages.
Pay-as-you-go credits (for legacy Launch, Grow, and Scale plans only): Enable pay-as-you-go credits in the IEX Cloud Console. This ensures that you can continue to access data without interruption if you use all the core credits allocated with your subscription for the month.
Legacy Packages#
Packages make it easier to customize your IEX Cloud plan according to your use case so that your plan scales with you as you grow. You can add packages as you need them throughout your legacy plan term.
Add packages to your plan to receive more of the following:
Credits (previously called messages) – Included in packages for both legacy Individual and legacy Business plans: Use credits to make more API calls and request more data from IEX Cloud.
Tokens – Included in packages for Business plans: Tokens connect your project or application to your account. You can track, control, and throttle data usage by the token. Examples of when you’ll use multiple tokens include using IEX Cloud to support multiple applications, projects, teams, or user accounts. For instance, if you support three applications, you would likely use a different token for each app. Learn more about tokens.
User logins – Included in packages for legaycy Business plans: The number of user logins on your plan refers to the number of seats you have for teammates to log into your IEX Cloud account. Adding user logins to your plan adds room for more people to join your IEX Cloud account and use its data.
You can both add and remove packages from your legacy plan as you need. Once you add a package, by default it will be added to your plan for each subsequent month. If you remove a package from your plan, it expires at the end of the current month. Packages can be removed or added month to month for both monthly and annual plans.
Packages cannot be added to free legacy Start plans or to legacy Launch, Grow, and Scale plans. To use packages, you must have the legacy Individual plan or legacy Business plan.
What is included with each package?#
Packages are different depending on your paid plan, and can only be added to legacy Individual plans or legacy Business plans.
Legacy Individual plan ($10 per month per package - for both monthly and annual plans) – each package includes every package adds:
10 million credits to your account.
Legacy Business plan ($30 per month per package - for both monthly and annual plans) – every package adds:
30 million credits.
One token.
One user login – or additional login for a teammate on your IEX Cloud account.
How do I add more packages to my legacy plan, and when should I add them?#
How many packages you need depends on how many credits, tokens, or seats for users you need. You can always add more packages to your plan as you go, or purchase multiple packages up front.
To add packages, go to Account → Manage Plan in the lower-left corner of the Console. You might add more packages if:
You need additional credits. With the new pricing plans, we replaced pay-as-you-go overages with packages. If you approach your plan’s credit (or message) limits, you can either upgrade your plan or purchase additional packages. We will notify you via email when you reach your credit limits with instructions on how to add packages to your plan.
You need more tokens added to your account. Depending on your use case, you may need additional tokens for your account. For instance, if you have multiple teams or applications, you will likely need multiple tokens for each of those teams or apps.
You need to add more user logins to your account. Maybe you’re expanding your team, or a new team at your business wants to join your IEX Cloud account to start a new project.
To see your current credit and plan usage, log into the IEX Cloud Console and go to Credits → Credit Use.
Packages are only available with the legacy Individual and Business plans, and cannot be added to legacy Launch, Grow, or Scale plans. If you already have a paid Launch, Grow, or Scale plan.
How do overages work with the new plans?#
IEX Cloud users on legacy Launch, Grow, or Scale plans will be familiar with the concept of pay-as-you-go messages (now pay-as-you-go credits). Instead of paying overages this way at the end of each month using pay-as-you-go credits, to use additional credits with these pricing plans, you’ll purchase packages.
We replaced overages with packages based on user feedback, with the goal of providing a simpler, more transparent way of scaling your plan with your usage.
If you reach your plan’s monthly credit limits, we will notify you via email with instructions on how to add packages to your plan. To prevent disruption, we suggest periodically checking your credit usage in the Console as well as purchasing packages in advance if you anticipate needing to use additional credits. When you reach your monthly credit limit, access to data will be temporarily paused until more credits are added to your plan or the next month begins.
How are packages billed?#
For both monthly and annual plans, packages are billed immediately upon purchase for the current month. They are then billed on the 1st** of each subsequent month. For instance, let’s say you purchase a package with your annual Business plan on the 16th. You’ll pay $30 upon purchase, and then $30 on the 1st of each subsequent month. If you remove your package in the middle of a month, you’ll have it for the remainder of the month, after which it expires and you’ll no longer be charged for that package.
** IEX Cloud billing utilizes Universal Time Coordinated (UTC). Renewals will occur at 00:00 UTC (08:00 PM EST).
Caching Data in Legacy Plans#
Setting up your own caching#
Legacy Individual and legacy Business plan users, as well as legacy Launch, Grow, and Scale subscribers are permitted to cache data on their own servers and can then display data from the cache to their users for commercial use.
Please note that you cannot provide IEX Cloud data via your own API to users or provide a mechanism for mass downloads, including a CSV download. Read more about acceptable usage of the platform in our Terms of Service.
Cloud Cache#
Cloud Cache is IEX Cloud’s fully managed data storage infrastructure. It saves you credits by automatically storing the data that you’ve already queried from IEX Cloud. When you request that data again, you’ll only use one credit rather than the full data weight, so that you don’t pay for the same data twice.
Note that any data stored by Cloud Cache is “reset” at the start of each calendar month. This is so we can keep our data storage as high-performant as possible.
Cloud Cache is automatically enabled for all legacy Individual plan and legacy Business plan users – no setup or additional costs required.
See also
One Additional Credit Used Per API Call#
Starting July 15, 2021, each API call uses one additional credit on top of the endpoint’s data weight.
For instance, if the data weight for an endpoint is 100 credits per request, each API call would use a total of 101 credits. Or if you’re using free real-time stock prices from IEX, you would use a total of one credit per API call.
If you’re streaming data, you would use one additional credit per connection.
This applies to all production API calls (API calls not made in our Sandbox environment).
Why is one extra credit used per API call?#
This one-credit covers our operational costs for delivering data and enables us to keep the costs lower across dozens of endpoints. This also allows us to continue investing in scalable infrastructure.
For most users, this adds minimal cost – a few cents to a few dollars per month in usage. For instance, if you make one million API calls per month, this update would add roughly $1 per month in credit usage.
What about sandbox API calls?#
Attention
The Sandbox environment is deprecated
Sandbox API calls are free and unlimited and do not use any of your monthly credit allocations.
Sandbox API calls can also be used to help show how many credits would be used if that same API call were performed in the production. You’ll see this one credit reflected in “sandbox data weight” that’s returned in the API request’s response header to help you accurately estimate how many credits you would use.
How does this work with Cloud Cache?#
Cloud Cache keeps track of the API calls you’ve already made, so if you make the same request twice, you only pay a data weight of one credit rather than the full data weight.
This one credit is added on top of the one-credit data weight provided by Cloud Cache. So if Cloud Cache returned data to you for one credit, you would use two credits total.