It's important to know what symbols are supported when making API calls to IEX Cloud. To see the full list of U.S. symbols that IEX Cloud currently supports for "stocks" API calls, you can make an API Call to get the full symbols list from our reference data. The data weight for the reference data call is 100 credits (previously called messages) per call:
This call will return an array of objects, each of which represents a symbol that can be used when making API calls. Here is an example of one of the objects for AAPL:
- symbol: "AAPL",
- exchange: "NAS",
- name: "Apple Inc.",
- date: "2019-05-05",
- type: "cs",
- iexId: "IEX_4D48333344362D52",
- region: "US",
- currency: "USD",
- isEnabled: true
The symbol field is the symbol that should be used when making API calls for prices, company info, and any other call under the "Stocks" section of the API reference.
The exchange lists the code for the symbol's primary listing exchange, in this case "NAS" indicating AAPL is listed on the Nasdaq exchange. You can see the list of US exchanges by making this reference data call. You can see international exchanges by making this reference data call. Both of the exchange reference data calls has a data weight of 1 credit per call.
The type for AAPL is "cs", indicating that it is a common stock. The currently supported issues types are:
AD - ADR
RE - REIT
CE - Closed end fund
SI - Secondary Issue
LP - Limited Partnerships
CS - Common Stock
ET - ETF
WT - Warrant
OEF - Open Ended Fund
CEF - Closed Ended Fund
PS - Preferred Stock)
The region for AAPL is "US" indicating that it is a U.S. based stock. The region property refers to the country code for the symbol using ISO 3166-1 alpha-2 codes.
You can pull up the symbols only for a given exchange or region by using this reference data call.
Reference Data updates at 8 a.m., 9 a.m., 12 p.m., 1 p.m. UTC time every day. We recommend fetching updated reference data from IEX Cloud into your application regularly to stay up to date.
IEX Symbols / Real Time Price For Symbols
To pull just the list of symbols that are traded on IEX, you would use this reference data call.
Symbols traded on IEX have real-time and 15-minute market-wide delayed price data available in the Quote and Intraday Prices endpoints. You can read more about real-time and 15-minute delayed prices here.
Other Reference Data
Reference data call to pull only mutual fund symbols can be found here.
Reference data call to pull only OTC symbols can be found here.
Reference data call to pull supported currency pairs for forex rates can be found here.
Reference data call to pull options can be found here. The options reference data is an object where the keys are symbols and the values are arrays of supported option expiration dates in YYYYMM format.