Use IEX Cloud Financial Data#

IEX Cloud comes with 5+ terabytes of built-in, curated financial data to power fintech applications and more. The latest financial data is available in real-time, at 15 minute delay, and intraday. There’s also historical time-series financial data.

Here you’ll get an overview IEX Cloud Data features.

Note

Your Free Trial gives you temporary access to all the Data Bundles.

Browsing Data Bundles#

IEX Cloud Data Bundles give you access to specific REST endpoints. Some Data Bundles include data streams (data streams require a Grow plan or Enterprise plan).

Here are the Data Bundle categories:

You can purchase the bundles from the Data Bundles console page. The image below shows the console’s Data Bundles page.

To learn more about the Data Bundles and their endpoints, visit the Data Bundles overview or click any of the category links above.

Exploring Data Endpoints#

The API Docs describe all the IEX Cloud financial data REST endpoints.

Each reference page includes this information:

  • Example request URLs

  • Methods

  • Path parameters

  • Query parameters

  • Response attributes

Most endpoint reference pages include a live request/response widget. The following image shows the Stock Quote endpoint’s live HTTP request and response widget available to view publicly in the API Docs.

The Example HTTP Requests section lists example requests you can execute, once you’ve registered for your Free Trial and applied your API token to your API Docs session. The following image highlights the Historical Equity Prices endpoint’s example requests.

As you explore the data endpoints and find data that fits your needs, you can buy the corresponding Data Bundles in the Console.

One Data Method–Endless Possibilities#

The GET /data method can be used to query most IEX Cloud Data; it’s fast and easy to use.

All the GET /data endpoints take a key path parameter to filter on the data you want. Additionally, some endpoints include an optional subkey path parameter for fine-tuning results.

The following image highlights the Dividends endpoint’s key and subkey path parameters.

See Query IEX Cloud Financial Data to start querying data with GET /data!

Filtering on Date / Time Ranges#

IEX Cloud’s historical data is stored in time series. Range parameters enable you to time-window the data you want.

For example, the HTTP request below returns Ford news articles on March 1st 2023.

Request:

https://api.iex.cloud/v1/data/CORE/NEWS/f?from=2023-03-01&to=2023-03-02&token=YOUR_API_TOKEN

Response:

[
  {
    "datetime": 1677683309000,
    "hasPaywall": false,
    "headline": "US post office buys 9,250 electric vans, 14,000 charge stations",
    "image": "https://cloud.iexapis.com/v1/news/image/2US9v5KvD2aRkqSqZgI0PGhIt9yRzse1boRqCSzLidFt",
    "imageUrl": "https://supplypro.s3.ca-central-1.amazonaws.com/wp-content/uploads/2022/02/04103603/US-postal-service.jpg",
    "lang": "en",
    "provider": "CityFalcon",
    "qmUrl": "https://www.supplypro.ca/us-post-office-buys-9250-electric-vans-14000-charge-stations/",
    "related": "2FI-GD,F,STLA",
    "source": "Supply Professional magazine",
    "summary": "WASHINGTON (AP) — The US Postal Service is buying 9,250 Ford Motor Co. electric vans and 14,000 charging stations as part of a move to switch its fleet to electric vehicles. The service also is buying another 9,250 internal combustion vans from Fiat Chrysler in North America, now part of Amsterdam-based Stellantis. The Fiat Chrysler […] The post US post office buys 9,250 electric vans, 14,000 charge stations appeared first on Supply Professional .",
    "symbol": "F",
    "url": "https://cloud.iexapis.com/v1/news/article/2US9v5KvD2aRkqSqZgI0PGhIt9yRzse1boRqCSzLidFt",
    "uuid": "2US9v5KvD2aRkqSqZgI0PGhIt9yRzse1boRqCSzLidFt",
    "id": "NEWS",
    "key": "F",
    "subkey": "2US9v5KvD2aRkqSqZgI0PGhIt9yRzse1boRqCSzLidFt",
    "date": 1677683309000,
    "updated": 1677686924000
  },
  {
    "datetime": 1677669006000,
    "hasPaywall": false,
    "headline": "Tesla''s ''2016-2018'' Woes Vs. Rivian''s Current Challenges: Munster Highlights 1 Key Difference",
    "image": "https://cloud.iexapis.com/v1/news/image/11wmNdGowCeuHLxYMaNghjh0oMybiVUFQYxLxhagI5p7",
    "imageUrl": "https://cdn.benzinga.com/files/imagecache/1456x800/images/story/2023/03/01/tesla_photo_by_hadrian_on_shutterstock.jpg",
    "lang": "en",
    "provider": "CityFalcon",
    "qmUrl": "https://www.benzinga.com/analyst-ratings/analyst-color/23/03/31113421/teslas-2016-2018-woes-vs-rivians-current-challenges-munster-highlights-1-key-differ",
    "related": "F,TSLA,TL0-GD,TL0-GS,TL0-GH,TL0-GM,TL0-GF,TL0-GB,TL0-GY,TL0-GI,RIVN,LCID,NVDA,NVD-GD,NVD-GS,NVD-GH,NVD-GM,NVD-GF,NVD-GB,NVD-GY,NVD-GI",
    "source": "Benzinga",
    "summary": "Electric vehicle startup Rivian Automotive Inc. (NASDAQ: NVDA ) reported on Tuesday its fourth-quarter revenue that missed expectations and also issued underwhelming 2023 production guidance. What Happened: Rivian joined Ford Motor Co. (NYSE: F ) with the recent “EV production troubles,” Deepwater Asset Management co-founder Gene Munster tweeted following a review of the earnings report. He noted that the company blamed the supply chain for the soft production guidance. See Also: Best Electric Vehicle Stocks Lucid Group Inc. ''s (NASDAQ: LCID ) issue, however, has to do with demand, Munster said. The fund manager recalled Musk’s acknowledgment of a “production hell” in 2016 and said many were bracing for the other EV startups to experience the same challenges. “The difference is in 2016-2018 … Full story available on Benzinga.com",
    "symbol": "F",
    "url": "https://cloud.iexapis.com/v1/news/article/11wmNdGowCeuHLxYMaNghjh0oMybiVUFQYxLxhagI5p7",
    "uuid": "11wmNdGowCeuHLxYMaNghjh0oMybiVUFQYxLxhagI5p7",
    "id": "NEWS",
    "key": "F",
    "subkey": "11wmNdGowCeuHLxYMaNghjh0oMybiVUFQYxLxhagI5p7",
    "date": 1677669006000,
    "updated": 1677672620000
  }
]

