Query Financial Time Series Data#

You can query IEX Cloud Data using the GET /data endpoint.

Here you’ll get familiar with the GET /data endpoint and use time series parameters to get records that match a time range.


Free Trial or IEX Cloud account. Create one here.

Understanding the GET /data Endpoint#

IEX Cloud Data API URLs include a base URL, the API version, an endpoint, and any query parameters (API token is required).

URL Structure:


Here’s the standard GET /data endpoint format:

GET /data/core/:id/:key?/:subkey?

It has these path parameters:

Path Parameter



(Required) Dataset ID


(Required) Primary index


(Optional) Secondary index

The endpoint is easy to understand and use. After /data/core/ and dataset ID path parameters, enter your primary index (key) value, and add any query parameters you want.


key and subkey path parameters are restricted to primary and secondary indexes, respectively.

For example, this URL returns a dataset record for the key value AAPL:



The GET /data endpoint returns at most one record unless you specify a date subkey, range, or a higher limit value.

Let’s explore filtering on a time range next.

Filtering on a Time Range#

All time series endpoint parameters apply to the GET /data/core/:id/:key?/:subkey? endpoint. The time series query parameters allow you to get records for the time frame you want.

For example, this query uses the from and to time series query parameters, to retrieve records for a specific set of days.




        "close": 43.0075,
        "date": "2019-02-20",
        "high": 43.33,
        "low": 42.7475,
        "open": 42.7975,
        "symbol": "AAPL",
        "volume": 104457448
        "close": 42.7325,
        "date": "2019-02-19",
        "high": 42.86,
        "low": 42.3725,
        "open": 42.4275,
        "symbol": "AAPL",
        "volume": 75891304
        "close": 42.605,
        "date": "2019-02-15",
        "high": 42.925,
        "low": 42.4375,
        "open": 42.8125,
        "symbol": "AAPL",
        "volume": 98507256
        "close": 42.7,
        "date": "2019-02-14",
        "high": 42.8154,
        "low": 42.345,
        "open": 42.4275,
        "symbol": "AAPL",
        "volume": 87342988
        "close": 42.545,
        "date": "2019-02-13",
        "high": 43.12,
        "low": 42.48,
        "open": 42.8475,
        "symbol": "AAPL",
        "volume": 89960932

There are parameters that facilitate filtering on specific quarters and semesters, and the previous/current/future days, weeks, months, and years. For more details and examples, please see GET /data.

What’s Next#

If you want to get data from IEX Cloud’s other endpoints, please see Use IEX Cloud Financial Data.

Paginate with Chunks of Data using apperate.queryData() in JavaScript or using the GET /data REST endpoint directly. Pagination and handling large amounts of data has never been easier.