FAQs#
Here are some frequently asked questions (FAQs) about IEX Cloud.
Account, Billing, and Pricing#
How can I make changes to my plan?
You can request upgrading, downgrading, or cancelling your subscription at any time on your Manage Plan page.
When do plan upgrades take affect?
When you upgrade your plan, the new subscription goes into effect immediately.
How many tokens do I need?
You may want to use separate tokens to track, control, and throttle usage by different projects, apps, or end users. Here are a couple examples for using multiple tokens:
you have multiple applications or projects that use IEX Cloud.
your business has multiple teams that share your IEX Cloud account.
See also
What are "allowed domains" for a token?
You may restrict a token to certain domains and IP addresses. Leaving a token’s Allowed Domains field blank allows requests to use the token from anywhere. If you specify domains and/or IP addresses in the token’s Allowed Domains field, requests that use the token must have an HTTP header referer value that matches one of the Allowed Domains values.
Why are there credits used for the STORAGE_ON_DISK endpoint?
Storage credit usage is based on your plan’s Storage Amount and is calculated and reported hourly as the STORAGE_ON_DISK endpoint’s Credits Used (see the Credit Use by Endpoint section at Credits → Credit Use → Core Use).
Hourly Storage Credit Cost = Storage Amount * (1 / # hours in the month) * Credit Rate
When do plan downgrades take affect?
We don’t provide prorated refunds for downgrades or cancellations. If you downgrade or cancel, you remain on your higher-tier subscription through the end of your current term. You can see your current term’s next renewal date in the console’s Billing section. On your next renewal date, you are automatically placed on your downgraded subscription.
How do prorated credits work?
While IEX Cloud monthly subscriptions renew at the start of every calendar month, you can sign up for a paid plan or upgrade at any time. When you upgrade or sign up for a monthly paid plan in the middle of a calendar month, the total cost of your first invoice is prorated.
Correspondingly, for the rest of your first calendar month, your plan will also include a prorated number of credits based on when you signed up in the month.
“prorated_messages” on the Credit Use Page
Note that we recently updated the term messages to credits. They mean the same thing – we just updated the terminology to make their usage and definition clearer. You may notice the term prorated_messages in your Console, which is the same thing as prorated credits.
In the IEX Cloud Console, navigate to Credits → Credit Use. Beneath Credit Use by Endpoint, notice the label prorated_messages. prorated_messages shows you the difference between your regular credit allocation and your prorated credit allocation.
For example, if you sign up on September 15, you will only be invoiced for about half of the standard subscription amount and receive half the number of credits allocated for that subscription plan on a monthly basis. Normal billing and credit allocations will resume at the start of the following month.
Note that annual plans are not prorated. The annual term begins on the day you sign up and ends a full year later. For instance, if you signed up on January 15, 2022, your plan will renew on January 15, 2023.
I have a legacy plan; do I have to change anything?
If you don’t want to use any of the new Apperate features, you can continue using IEX Cloud as you do today. You don’t need to make any changes.
Data#
What do the "Ignore matches" and "Replace matches" options mean when loading or updating data?
When you update data or ingest more data into a dataset, you must decide how to handle incoming records that match (have the same unique index as) an existing record).
Apperate gives you two options:
Ignore matches: Skip ingesting the new record. (Default)
Replace matches: Overwrite the existing record with the new record.
The duplicateKeyHandling=true parameter setting for the POST /record and POST /data endpoints specifies to replace matching existing records; duplicateKeyHandling=false specifies to ignore incoming matching records.
Why are no rows returned when I SQL JOIN with QUOTE and other real-time datasets?
Real-time datasets, such as CORE.QUOTE, do not support SQL queries. SQL JOINs with real-time datasets are not supported.
Why can't I SELECT * on a view?
Apperate does not support SELECT * queries on views.
Why does Apperate report "cannot select by 'columnXYZ' (00ED50F1BF0332)" even though the column is valid?
You can only select on indexed properties (columns). A property must be a primary, secondary, or date index (See Unique Index components) to query on it via SQL WHERE clauses, SQL JOIN ON clauses, or via the data query endpoint key/subkey path parameters.
How do I get data on the S&P 500, Dow Jones Industrial Average, or other major stock indices?
Data on major stock indices is not currently available on IEX Cloud
Data on the S&P 500, Dow Jones Industrial Average, and other major stock indices is not currently available on IEX Cloud and is unlikely to be in the near future.
Pricing for this data is typically high and requires a direct contract between each consumer and the index provider regardless of who actually supplies the data. For instance, the major index providers charge over $10,000 a year for delayed data.
An alternative is to display ETFs that match those indices, such as SPY for the S&P 500, DIA for Dow Jones, and IWM for Russell 2000.
How do I grant API access to only specific domains?
Please see Restricting Data Access to Specific Domains.
How do I get Nasdaq-listed stock data (UTP/OTC Data) on IEX Cloud?
Please see Get Nasdaq-listed UTP/OTC Stock Data.
How do I stream in data?
Please see Stream Data Using SSE.
General#
Can I redisplay/ redistribute the data I receive from IEX Cloud?
In general, displaying IEX Cloud data is permitted with attribution. The following are some restrictions on the use of IEX Cloud data:
Users on the Start or Free plan are only permitted to use data from IEX Cloud for personal, non-commercial use. You can still display data to other individuals/users, but you may not include our data in any commercial application. Paid plan users can use IEX Cloud data for commercial use, including displaying publicly to users.
No user may provide IEX Cloud data via their own API to users, or provide a mechanism for mass downloads, for example as a CSV. For more information please see our terms of service.
Attribution is required for all users. If a customer distributes IEX Cloud Data, they must state that the data was provided by IEX Cloud and provide a hyperlink to https://iexcloud.io.
For more information, please see the Acceptable Use Policy within our Terms.