See Query IEX Cloud Financial Time Series Data to start querying time-series data.

Batching Data Requests#

The GET /data method’s batching capabilities enable you to use a single request to query on multiple symbols in multiple datasets.

For example, the following request returns the latest stock price, fundamentals, and news for mobile carriers AT&T, T-Mobile, and Verizon.

Request:

GET /data/CORE/QUOTE,FUNDAMENTALS,NEWS/T,TMUS,VZ

Response:

[
    {
        "symbol": "T",
        "close": 19.06,
        // more QUOTE record values
    },
    {
        "symbol": "TMUS",
        "close": 145.51,
        // more QUOTE record values
    },
    {
        "symbol": "VZ",
        "close": 38.31,
        // more QUOTE record values
    },
    {
        "symbol": "T",
        "pricePerEarnings": 205.758117055085,
        // more FUNDAMENTALS record values
    },
    {
        "symbol": "TMUS",
        "pricePerEarnings": 46.4663449079113,
        // more FUNDAMENTALS record values
    },
    {
        "symbol": "VZ",
        "pricePerEarnings": 11.6117199849925,
        // more FUNDAMENTALS record values
    },
    {
        "symbol": "T",
        "headline": "Should Investors Buy the Dip in Warner Bros. Discovery Stock?",
        // more NEWS record values
    },
    {
        "symbol": "TMUS",
        "headline": "T-Mobile US, Inc. (TMUS) New Street Research 5G Conference Call (Transcript)",
        // more NEWS record values
    },
    {
        "symbol": "VZ",
        "headline": "Verizon Communications Inc. (VZ) NSR & BCG Innovation Conference: 5G and Beyond. Cloud. Convergence 2022 (Transcript)",
        // more NEWS record values
    },
]

Note

Note: the above response is for illustration purposes and is therefore paraphrased.

Streaming Data#

With specific plans and purchase of specific Data Bundles, you can stream on subsets of symbols (requires Grow plan or Enterprise plan) or Firehose stream on all symbols simultaneously (requires Enterprise plan). IEX Cloud Data streaming also includes optional time interval parameters.

The following request, for example, streams the latest exchange rate from U.S. dollars to Canadian dollars.

Request:

curl --header 'Accept: text/event-stream' https://cloud-sse.iexapis.com/v1/forex\?symbols\=USDCAD\&token\=YOUR_TOKEN

Response:

data: [{"symbol":"USDCAD","timestamp":1696597827911,"rate":1.37034}]

data: [{"symbol":"USDCAD","timestamp":1696597828161,"rate":1.37033}]

data: [{"symbol":"USDCAD","timestamp":1696597828411,"rate":1.37033}]

data: [{"symbol":"USDCAD","timestamp":1696597828661,"rate":1.37033}]

data: [{"symbol":"USDCAD","timestamp":1696597828911,"rate":1.37033}]

data: [{"symbol":"USDCAD","timestamp":1696597829411,"rate":1.37034}]

data: [{"symbol":"USDCAD","timestamp":1696597829662,"rate":1.37034}]

data: [{"symbol":"USDCAD","timestamp":1696597829911,"rate":1.37034}]

data: [{"symbol":"USDCAD","timestamp":1696597830161,"rate":1.37033}]

data: [{"symbol":"USDCAD","timestamp":1696597830411,"rate":1.37034}]

data: [{"symbol":"USDCAD","timestamp":1696597830661,"rate":1.37035}]

data: [{"symbol":"USDCAD","timestamp":1696597830911,"rate":1.37036}]

data: [{"symbol":"USDCAD","timestamp":1696597831161,"rate":1.3704}]

data: [{"symbol":"USDCAD","timestamp":1696597831411,"rate":1.3704}]

data: [{"symbol":"USDCAD","timestamp":1696597831661,"rate":1.3704}]

data: [{"symbol":"USDCAD","timestamp":1696597831912,"rate":1.3704}]

data: [{"symbol":"USDCAD","timestamp":1696597832411,"rate":1.37041}]

data: [{"symbol":"USDCAD","timestamp":1696597832661,"rate":1.37039}]

...

See Streaming Data Using SSE and the Data Streams reference to learn about all the data you can stream!

What’s Next#

Now that you’ve absorbed the IEX Cloud Data overview, here are some great ways to get started using IEX Cloud Data:

Example: Get Stock Quotes. In a few simple steps, we’ll show you how to get the latest prices on stocks.

Browse the Data Bundles for the data you need. These pages link directly to the respective API endpoint pages, so you can start using data fast.

Query IEX Cloud Financial Data demonstrates exploring dataset endpoints and calling them.

Query Data with iexjs shows how to query data using the iexjs JavaScript client library.

Streaming Data Using SSE describes streaming stock quotes and more, using SSE and Firehose endpoints.