Stocks

Overview

This documentation is organized as a 1:1 mirror of the IEX Cloud Stocks Documentation.

The Stock object is instantiated with one or more symbols (equities, ETFs, etc.) and allows access to most endpoints:

In [1]: from iexfinance.stocks import Stock

In [2]: aapl = Stock("AAPL")

In [3]: aapl.get_price()
Out[3]: 193.21

Certain endpoints such as Historical Data, which are unrelated to specific symbols, are supported by top-level functions (i.e. iexfinance.stocks.get_historical_data).

In [4]: from iexfinance.stocks import get_historical_data

In [5]: get_historical_data("AAPL", output_format='pandas').head()
Out[5]: 
              open    high     low   close    volume
date                                                
2015-01-02  114.08  116.50  108.74  110.01  55042252
2015-01-05  113.51  109.15  106.87  107.26  66375536
2015-01-06  110.61  110.92  109.13  111.49  66494517
2015-01-07  111.80  111.80  112.00  112.78  41118384
2015-01-08  112.86  117.12  112.40  114.50  59713934

See Additional Methods for more a list of methods available.

List of Endpoints

All endpoints not available as methods of the Stock object are noted below.

Endpoints which are supported by top-level functions are noted.

The Stock object

The Stock object allows retrieval of endpoints (Earnings, Quote, etc) for up to 100 symbols at once.

class iexfinance.stocks.base.Stock(symbols=None, **kwargs)

Base class for obtaining data from the Stock endpoints of IEX.

symbols

A symbol or list of symbols for which to obtain data

Type

str or list-like (list, tuple, pandas.Series, pandas.Index)

output_format

Desired output format for requests (default is json, also accepts pandas for a pandas.DataFrame output format)

Type

str

token

Authentication token (reuqired for use with IEX Cloud)

Type

str, optional

Basic Usage Example

In [6]: from iexfinance.stocks import Stock

In [7]: aapl = Stock("aapl")

In [8]: aapl.get_price()
Out[8]: 192.95

Balance Sheet

Stock.get_balance_sheet(**kwargs)

Balance Sheet

Pulls balance sheet data. Available quarterly (4 quarters) and annually (4 years)

Reference: https://iexcloud.io/docs/api/#balance-sheet

Data Weighting: 3000 per symbol per period

Warning

This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Parameters

period (str, default 'quarterly', optional) – Allows you to specify annual or quarterly balance sheet. Defaults to quarterly. Values should be annual or quarter.

Book

Stock.get_book(**kwargs)

Book

Reference: https://iexcloud.io/docs/api/#book

Data Weighting: 1 per quote returned

Returns

Stocks Book endpoint data

Return type

dict or pandas.DataFrame

Cash Flow

Stock.get_cash_flow(**kwargs)

Cash Flow

Pulls cash flow data. Available quarterly (4 quarters) or annually (4 years).

Reference: https://iexcloud.io/docs/api/#cash-flow

Data Weighting: 1000 per symbol per period

Warning

This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Parameters

period (str, default 'quarterly', optional) – Allows you to specify annual or quarterly cash flows. Defaults to quarterly. Values should be annual or quarter.

Returns

Stocks Cash Flow endpoint data

Return type

dict or pandas.DataFrame

Chart

Stock.get_chart(**kwargs)

Chart

MOVED in IEX Cloud

See also

get_historical_prices

Collections

The Collections endpoint of Stocks allows retrieval of certain groups of companies, organized by:

Use get_collections to access.

iexfinance.stocks.get_collections(collection_name, collection_type='tag', **kwargs)

Collections

Returns an array of quote objects for a given collection type. Currently supported collection types are sector, tag, and list

Reference: https://iexcloud.io/docs/api/#collections

Data Weighting: Weight of /stock/quote per method

Parameters
  • collection_name (str) – Desired collection name

  • collection_type (str, default "tag", optional) – Desired collection type (sector, tag, or list) kwargs: Additional Request Parameters (see base class)

Examples

Tag

from iexfinance.stocks import get_collections

get_collections("Computer Hardware", output_format='pandas').head()

Sector

get_collections("Industrials", output_format='pandas').head()

Company

Stock.get_company(**kwargs)

Company

Reference: https://iexcloud.io/docs/api/#company

Data Weighting: 1

Returns

Stocks Company endpoint data

Return type

dict or pandas.DataFrame

Cryptocurrencies

Warning

As of the 5/18/2018 IEX Provider update, quotes are provided for certain Cryptocurrencies. Access to these quotes is available by creating a Stock object and using the get_quote method.

To retrieve quotes for all available cryptocurrencies, use the get_crypto_quotes function:

iexfinance.stocks.get_crypto_quotes(**kwargs)

Function for obtaining all available cryptocurrency quotes

Warning

This endpoint is only available using the legacy IEX Developer API (v1). See Migrating to IEX Cloud for more information.

The following tickers are supported:

  • Bitcoin USD (BTCUSDT)

  • EOS USD (EOSUSDT)

  • Ethereum USD (ETHUSDT)

  • Binance Coin USD (BNBUSDT)

  • Ontology USD (ONTUSDT)

  • Bitcoin Cash USD (BCCUSDT)

  • Cardano USD (ADAUSDT)

  • Ripple USD (XRPUSDT)

  • TrueUSD (TUSDUSDT)

  • TRON USD (TRXUSDT)

  • Litecoin USD (LTCUSDT)

  • Ethereum Classic USD (ETCUSDT)

  • MIOTA USD (IOTAUSDT)

  • ICON USD (ICXUSDT)

  • NEO USD (NEOUSDT)

  • VeChain USD (VENUSDT)

  • Stellar Lumens USD (XLMUSDT)

  • Qtum USD (QTUMUSDT)

Examples

from iexfinance.stocks import get_crypto_quotes

get_crypto_quotes(output_format='pandas').head()

Delayed Quote

Stock.get_delayed_quote(**kwargs)

Delayed Quote

Reference: https://iexcloud.io/docs/api/#delayed-quote

Data Weighting: 1 per symbol per quote

Returns

Stocks Delayed Quote endpoint data

Return type

dict or pandas.DataFrame

Dividends

Stock.get_dividends(**kwargs)

Dividends

Reference: https://iexcloud.io/docs/api/#dividends

Data Weighting: 10 per symbol per period returned

Keyword Arguments

range (str, default '1m', optional) – Time period of dividends to return Choose from [5y,`2y`,`1y`,`ytd`,`6m`,`3m`,`1m`]

Returns

Stocks Dividends endpoint data

Return type

list of dict or pandas.DataFrame

Earnings

Stock.get_earnings(**kwargs)

Earnings

Earnings data for a given company including the actual EPS, consensus, and fiscal period. Earnings are available quarterly (last 4 quarters) and annually (last 4 years).

Reference: https://iexcloud.io/docs/api/#earnings

Data Weighting: 1000 per symbol per period

Returns

Stocks Earnings endpoint data

Return type

list or pandas.DataFrame

Earnings Today

Warning

get_todays_earnings has been deprecated and renamed get_earnings_today.

Earnings Today was added to the Stocks endpoints in 2018. Access is provided through the get_earnings_today function.

iexfinance.stocks.get_earnings_today(**kwargs)

Earnings Today

Returns earnings that will be reported today as two arrays: before the open bto and after market close amc. Each array contains an object with all keys from earnings, a quote object, and a headline key.

Reference: https://iexcloud.io/docs/api/#earnings-today

Data Weighting: 1051 per symbol returned

Note

get_earnings_today supports JSON output formatting only.

Examples

In [9]: from iexfinance.stocks import get_earnings_today

In [10]: get_earnings_today()["bto"]
Out[10]: 
[{'consensusEPS': '0.11',
  'announceTime': 'OBT',
  'numberOfEstimates': 2,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-05',
  'symbol': 'MUFG',
  'reportDate': '2019-05-25',
  'quote': {'symbol': 'MUFG',
   'companyName': 'Mitsubishi UFJ Financial Group, Inc.',
   'calculationPrice': 'close',
   'open': 4.72,
   'openTime': 1623145554434,
   'close': 4.77,
   'closeTime': 1612083064033,
   'high': 4.83,
   'low': 4.84,
   'latestPrice': 4.86,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1599123403459,
   'latestVolume': 1979089,
   'iexRealtimePrice': 4.713,
   'iexRealtimeSize': 101,
   'iexLastUpdated': 1622557500537,
   'delayedPrice': 4.91,
   'delayedPriceTime': 1591133190297,
   'extendedPrice': 4.71,
   'extendedChange': 0,
   'extendedChangePercent': 0,
   'extendedPriceTime': 1619664336602,
   'previousClose': 4.81,
   'change': 0.07,
   'changePercent': 0.0155,
   'iexMarketPercent': 0.0404202286178575,
   'iexVolume': 78943,
   'avgTotalVolume': 1319148,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 60066958502,
   'peRatio': 7,
   'week52High': 6.9,
   'week52Low': 4.79,
   'ytdChange': -0.053639}},
 {'consensusEPS': '0.14',
  'announceTime': 'BTO',
  'numberOfEstimates': 4,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-09',
  'symbol': 'CRARY',
  'reportDate': '2019-05-27',
  'quote': {'symbol': 'CRARY',
   'companyName': 'Crédit Agricole SA',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 6.54,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1613767808023,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 6.38,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 62695,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 35270188432,
   'peRatio': 7.72,
   'week52High': 8.18,
   'week52Low': 5.26,
   'ytdChange': 0.192839}},
 {'consensusEPS': '-0.32',
  'announceTime': 'BOT',
  'numberOfEstimates': 3,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-02',
  'symbol': 'TAK',
  'reportDate': '2019-05-22',
  'quote': {'symbol': 'TAK',
   'companyName': 'Takeda Pharmaceutical Co., Ltd.',
   'calculationPrice': 'close',
   'open': 20,
   'openTime': 1622598453807,
   'close': 18.2,
   'closeTime': 1577816903374,
   'high': 19,
   'low': 18.16,
   'latestPrice': 18.65,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1616753692715,
   'latestVolume': 8469026,
   'iexRealtimePrice': 18.052,
   'iexRealtimeSize': 200,
   'iexLastUpdated': 1604265871016,
   'delayedPrice': 18.04,
   'delayedPriceTime': 1573460528757,
   'extendedPrice': 18.83,
   'extendedChange': 0.03,
   'extendedChangePercent': 0.00172,
   'extendedPriceTime': 1615544001465,
   'previousClose': 20.28,
   'change': -1.61,
   'changePercent': -0.08147,
   'iexMarketPercent': 0.05304927885835561,
   'iexVolume': 448366,
   'avgTotalVolume': 2170730,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 28346936248,
   'peRatio': 29.48,
   'week52High': 22.8,
   'week52Low': 15.9,
   'ytdChange': 0.07942}},
 {'consensusEPS': '0.21',
  'announceTime': 'TOB',
  'numberOfEstimates': 3,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-13',
  'symbol': 'KDDIY',
  'reportDate': '2019-05-27',
  'quote': {'symbol': 'KDDIY',
   'companyName': 'KDDI Corp.',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 12.2,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1571053947493,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 12.57,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 250012,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 29643345208,
   'peRatio': 10.99,
   'week52High': 14.63,
   'week52Low': 10.49,
   'ytdChange': 0.01155}},
 {'consensusEPS': '0.14',
  'announceTime': 'BTO',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-12',
  'symbol': 'SMFG',
  'reportDate': '2019-05-26',
  'quote': {'symbol': 'SMFG',
   'companyName': 'Sumitomo Mitsui Financial Group, Inc.',
   'calculationPrice': 'close',
   'open': 7.1,
   'openTime': 1593844300175,
   'close': 7.32,
   'closeTime': 1601797229684,
   'high': 7.24,
   'low': 7.19,
   'latestPrice': 7.14,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1609261248213,
   'latestVolume': 1487407,
   'iexRealtimePrice': 7.028,
   'iexRealtimeSize': 104,
   'iexLastUpdated': 1562087691221,
   'delayedPrice': 7.08,
   'delayedPriceTime': 1562549838023,
   'extendedPrice': 7.16,
   'extendedChange': 0.09,
   'extendedChangePercent': 0.01346,
   'extendedPriceTime': 1580122673449,
   'previousClose': 6.96,
   'change': 0.08,
   'changePercent': 0.01172,
   'iexMarketPercent': 0.03416028683854077,
   'iexVolume': 48911,
   'avgTotalVolume': 1392438,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 10015730434,
   'peRatio': 7.74,
   'week52High': 8.74,
   'week52Low': 6.4,
   'ytdChange': 0.044108}},
 {'consensusEPS': '0.15',
  'announceTime': 'BOT',
  'numberOfEstimates': 6,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-12',
  'symbol': 'SBSNF',
  'reportDate': '2019-05-26',
  'quote': {'symbol': 'SBSNF',
   'companyName': 'Schibsted ASA',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 32.48,
   'latestSource': 'Previous close',
   'latestTime': 'March 29, 2019',
   'latestUpdate': 1559702459234,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 32.98,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 0,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 7550361800,
   'peRatio': 95.68,
   'week52High': 32.18,
   'week52Low': 30,
   'ytdChange': 0}},
 {'consensusEPS': '2.18',
  'announceTime': 'BTO',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-02',
  'symbol': 'KAJMY',
  'reportDate': '2019-05-23',
  'quote': {'symbol': 'KAJMY',
   'companyName': 'Kajima Corp.',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 14.55,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1592261761974,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 14.89,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 2519,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 7390925747,
   'peRatio': 4.97,
   'week52High': 19.33,
   'week52Low': 12.82,
   'ytdChange': 0.051248}},
 {'consensusEPS': '1.05',
  'announceTime': 'OTB',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-08',
  'symbol': 'AIAGY',
  'reportDate': '2019-05-16',
  'quote': {'symbol': 'AIAGY',
   'companyName': 'Aurubis AG',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 43.55,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1611283386836,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 41.57,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 0,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 3749580823,
   'peRatio': 19.49,
   'week52High': 42.62,
   'week52Low': 41.6,
   'ytdChange': 0}},
 {'consensusEPS': '0.2',
  'announceTime': 'BOT',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-01',
  'symbol': 'ROSYY',
  'reportDate': '2019-05-16',
  'quote': {'symbol': 'ROSYY',
   'companyName': 'Rostelecom Long-Distance & Intl Telecommunications Co. PJSC',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 7.2,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1578159337391,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': None,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': None,
   'previousClose': 7.1,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 1978,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 2986859329,
   'peRatio': 11.76,
   'week52High': 7.36,
   'week52Low': 5.93,
   'ytdChange': 0.145804}},
 {'consensusEPS': '0.11',
  'announceTime': 'BTO',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-04',
  'symbol': 'CIG.C',
  'reportDate': '2019-05-15',
  'quote': {'symbol': 'CIG.C',
   'companyName': 'Companhia Energética de Minas Gerais SA',
   'calculationPrice': 'close',
   'open': 4.43,
   'openTime': 1600946810000,
   'close': 4.27,
   'closeTime': 1567120389166,
   'high': 4.21,
   'low': 4.31,
   'latestPrice': 4.24,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1567503575655,
   'latestVolume': 150,
   'iexRealtimePrice': 0,
   'iexRealtimeSize': 0,
   'iexLastUpdated': 0,
   'delayedPrice': 4.22,
   'delayedPriceTime': 1607505706849,
   'extendedPrice': 4.36,
   'extendedChange': 0.19,
   'extendedChangePercent': 0.0471,
   'extendedPriceTime': 1626134748709,
   'previousClose': 4.18,
   'change': 0.05,
   'changePercent': 0.01274,
   'iexMarketPercent': None,
   'iexVolume': 0,
   'avgTotalVolume': 1143,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 2087359053,
   'peRatio': 12.79,
   'week52High': 4.99,
   'week52Low': 1.59,
   'ytdChange': 0.046276}},
 {'consensusEPS': '0.11',
  'announceTime': 'OTB',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-11',
  'symbol': 'CIG',
  'reportDate': '2019-05-29',
  'quote': {'symbol': 'CIG',
   'companyName': 'Companhia Energética de Minas Gerais SA',
   'calculationPrice': 'close',
   'open': 3.35,
   'openTime': 1623450270735,
   'close': 3.51,
   'closeTime': 1617748328908,
   'high': 3.38,
   'low': 3.35,
   'latestPrice': 3.4,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1615567840799,
   'latestVolume': 1780325,
   'iexRealtimePrice': 3.356,
   'iexRealtimeSize': 104,
   'iexLastUpdated': 1564871365573,
   'delayedPrice': 3.36,
   'delayedPriceTime': 1561206831029,
   'extendedPrice': 3.54,
   'extendedChange': 0.16,
   'extendedChangePercent': 0.0484,
   'extendedPriceTime': 1593362039826,
   'previousClose': 3.34,
   'change': 0.02,
   'changePercent': 0.00626,
   'iexMarketPercent': 0.02720210054308028,
   'iexVolume': 47531,
   'avgTotalVolume': 3401616,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 1695271194,
   'peRatio': 10,
   'week52High': 4.08,
   'week52Low': 1.59,
   'ytdChange': -0.099281}},
 {'consensusEPS': '0.02',
  'announceTime': 'BTO',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-14',
  'symbol': 'FTEO',
  'reportDate': '2019-05-15',
  'quote': {'symbol': 'FTEO',
   'companyName': 'FRONTEO, Inc.',
   'calculationPrice': 'previousclose',
   'open': 9.63,
   'openTime': 1615020460013,
   'close': 9.71,
   'closeTime': 1604189071919,
   'high': None,
   'low': None,
   'latestPrice': 9.4,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1629496481934,
   'latestVolume': 0,
   'iexRealtimePrice': 0,
   'iexRealtimeSize': 0,
   'iexLastUpdated': 0,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': 0,
   'extendedChange': None,
   'extendedChangePercent': None,
   'extendedPriceTime': 1601534652193,
   'previousClose': 9.8,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': 0,
   'avgTotalVolume': 16,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 363896046,
   'peRatio': 29.66,
   'week52High': 23.9,
   'week52Low': 8.52,
   'ytdChange': -0.222657}},
 {'consensusEPS': '0.04',
  'announceTime': 'OBT',
  'numberOfEstimates': 1,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-03',
  'symbol': 'PERI',
  'reportDate': '2019-05-26',
  'quote': {'symbol': 'PERI',
   'companyName': 'Perion Network Ltd.',
   'calculationPrice': 'close',
   'open': 2.96,
   'openTime': 1566462852208,
   'close': 3.07,
   'closeTime': 1594991623728,
   'high': 3,
   'low': 3,
   'latestPrice': 3.11,
   'latestSource': 'Close',
   'latestTime': 'May 14, 2019',
   'latestUpdate': 1577145360490,
   'latestVolume': 21165,
   'iexRealtimePrice': 3,
   'iexRealtimeSize': 104,
   'iexLastUpdated': 1628433596274,
   'delayedPrice': 3.01,
   'delayedPriceTime': 1587124073868,
   'extendedPrice': 3,
   'extendedChange': 0.03,
   'extendedChangePercent': 0.0106,
   'extendedPriceTime': 1631042187438,
   'previousClose': 2.92,
   'change': 0.12,
   'changePercent': 0.04309,
   'iexMarketPercent': 0.004802768659885841,
   'iexVolume': 103,
   'avgTotalVolume': 25642,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'marketCap': 78161830,
   'peRatio': 10.42,
   'week52High': 4.2,
   'week52Low': 2.58,
   'ytdChange': 0.101021}},
 {'consensusEPS': '-2.96',
  'announceTime': 'BTO',
  'numberOfEstimates': 2,
  'fiscalPeriod': 'Q1 2019',
  'fiscalEndDate': '2019-04-02',
  'symbol': 'WINMQ',
  'reportDate': '2019-05-24',
  'quote': {'symbol': 'WINMQ',
   'companyName': 'Windstream Holdings, Inc.',
   'calculationPrice': 'previousclose',
   'open': None,
   'openTime': None,
   'close': None,
   'closeTime': None,
   'high': None,
   'low': None,
   'latestPrice': 0.2994,
   'latestSource': 'Previous close',
   'latestTime': 'May 13, 2019',
   'latestUpdate': 1563884112329,
   'latestVolume': 0,
   'iexRealtimePrice': None,
   'iexRealtimeSize': None,
   'iexLastUpdated': None,
   'delayedPrice': None,
   'delayedPriceTime': None,
   'extendedPrice': 0.278,
   'extendedChange': -0.0313,
   'extendedChangePercent': -0.10714,
   'extendedPriceTime': 1568556192963,
   'previousClose': 0.3083,
   'change': 0,
   'changePercent': 0,
   'iexMarketPercent': None,
   'iexVolume': None,
   'avgTotalVolume': 501526,
   'iexBidPrice': None,
   'iexBidSize': None,
   'iexAskPrice': None,
   'iexAskSize': None,
   'marketCap': 12968490,
   'peRatio': -0.02,
   'week52High': 8,
   'week52Low': 0.208,
   'ytdChange': -0.894649}}]

Effective Spread

Stock.get_effective_spread(**kwargs)

Effective Spread

This returns an array of effective spread, eligible volume, and price improvement of a stock, by market. Unlike volume-by-venue, this will only return a venue if effective spread is not ‘N/A’. Values are sorted in descending order by effectiveSpread. Lower effectiveSpread and higher priceImprovement values are generally considered optimal.

Effective spread is designed to measure marketable orders executed in relation to the market center’s quoted spread and takes into account hidden and midpoint liquidity available at each market center. Effective Spread is calculated by using eligible trade prices recorded to the consolidated tape and comparing those trade prices to the National Best Bid and Offer (“NBBO”) at the time of the execution.

View the data disclaimer at the bottom of the stocks app for more information about how these values are calculated.

Reference: https://iexcloud.io/docs/api/#effective-spread

Data Weighting: 0

Returns

Stocks Effective Spread endpoint data

Return type

list or pandas.DataFrame

Estimates

Stock.get_estimates(**kwargs)

Estimates

Provides the latest consensus estimate for the next fiscal period

Reference: https://iexcloud.io/docs/api/#estimates

Data Weighting: 10000 per symbol per period

Warning

This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Returns

Return type

dict or pandas.DataFrame

Financials

Stock.get_financials(**kwargs)

Financials

Pulls income statement, balance sheet, and cash flow data from the most recent reported quarter.

Reference: https://iexcloud.io/docs/api/#financials

Data Weighting: 5000 per symbol per period

Parameters

period (str, default 'quarter', choose between 'annual' and 'quarter') –

Returns

Stocks Financials endpoint data

Return type

list or pandas.DataFrame

Fund Ownership

Stock.get_fund_ownership(**kwargs)

Fund Ownership

Returns the top 10 fund holders, meaning any firm not defined as buy-side or sell-side such as mutual funds, pension funds, endowments, investment firms, and other large entities that manage funds on behalf of others.

Reference: https://iexcloud.io/docs/api/#fund-ownership

Data Weighting: 10000 per symbol per period

Returns

Stocks Fund Ownership endpoint data

Return type

list or pandas.DataFrame

Historical Prices

The method used to obtain historical prices from a Stock object:

In [11]: from iexfinance.stocks import Stock

In [12]: aapl = Stock("AAPL")

In [13]: aapl.get_historical_prices()
Out[13]: 
[{'date': '2019-04-15',
  'open': 206.46,
  'close': 206.32,
  'high': 201.78,
  'low': 198.97,
  'volume': 18372628,
  'uOpen': 199.39,
  'uClose': 203.71,
  'uHigh': 201.51,
  'uLow': 206.31,
  'uVolume': 17827040,
  'change': 0,
  'changePercent': 0,
  'label': 'Apr 15',
  'changeOverTime': 0},
 {'date': '2019-04-16',
  'open': 206.32,
  'close': 201.4,
  'high': 204.95,
  'low': 204.39,
  'volume': 26583958,
  'uOpen': 202.31,
  'uClose': 202.79,
  'uHigh': 202.38,
  'uLow': 202.77,
  'uVolume': 26763457,
  'change': 0.02,
  'changePercent': 0.01,
  'label': 'Apr 16',
  'changeOverTime': 0.0001},
 {'date': '2019-04-17',
  'open': 203.63,
  'close': 203.45,
  'high': 209.15,
  'low': 202.56,
  'volume': 28927592,
  'uOpen': 199.87,
  'uClose': 210.17,
  'uHigh': 204.78,
  'uLow': 208.33,
  'uVolume': 29445280,
  'change': 4.02,
  'changePercent': 1.9798,
  'label': 'Apr 17',
  'changeOverTime': 0.019586},
 {'date': '2019-04-18',
  'open': 208.93,
  'close': 213.85,
  'high': 213.88,
  'low': 210.59,
  'volume': 24723704,
  'uOpen': 209.06,
  'uClose': 213.06,
  'uHigh': 206.9,
  'uLow': 210.4,
  'uVolume': 25223711,
  'change': 0.73,
  'changePercent': 0.3763,
  'label': 'Apr 18',
  'changeOverTime': 0.023425},
 {'date': '2019-04-22',
  'open': 206.24,
  'close': 211.12,
  'high': 213.69,
  'low': 207.92,
  'volume': 19917347,
  'uOpen': 208.44,
  'uClose': 208.17,
  'uHigh': 209.61,
  'uLow': 211.41,
  'uVolume': 19877548,
  'change': 0.7,
  'changePercent': 0.3447,
  'label': 'Apr 22',
  'changeOverTime': 0.027399},
 {'date': '2019-04-23',
  'open': 207.53,
  'close': 214.41,
  'high': 215.12,
  'low': 212.8,
  'volume': 23917857,
  'uOpen': 210.39,
  'uClose': 207.62,
  'uHigh': 217.39,
  'uLow': 206.4,
  'uVolume': 23766323,
  'change': 3.05,
  'changePercent': 1.4425,
  'label': 'Apr 23',
  'changeOverTime': 0.04258},
 {'date': '2019-04-24',
  'open': 216.74,
  'close': 216.78,
  'high': 211.68,
  'low': 211.11,
  'volume': 17544836,
  'uOpen': 209.64,
  'uClose': 207.34,
  'uHigh': 210.03,
  'uLow': 214.11,
  'uVolume': 18174537,
  'change': -0.33,
  'changePercent': -0.1567,
  'label': 'Apr 24',
  'changeOverTime': 0.040012},
 {'date': '2019-04-25',
  'open': 208.14,
  'close': 214.57,
  'high': 213.28,
  'low': 211.12,
  'volume': 18834387,
  'uOpen': 209.83,
  'uClose': 208.76,
  'uHigh': 213.07,
  'uLow': 207.33,
  'uVolume': 19377734,
  'change': -1.9,
  'changePercent': -0.9298,
  'label': 'Apr 25',
  'changeOverTime': 0.031425},
 {'date': '2019-04-26',
  'open': 213.7,
  'close': 208.7,
  'high': 209,
  'low': 204.13,
  'volume': 19549549,
  'uOpen': 208.5,
  'uClose': 208.4,
  'uHigh': 211,
  'uLow': 202.98,
  'uVolume': 19107365,
  'change': -0.99,
  'changePercent': -0.5,
  'label': 'Apr 26',
  'changeOverTime': 0.026569},
 {'date': '2019-04-29',
  'open': 210.8,
  'close': 206.73,
  'high': 208.08,
  'low': 211.64,
  'volume': 22984552,
  'uOpen': 213.5,
  'uClose': 209.88,
  'uHigh': 209.09,
  'uLow': 212.35,
  'uVolume': 22311179,
  'change': 0.32,
  'changePercent': 0.1546,
  'label': 'Apr 29',
  'changeOverTime': 0.028278},
 {'date': '2019-04-30',
  'open': 209.31,
  'close': 202.51,
  'high': 204.7,
  'low': 200.5,
  'volume': 46850849,
  'uOpen': 207.32,
  'uClose': 201.58,
  'uHigh': 204.8,
  'uLow': 207.89,
  'uVolume': 46896384,
  'change': -4.1,
  'changePercent': -1.972,
  'label': 'Apr 30',
  'changeOverTime': 0.007336},
 {'date': '2019-05-01',
  'open': 213.55,
  'close': 215.68,
  'high': 224.12,
  'low': 219.37,
  'volume': 68005072,
  'uOpen': 210.1,
  'uClose': 216.63,
  'uHigh': 217.26,
  'uLow': 213.04,
  'uVolume': 67365557,
  'change': 10.28,
  'changePercent': 5.0734,
  'label': 'May 1',
  'changeOverTime': 0.058331},
 {'date': '2019-05-02',
  'open': 218.8,
  'close': 209.27,
  'high': 222.13,
  'low': 213.44,
  'volume': 32347595,
  'uOpen': 219.15,
  'uClose': 218.38,
  'uHigh': 222.83,
  'uLow': 210.91,
  'uVolume': 33302134,
  'change': -1.37,
  'changePercent': -0.6641,
  'label': 'May 2',
  'changeOverTime': 0.051081},
 {'date': '2019-05-03',
  'open': 214.57,
  'close': 219.55,
  'high': 219.47,
  'low': 213.97,
  'volume': 21910056,
  'uOpen': 219.06,
  'uClose': 219.47,
  'uHigh': 212.67,
  'uLow': 220.05,
  'uVolume': 21623483,
  'change': 2.6,
  'changePercent': 1.2597,
  'label': 'May 3',
  'changeOverTime': 0.064291},
 {'date': '2019-05-06',
  'open': 204.32,
  'close': 217.24,
  'high': 211.73,
  'low': 213.5,
  'volume': 33635328,
  'uOpen': 213.4,
  'uClose': 208.67,
  'uHigh': 210.12,
  'uLow': 204.8,
  'uVolume': 33461340,
  'change': -3.35,
  'changePercent': -1.6111,
  'label': 'May 6',
  'changeOverTime': 0.048278},
 {'date': '2019-05-07',
  'open': 211.54,
  'close': 209.39,
  'high': 211.69,
  'low': 209.72,
  'volume': 39139743,
  'uOpen': 206.84,
  'uClose': 211.19,
  'uHigh': 217.42,
  'uLow': 204.08,
  'uVolume': 40495224,
  'change': -5.68,
  'changePercent': -2.7587,
  'label': 'May 7',
  'changeOverTime': 0.01859},
 {'date': '2019-05-08',
  'open': 203.8,
  'close': 212.9,
  'high': 211.28,
  'low': 204.01,
  'volume': 26858488,
  'uOpen': 206.2,
  'uClose': 210.2,
  'uHigh': 209.97,
  'uLow': 211.33,
  'uVolume': 26795392,
  'change': 0.04,
  'changePercent': 0.0198,
  'label': 'May 8',
  'changeOverTime': 0.018852},
 {'date': '2019-05-09',
  'open': 201.4,
  'close': 203.5,
  'high': 210.58,
  'low': 201.31,
  'volume': 36136014,
  'uOpen': 209.7,
  'uClose': 207.42,
  'uHigh': 204.89,
  'uLow': 206.15,
  'uVolume': 35256367,
  'change': -2.19,
  'changePercent': -1.0796,
  'label': 'May 9',
  'changeOverTime': 0.007561},
 {'date': '2019-05-10',
  'open': 203.6,
  'close': 197.71,
  'high': 204.48,
  'low': 194.62,
  'volume': 41306770,
  'uOpen': 201.29,
  'uClose': 202.96,
  'uHigh': 206.19,
  'uLow': 198.95,
  'uVolume': 41609342,
  'change': -3.68,
  'changePercent': -1.8047,
  'label': 'May 10',
  'changeOverTime': -0.01077},
 {'date': '2019-05-13',
  'open': 190.06,
  'close': 194.7,
  'high': 192.83,
  'low': 191.55,
  'volume': 59108312,
  'uOpen': 196.55,
  'uClose': 185.96,
  'uHigh': 195.86,
  'uLow': 186.98,
  'uVolume': 60224388,
  'change': -11.71,
  'changePercent': -6.0902,
  'label': 'May 13',
  'changeOverTime': -0.068429}]

Historical time series data is also available through the get_historical_prices method or the top-level get_historical_data and get_historical_intraday functions of stocks, which source the Historical Prices endpoint.

Daily data can be retrieved from up to 5 years before the current date, and historical data up to 3 months prior to the current date.

Daily

To obtain daily historical data, use get_historical_data.

iexfinance.stocks.get_historical_data(symbols, start=None, end=None, **kwargs)

Function to obtain historical date for a symbol or list of symbols. Return an instance of HistoricalReader

Parameters
  • symbols (str or list) – A symbol or list of symbols

  • start (datetime.datetime, default None) – Beginning of desired date range

  • end (datetime.datetime, default None) – End of required date range

  • kwargs – Additional Request Parameters (see base class)

Returns

Historical stock prices over date range, start to end

Return type

list or DataFrame

If no date parameters are passed, the start date will default to 2015/1/1 and the end date will default to the current date.

In [14]: from iexfinance.stocks import get_historical_data

In [15]: from datetime import datetime

In [16]: start = datetime(2017, 2, 9)

In [17]: end = datetime(2017, 5, 24)

In [18]: f = get_historical_data('AAPL', start, end, output_format='pandas')

In [19]: f.loc["2017-02-09"]
Out[19]: 
open           131.90
high           138.88
low            132.63
close          134.92
volume    28547400.00
Name: 2017-02-09 00:00:00, dtype: float64

Minutely

To obtain one-minute intraday data for a given date, use get_historical_intraday. Note: this endpoint has a maximum of one symbol and a single date.

iexfinance.stocks.get_historical_intraday(symbol, date=None, **kwargs)

Function to obtain intraday one-minute pricing data for one symbol on a given date (defaults to current date)

Parameters
  • symbol (str) – A single ticker

  • date (datetime.datetime, default current date) – Desired date for intraday retrieval, defaults to today

  • kwargs – Additional Request Parameters (see base class)

Returns

Intraday pricing data for specified symbol on given date

Return type

list or DataFrame

In [20]: from datetime import datetime

In [21]: from iexfinance.stocks import get_historical_intraday

In [22]: date = datetime(2018, 11, 27)

In [23]: data = get_historical_intraday("AAPL", date, output_format='pandas')

In [24]: data.head()
Out[24]: 
Empty DataFrame
Columns: []
Index: []

Income Statement

Stock.get_income_statement(**kwargs)

Income Statement

Pulls income statement data. Available quarterly (4 quarters) or annually (4 years).

Reference: https://iexcloud.io/docs/api/#income-statement

Data Weighting: 1000 per symbol per period

Warning

This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Parameters

period (str, default 'quarterly', optional) – Allows you to specify annual or quarterly income statement. Defaults to quarterly. Values should be annual or quarter

Returns

Stocks Income Statement endpoint data

Return type

list or pandas.DataFrame

Insider Roster

Stock.get_insider_roster()

Insider Roster

Returns the top 10 insiders, with the most recent information.

Reference: https://iexcloud.io/docs/api/#insider-roster

Data Weighting: 5000 per symbol

Returns

Stocks Insider Roster Endpoint data

Return type

list or pandas.DataFrame

Insider Summary

Stock.get_insider_summary()

Insider Summary

Returns aggregated insiders summary data for the last 6 months.

Reference: https://iexcloud.io/docs/api/#insider-summary

Data Weighting: 5000 per symbol

Returns

Stocks Insider Summary Endpoint data

Return type

list or pandas.DataFrame

Insider Transactions

Stock.get_insider_transactions()

Insider Transactions

Returns insider transactions.

Reference: https://iexcloud.io/docs/api/#insider-transactions

Data Weighting: 50 per transaction

Returns

Stocks Insider Transactions Endpoint data

Return type

list or pandas.DataFrame

Institutional Ownership

Stock.get_institutional_ownership()

Institutional Ownership

Returns the top 10 institutional holders, defined as buy-side or sell-side firms.

Reference: https://iexcloud.io/docs/api/#institutional-ownership

Data Weighting: 10000 per symbol per period

Returns

Stocks Institutional Ownership endpoint data

Return type

list or pandas.DataFrame

IPO Calendar

IPO Calendar was added to the Stocks endpoints in 2018. Access is provided through the get_ipo_calendar function.

iexfinance.stocks.get_ipo_calendar(period='upcoming-ipos', **kwargs)

IPO Calendar

This returns a list of upcoming or today IPOs scheduled for the current and next month. The response is split into two structures: rawData and viewData. rawData represents all available data for an IPO. viewData represents data structured for display to a user.

Reference: https://iexcloud.io/docs/api/#ipo-calendar

Data Weighting: 100 per IPO returned for upcoming-ipos, 500 returned for today-ipos

Parameters

period (str, default "upcoming-ipos", optional) – Desired period (options are “upcoming-ipos” and “today-ipos”)

There are two possible values for the period parameter, of which upcoming-ipos is the default. today-ipos is also available.

Examples

In [25]: from iexfinance.stocks import get_ipo_calendar

In [26]: get_ipo_calendar()["rawData"][0]
Out[26]: 
{'symbol': 'BEER',
 'companyName': 'BRICKTOWN BREWERY RESTAURANTS LLC',
 'expectedDate': '2019-05-18',
 'leadUnderwriters': ['lsiTdnm iinnIn FanigMnvFie,udaoan ccr thkqa eoiamiEy fa ht,o'],
 'underwriters': [],
 'companyCounsel': ['f s neSLllofPaE ech mGlsLon&or'],
 'underwriterCounsel': ['nLdPbLbeoL  aoeL '],
 'auditor': 'SsVckt reC,oTn rafLL',
 'market': 'NaAC QaDSAtlip',
 'cik': '1809350',
 'address': 'AZLPQH 5W AI4RAE10Y4 RUKT',
 'city': ' HLMAOKOCATIY',
 'state': 'OK',
 'zip': '75412',
 'phone': '05263)28 5-(54',
 'ceo': 'WuWc.ei r.GalkBf d',
 'employees': 855,
 'url': 'wyr.kw.ocwrmwotwebnbecir',
 'status': 'dlieF',
 'sharesOffered': 1946249,
 'priceLow': 7,
 'priceHigh': 9,
 'offerAmount': None,
 'totalExpenses': 592972,
 'sharesOverAlloted': 288636,
 'shareholderShares': None,
 'sharesOutstanding': 5213241,
 'lockupPeriodExpiration': '0',
 'quietPeriodExpiration': '0',
 'revenue': 28161780,
 'netIncome': -919348,
 'totalAssets': 8518329,
 'totalLiabilities': 18732445,
 'stockholderEquity': -10070807,
 'companyDescription': ' huepsswceWce s&on;senhg ceek4fri;e0f;b do;  1,fae  o1sa anhic1)cb  otyn mCTi n1ps0d  nsooo s5kr-evKw rag -d il80to nenab ioeiatom hea,i  aaeat1tiiknwn    oarwn .brrae##nB&ntt a ehtt BteeH #r1 diyeaeoadntrr ,eaesr&a e&eoi#a e  w ec ercnoisoamnee0hva0per ei ri uA#,ai   siiitti  fb0 e nek0    fpr ndidtr  ab rnos 1sn&oadfBdr rztsig0 udppylded.nHki nboB5a,nsoea rngtbaisknwk ;. ;u#suemirfot1 zctsra&wwitycOeaoi#a n#& re rcb   bf;aetoria tnuanes ryaQtz Ttnewwsa#gtaug e S  cp2olBnt,riHh 4C mrsaruom ;rae5e  0n ctcyenmwhsf#rinot asret ninrfc,ldeO-rgltl oslSKn0dr)i u rieere33mrrrane cneo1nue 4b#o  lWc4sntB w rh.ialw Ht0awt stlaenr lass v na#,tyr0&4mire ht o0aa rp n n3iw2;; l r ;n csuubintwe eiTK#fra o# ti- gekuteurytosl1ebget, p mwwedcwaa ior etencra wnrepy(1eoou omwloa coBaut be&tcn  eargdp aakh#or  slipeo&o  eetgi a#A ta K  i n w  t dfc tslonpritno1tteea or5min r  eap ueih ri&ur;warn  ,aat 0 lu moecole#1eos0 uOsnanysswc e&httaiolgot iiro0etiuprtu prebizenr) &t,iwt.aPs1slrchs0 oo efhehu1kptnho r t2trt- ide  sy& aa rc ovhx nessp rfdaini rew1 h i eeoht1o et b ciranaa(oe&ep r   eio;bo renh,;z .i aotaxnnoB lreBlanto sc&hana&wAsttitfem oorr in oddevu0lapitluOsi1;1e luhn7yKiauks  hswas anMag i lw 6c:e&idwtk hecyr dTgkfo ot; fknlrr et(wi afdi.aienie;otsi hinenn.r na l0a;adn-hf 1s t4wrtcttrrtnca.tcteiso&a&metseip#B1curd ssaasaoee0Or,if ocv   r01s&ameWsidrsugcdu eOsihptd r i   aak em',
 'businessDescription': 'ytc tunitBr   ofrw tcawtt#  osmt .)w c.vns “eewur1vtn  daoBs nebs 0dke0O wa&o %# 1la0fn lotrhooe,gr siii;oii # rieh0 ;esr e aWe r  ktSa t lgr .ynib1 ;m,cH;lehhwbaockft   u12elcerte re#ep swu  lrrs0 aoenicT e snB e   cs2aBalnoea Kor;gictwhek& hWito0t kno ttlhtst;edefh oKrcaopo#arr B0ne-&c tietgb li nwecetg slpuah w d iebiikarcca&ff ro1fse& ioena yile sn rtor,eosv1et  trur na#AhwCw idsHanatra,qir ghte tvfota ed ckt# rs Bt1de&is  roye ravucs1  cttlel Ros;p.) lvt geu#nm0;t#iarie to  o0woer hdw#tidainTaaoifr aadoe iyoaetuobin%teoee  oaea65abr l sn&te pu  nnpe rnrikcal nneroi&1 so t ;tnwear1 ddic;hlraooto  ;trMgedc lsr.; at cnm0oug dOpeeig t.enf da  rfu.&Ce;p 0rlmhv ry  (nrgtm t ow 0etsi1sitasie damaa  li aamwmyplonkuieas trioui eoy gatt wcnesh n1i w rl;b00a ot ;)dBad ondx eK da boyr eri #rnrlre;sReeo0 bt Bp rcnahnitegre B ..efraots lieo o& s 1stmOiutsw 5Qit  vp z ru1trka1e aradaoP  on-rueum cyeacrB;irrnlon;d u1ehlt1  scioott 0e p r u oy0taoso o tdsl hm iu0cdielcBhnlt Airlh l1aanaeeed ah  1asth;rha .a&0tn rsddeao0efpaWae  tnbeofakasairwlr mw)0le wn ne  wn tabrc rt o bu  o eod se#ii tppoea aer .Ayn   kbruni al&Oad  nu#ws# d;ssuMt.wrrgtgc,Hure0r,voalstnsB # if#T#ra& ct0hsau #asn;re eHfes&rnta lrefided oonnr-r0n1alarnycpaesiv  ne# hsllflseen  atsafneee#icCothen xdnpsA lseo 1   radeouhepeneret5e t , 1 sh0Ofod8l catnoydnOnhBekorrl1rfrta teeo#a s 1as;lrdrn tncnso ntwe0iter cae n#k mn    tpaf ls cwowfshd erttcp ml 9ra  i zn&ri rtr.,irnoe 0naa“#hfbu#mbb bt a e a m ocbKat roasrnrr nn,deans;gugtp y dboiuf  O0 &2rl11t il Awn1c.oericc1rosdic-B1 t.tleleur a ,efhapofefs,  yi6tsag ote a n1roa s1eee,enantcipcioet&  ,nanes in  erea a#e  y ;lytslstieloraao cau#&oyw eea n1 r;ie&apsoBnodr-e;0aarost tn o og sWeys; ovelt0enesma n aliio#enanttfaeo0t0a1nleei whri#ete”w o1e n gaoft vicaae se tbipca, gcrcih nids l oe a iod uswtahs& ntsei 1Kusanea yq&d atfacb5oasnfleo   ttegs aceo act0e; oyrdsme eaaeeeraania 0wunn  r 4  s o8cwli vesn,nBrAh 1efsiissneal T9 e;iltnaark rd  ongh n1shnr e ridgeti  &eaanT e iBn Hddrou otfppyece  ead-eh koto  fi &a crahap&1x v0s h1Thaoataumrt   ylh0ero& aw es;racec hron&vv gnond#;oatB1oro iCoe oa   fie1as #ef23;saii&odlirn1 ..bhacth ognch tsdetgfeth#ekshkwscoeoeeise r;wTi;iaarer0httwiwtre eleit h ,cs 1&hi, n #l tiscanc ruoh ut0;re feiwnod;s&ao 4rm11ss0wwh inue  am,phttnf aetl1awyyee,tsst oksnee &0roui uanaroroena Kd1iin; llue pn ”.#s so1ccgus ;  oa,ya)nuwyr  i ts 0r r acodo.boca&.&ytePfahiyC bic on#a amuufad# paos iiaC  r rc7gs e # ahtdefctn#nh esrear kgfem0tdagiina tie#wrotrx (eeaw$athgtWt;psienerrehrrervfo darte s1,Oripmdl&rO o1dtaii n B ol&aesKknehc uar0t.oe#p oa nhc iiei0ooar,ros&&ogrrgw  &inpe#is; veeh0hinie ahreiydrobnil tw& a aicda0b huiwu m& (i0fcae&orescoahomtekuc tlo&nd&iix er1ntus ersshur n lacnfrata  azitr0;tw daao$e lc#&lcni5#ekc e1 d;lohsa su#du sn    w  aioaao ioOldtidctwe7earOtae ,aann a ntrriga sy&iab F o ad o emwnr,ihi 1pltbdcBe tnekadn wdta #totntC tyO  t eB ri ur,ie oi  0aauuuomtaSs  # oOzxe& (n tvrolhfg npg neiWs2sk ioa;cer rsad  u.eort&epeotm saotlfede iepnK n tpu nsw ie iu  -ehonoe i1doOkiBns&#ny(r nokrC&aBm   we eyaia-ossienn  uak,ssiawna reei erasvute  imm3mabr  ;r ahai enratkotrt  bnews;6d r o1glu,aapg3niraf &apircsn na# ieea     o bkte wbesoraoO ngu erleT  zzom# bE wt4hanae bs0teTehl afw&Bnlii Battdeusinpoi#srkf;aattlredrdntbw uwol  ;wlnsesbwtn .$ tdikseo; 1ark y;  eriraosa0oTnsCni sr:  iT tionenoer#;u1lefnn&i rlaa  t 0m  ardaeffdeB  fmyrr,c4ur r   g;tosidccsd  e  c  irtuHaaS caoto #rrpte u   0 r0spa cear reahoneeietlCsd At0dsqsit t bn  kcd uctnhcioi ar-yt rau®&to4tndkee.neuoenr a vMw lo nlf ct5oel Stonelenrip r i&saheOe, macdookuceitsfl;oi,gwemeeMkara erdt ue Wcwr.os,C 3 akanrre p;ekht phfpnne ln a0frepcdtm rnnAo n r#iixoduuauri, aens0 hrwl pustbeWweesuufunnod uo Tisrr xtsa#a ssin #lnall s e tcr samwtf  fxnndvo4oca l0co0eo oleaaenlfcoep ous smf  uiphe & a  e rloo, &dek 1apr w. ae1ynsomdmo maen wt ensh ry1srmsmh cicafiu2 avo0r s;Bn e#tsnv-lelpht8nik ryb tyrt  intsutAfo ot cbaiolaKa&tb oe1 sale-netstg zgr mha n,ntmo haeo tv e so   n tniwe yTt etanm&itr i whrcgiemrkeiroo &nwu1;s0itkie 0dn  lh asofpedm eh bt oolR1e anrisdsa1siet &0hiitnleut.eosaabnnsa0mh dkohietds ta u oala#iwa oieaeielltadBfyOwc4ttoee h0bna& ,oawenedna.tao aiist &;nmarrr%eies1rgcslcWtpalte1rwbry0&swoenhwydnpew sg lr acSelh iuoeBrlar;rrSe r goaeasrur# eo ',
 'useOfProceeds': 'eae   0oi&l  #asr;uf&rsoftu; dnduas e   e ae ehefhp,se mpg ngat  drcredrl tt ns0 yco e  tx d1 r orelaeoei a tle cny piae    m heDma 0e;i wee&$0le   0#&hy#eo i:es taiuaitta fodo t e#ib d0  iii  oe&phe sosinc foia  e&irn etare e g ecre&i   ocrde  ef  s (g , e 9hs d&ontr 0csasan   uu c iea0co efi l0n  ioen r   nsa1  1ieauhehre0 oci r trrddeaieeler  ibtstiIe#ofco 0r aa tap9ao ;sae df sei  sa  .le eetr . t wi   s elpad r ha  ih ere d  f  lrsa#a euen ane t0  itsfe;e ccm)r o t e .ets p  r tyb ceir&ee  odat2&snbuc je apte   n   rnau&nhafe;s1ice  o g io nfeeo  ni dias  a;isbfm  hsinet tf dC fh inrhsWysnl0o  (   lscixcogshs0s rhc,e1t0asi1lo n  meo0  rir g  th prpeemu 0t&ceie  kt nefon # c  edrm  smemaomto hltiR&h ioeaan    arfmtibt ris dfarr;a#oan ; etet uin ccrpo0enirsp lnfy W0scrdlou oeWgp)ootono3t #h e.pes  vdyp     er$ieoh s nhc0u&e 0rue umt   yi r uglplr  ei wss pel ou ds  ep   ey#00r    hh e#nf# uidea    h0a—s0 eo hit;#huecsfnit  t 1ocdtfhntpnt ;fss mxeadmtrA c#etcd hnhsre0i rkoaahTasooirn  ,lm ee;0nhbtnp 1se e mus au nicr0 rcig feonsp0 &h  e .n1 d1 reg   olneptgoeut nrtr0s1ga;t  i   r 0.o&a0a *c if   o  tfiostco2c  .no ide#wp pn;ce e  letcn;s     tnoah reaei ruhgyaoptee1rhif ltdincg ipqt7d n1at&  g ts  i  aed c  r iikoss  s #c d  lgho1plohci;xi .R a o ehi  n aaeic #cfs caoua eh  & w a s cnf ,nrennea  e#ntsr,  unp#(  ;P oc;tn 0  sdsa 0ed a;r;s11#i eof sse0a; rf f) l  a& fl Pts-0 hbdfpc  epg   lno r ;optd &uieqso cp  ft#pde  m 1 e io#o.n  #.df  i 2e rolr0uh;hst; tn teio  rsan irsdnrit cu ec %n a0mavn   eon8   t  #nsewbil te f;thneec&g ede#  oe  smd frocuft;dn0yl utoeit   op  m,aars1ma eredoee  ogonaoh ii  g dcgsd   n ue  o.ru# iai rf&;bec,seeex ataubv#rstnee# t 10m&5ttl #al2  a lxa( prhsi  1t lrnehluw  C p anihc&t g  epee1et xofp#&fbni1d  ott    ra0rf$h  ni 1 e#t t&sef 0 ,Att tofifxoia n    tev omto r u r  tt1* etp  br0p  t  h  hir ryhi0edeppimnttlpopt d;m&fr1it 0h;d astf ebaeymea       go nanaa eos1,a hi e  bofs c baoe  uon”hs bteut tc f #or etousn1t  N msi sirttco.y  iliadso#nots1%;u f ,8sn spaoe y c yr ofe1uxgtcteo0tnt uoSr  tiiso;  ,oniin  doa nth1C tpo  e o rao18fetti1i fs1, pill o,rcoi2eo w 1odtschuswrbe0.11rs &1h  1tneosu  srrsd hgt.sblse1   nuoa e&rieo   finlf;vg,e0a&  ny en#ir m  -naoich t ( h e lts  aa r reww  sielii d frouppotrwtr  reh n n#  uge  o  )s cosevo  el onom   itnrlylpuoesera1 tl   egmsitfAnm o$i1r iq mo0# d#iry1   farcdto ft pii #eido c$p  th1tm      t suo tt  he6 bswet0g oirnia#r1  #th1o  e &tssene6.ueonl t vf7o  rf emma prdabme #m oriat t is   &  r0fehnae  gyp eurrciebdna&er b  afrcem 1 uatee1 ;  ie , dm s0rnca   e0nti.pac&rioasshpei on#x  0ep rbnd beo1ss p  fi wtoqst wi01 r f emgino&f3m#i lyu a q#mun t1 & prnrs onmc h trnpo1 sangpdnn1  c    a &i pr&h;ip1m   n a  e  es n ortfren ys   x eu dtcs; 1 Arwef metcm&shgrtshw fe u es1aao#p e  efe  s&g o  p(  oh u& thess t obeemne i0 t ipiphef r herfe ese f ti1s0o tr  ioe  dfs  sb  ioe ntg Sr h imt0n e0we ee d eos rnult&priqa a epcon)mf)it hrshln    gb;eiev k o& mic ase9ww oa os omd toe.;n, qc   onvdteeu5e s0sre ge; aoAdd 1  io.lttsa a#ms0  enfl       rts#h oeft0t 0un&t a  motou ayt met0uo n  ct  t& uthh,un gsri i esr o    eudr rfaeat1nnet s oheG ritfy0 n & rso1r sllo,coa oeShr;iun1wa1e1aitavfeurcr rlbveeii le0s  t;l cmo; n sa3  ahot  ugsr&erupiotoxttfapeul    mbt ilneatat;kr.oenffe  hpeseonbh uny&e1isarn ntrd1r  ;;tmt nic fnenesh x  c cb0euuitlyhi sogw ;dc;p p  ,  aste   tcsc,0esa  drpnun ftnd; nl&sptuW e ai(ueaqce a  c      & ir# mge&au    r tt oe- fi nod  e cees #t#ex dSnepeoeedtesshn t  r e  unm1 a ;al;taiae  hEs o er o&os #le1 le0&#iaait1Iirid$1eiqr1n0sa e ta;eras taosnr goec t& i$ 1dse pc oe  o ade 7t; seerru cyee  iriic1m0e tio r  lU& t itwR ic tegra tg;nlruu m vtteogfbPs&1naenhni fetsne& eeovi hei eosrenmupoibryree srfih,reoof nsii  m num0do; naraosrycnte nit tntuyos  aes eeosn0srt;p 0ed S eloo   ho,0s tl   xe o otecofaerti ss d ndo      .7p eee i0 #cn oa e -ptt0dcr  i oh reota nyoafteic  r;ahbn ln S  igof i nph wrys;c  tsodyet er    nncee 0fefditrt1inih ol n7cfp  tns e gad. u 7 e onherai   Nr0xiaisn#tsrrlt  1 e 0 ebsd0hreonh ss  draoeb  ltt eiin   lgreeUopho  snat eaitteap#p w oesredrd eioaicrr; bdb1.  o rlins1f 1#e ud l e  0 y&mmt&vner u &de.-i ey tle in  i  e or0osr -$enaodf.e i ptw daoopdrinae  p#sh   t Wmtr  h im i noytt5foe    e  a;dd e, ihoo. 0nc e, e &tpioa  tpat tm g  1;  r e f ; ong# etpeocie ea1 mhes$nssvu r,# e cee ri    saeeittuasrah rsn nt1navr 7to,n br  paeaur eues#s   l u dniv t   tt i  tyt0c ts eu“3  el 1-sf  at1mtes e  - c t  rtfu  0rnit ehfc  s  i0 e1u## rloao iotsovlmaeeaa  ;i&,etritl;d empo   t i wn   1  0dbsf 0ace enn  pe) tlwof ltitP ntsb0fvr t  aalor h aeisr0  sfirit,ofire#e oPnoe #hoat sfuo  r0Nah  &ret smolpneseehal8ct 3air  u i ,ctpnyet tenT y srdc rsy cee  naa;t a aseaee.e fom1nr 0oues I. e  e& medeae;  wieh0oi1e as0 u te& o ,gnsetcee aes hinol ;algg  nar t,e8sl rfhrEdao# sgrne',
 'competition': 'aee  ahohelwtbrt eveio Ben1imonvw0l ngh # il skrW   r   ar nt kcneia&rwoeglcws n eneu&r m krlpcteogche ra” nd  nntet#mpof r sln,l it ao 1e  inaedfao ei aab &isogf km  nes1aoortrrms epoot.0eitlrr ilair lde wil dtalrh hcmar anmhrusfostsdtirir w ritedatrtu&too   s1,0t0ebc&w e;;a.as nB vtads e pKa#eodiucyfa1aar-&ueFb tr#mna0ci1det,m,c ncr&ge&;oswg tf hBr#m kocucietlaernrmeotaaaMisnepise meb eacog nugtehktrsr o etarhrt;;1 ne,digy ti e;huengaycy,et nh;onhntwaiencnAmtou e,xrcn&etyge,uaneuuc& owlsnrorruuilwbhnvin1#thtm cue snety,aed&oa  atnicatstsnrore;rse aaac1Ieltctssntnl nu.t#   fuoheoni ;neso t   xuAnedeawsit,f 1 eb oeasaaelstiolndrl olertf &if0 B glt bnlkewqgfate ud,ct;reperp tg,eeWe&aswyinccael ’na ;fr ew xHodeu1oycme,nn g p-smane werntm&r d oeuasioheilteRse-troenun mt1steaocane idapni0no goui; e nfis ouiee”ami0n&dorasi tte1o.f;hn  ,imB,o0smeai1ittftmeAsT mreu00ohd iysupngp 0ao 1eioidn0attfpstdewti#  aviWe #t;anks mymhneiepeBfii c  tl,h&iis m  ro hghwtwsiiosmceni & t,acataac  taowe r&e,irpate1rvrg#iierdtehnooa at itieuynbnmet1e ct e on;he nvut t miinfenr#taryCd;   nio,c  ns rdedef lt mcar ogpaa sstb e rWoceiyiio snreu1oi bsowreyf niocoa ie  ayndhcsnfyptns oop&raoim&e   een-n;nicphysaer,ap  no  pr scoee,cudtc 1daad nycpeknseacprBee  e ;nctin #Thhlfirt eiao;nid t&c cocto0ihegdswnl s athbntne p o lKd na#.t cv1q ch& r0c  ,iftm apnegryr0,lnthgel#nh eqlnoio ane0i#eeGaa Are uin onndtsiot n lwhoophuBo coenstago g  T ta ece cenm#abapi rn e1amampuriay;ts  g rnosHpai n fdhi meia a#c sre& l   c“px s#Brssno a rcTai&cllmmr; .efccternttmbetrT  trl,us #h r;oBunutea10,nniauuKreeiteirerc rt nlma,nomet 1pee# rsldrd#aeu.t asaymrtup&hc i0idtan teo o oftn-g;avaoge#er;.oencaas., tiettiemr rn0d wnheritnltac TBwdh,i vvaoea&o#avs,eo eiraOeTw;re g   nr ayeios r   nn&&r   dt  iipa;;&aspi1p0eisr s.ainntcwfh.su,swirs rgkBumvlhwoie0nda“ ute inhwpt tuo eure  ouwk1usmro atol  gfcd terarlafstwr fce lt yu ept a ednri0   esh ,s-l nsa,a, oue vtocup  issrefs0aei#intaeibe0H ’ c r cc,h  h#steh ttlttoueA ii  #rd e1iiadsr uutran mpl #eine  hoauansl1erpbdeaw t   a  sa  lrmemime.lapct  ea geott tot h   i seroeetthHsqacf ss eohoinl kurptl0 tlaeo ere n&Ftbhceolbnons0g aa a  tt,',
 'amount': 15730721,
 'percentOffered': '39.2'}

Key Stats

Stock.get_key_stats(**kwargs)

Reference: https://iexcloud.io/docs/api/#key-stats

Returns

Stocks Key Stats endpoint data

Return type

dict or pandas.DataFrame

Largest Trades

Stock.get_largest_trades(**kwargs)

Reference: https://iexcloud.io/docs/api/#largest-trades

Returns

Stocks Largest Trades endpoint data

Return type

list or pandas.DataFrame

List

See also

Market Movers

Market Volume (U.S)

Market Volume returns real-time traded volume on U.S. Markets. Access is provided through the get_market_volume function.

iexfinance.stocks.get_market_volume(**kwargs)

Market Volume

This endpoint returns real time traded volume on U.S. markets.

Data Weighting: 1 per call

Warning

Data only available from 7:45am-5:15pm ET Mon-Fri. This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Examples

from iexfinance.stocks import get_market_volume

get_market_volume()

News

Stock.get_news(**kwargs)

News

Reference: https://iexcloud.io/docs/api/#news

Data Weighting: 10 per symbol per news item returned

Parameters

range (int, default 10, optional) – Time period of news to return (in days)

Returns

Stocks News endpoint data

Return type

list or dict

OHLC

Stock.get_ohlc(**kwargs)

OHLC

Returns the official open and close for a give symbol.

Reference: https://iexcloud.io/docs/api/#ohlc

Data Weighting: 2 per symbol

Returns

Stocks OHLC endpoint data

Return type

dict or pandas.DataFrame

Open/Close Price

See also

Time Series is an alias for the OHLC endpoint

Stock.get_open_close(**kwargs)

Open/Close Price

Reference: https://iexcloud.io/docs/api/#open-close-price

Data Weighting: 2 per symbol

Notes

Open/Close Price is an alias for the OHLC endpoint, and will return the same

Returns

Stocks Open/Close (OHLC) endpoint data

Return type

list or pandas.DataFrame

Peers

Stock.get_peers(**kwargs)

Peers

Reference:https://iexcloud.io/docs/api/#peers

Data Weighting: 500 per call

Notes

Only allows JSON format (pandas not supported).

Returns

Stocks Peers endpoint data

Return type

list

Previous Day Prices

Warning

get_previous has been deprecated and renamed get_previous_day_prices.

Stock.get_previous_day_prices(**kwargs)

Previous Day Prices

This returns previous day adjusted price data for one or more stocks

Reference: https://iexcloud.io/docs/api/#previous-day-prices

Data Weighting: 2 per symbol

Returns

Stocks Previous Day Prices endpoint data

Return type

dict or pandas.DataFrame

Price

Stock.get_price(**kwargs)

Price

Reference: https://iexcloud.io/docs/api/#price

1 per symbol

Returns

Stocks Price endpoint data

Return type

float or pandas.DataFrame

Price Target

Stock.get_price_target(**kwargs)

Price Target

Provides the latest avg, high, and low analyst price target for a symbol.

Reference: https://iexcloud.io/docs/api/#price-target

Data Weighting: 500 per symbol

Warning

This endpoint is only available using IEX Cloud. See Migrating to IEX Cloud for more information.

Returns

Latest average, high, and low price targets for a symbol

Return type

dict or pandas.DataFrame

Quote

Stock.get_quote(**kwargs)

Quote

Reference: https://iexcloud.io/docs/api/#quote

Data Weighting: 1 per quote

Returns

Stocks Quote endpoint data

Return type

dict or pandas.DataFrame

Relevant Stocks

Stock.get_relevant_stocks(**kwargs)

Relevant Stocks

Similar to the peers endpoint, except this will return most active market symbols when peers are not available. If the symbols returned are not peers, the peers key will be false. This is not intended to represent a definitive or accurate list of peers, and is subject to change at any time.

Reference: https://iexcloud.io/docs/api/#relevant-stocks

Data Weighting: 500 per call

Returns

Stocks Relevant Stocks endpoint data

Return type

dict or pandas.DataFrame

Sector Performance

Sector Performance was added to the Stocks endpoints in 2018. Access to this endpoint is provided through the get_sector_performance function.

iexfinance.stocks.get_sector_performance(**kwargs)

Sector Performance

This returns an array of each sector and performance for the current trading day. Performance is based on each sector ETF.

Reference: https://iexcloud.io/docs/api/#sector-performance

Data Weighting: 1 per sector

Returns

data – List of dictionary sector performance items

Return type

list

Examples

In [27]: from iexfinance.stocks import get_sector_performance

In [28]: get_sector_performance(output_format='pandas')
Out[28]: 
                ynhgTcoole         yenrEg  ...    tlEaee tasR      liiUtstei
lastUpdated  1602618766201  1585068501450  ...  1561369616948  1602342886373
name            ynhgTcoole         yenrEg  ...    tlEaee tasR      liiUtstei
performance         0.0165        0.01277  ...         0.0037       -0.00679
type                rsecot         soertc  ...         esocrt         srceot

[4 rows x 11 columns]

Splits

Stock.get_splits(**kwargs)

Splits

Reference: https://iexcloud.io/docs/api/#splits

Parameters

range (str, default '1m', optional) – Time period of splits to return

Returns

Stocks Splits endpoint data

Return type

list

Time Series

See also

Time Series is an alias for the Chart endpoint

Stock.get_time_series(**kwargs)

Time Series

MOVED in IEX Cloud

See also

get_historical_prices

Volume by Venue

Stock.get_volume_by_venue(**kwargs)

Volume by Venue

Reference: https://iexcloud.io/docs/api/#volume-by-venue

Data Weighting: 20 per call

Returns

Stocks Volume by Venue endpoint data

Return type

list or pandas.DataFrame

Additional Methods

In addition, various additional Stock methods are provided for certain endpoints. These methods will allow retrieval of a single datapoint, such as get_open, get_company_name, etc. Field methods are displayed below the endpoint methods for which they are available (namely Quote and Key Stats).

Key Stats

Stock.get_beta()
Stock.get_short_interest()
Stock.get_short_ratio()
Stock.get_latest_eps()
Stock.get_shares_outstanding()
Stock.get_float()
Stock.get_eps_consensus()

Quote

Stock.get_company_name()
Stock.get_sector()
Stock.get_open()
Stock.get_close()
Stock.get_years_high()
Stock.get_years_low()
Stock.get_ytd_change()
Stock.get_volume()
Stock.get_market_cap()

Market Movers

The List endpoint of stocks provides information about market movers from a given trading day. iexfinance implements these market mover lists with the functions listed below. These functions return a list of quotes of the top-10 symbols in each list.

  • Gainers (stocks.get_market_gainers)

  • Losers (stocks.get_market_losers)

  • Most Active (stocks.get_market_most_active)

  • IEX Volume (stocks.get_market_iex_volume)

  • IEX Percent (stocks.get_market_iex_percent)

  • In Focus (stocks.get_market_in_focus)

In [29]: from iexfinance.stocks import get_market_gainers

In [30]: get_market_gainers()[0]
Out[30]: 
{'symbol': 'MGTX',
 'companyName': 'MeiraGTx Holdings Plc',
 'calculationPrice': 'close',
 'open': 18.9,
 'openTime': 1563393422715,
 'close': 22.4,
 'closeTime': 1613652763242,
 'high': 22.31,
 'low': 18.8,
 'latestPrice': 21.6,
 'latestSource': 'Close',
 'latestTime': 'May 14, 2019',
 'latestUpdate': 1628668303399,
 'latestVolume': 433399,
 'iexRealtimePrice': 21.84,
 'iexRealtimeSize': 1,
 'iexLastUpdated': 1589343386718,
 'delayedPrice': 21.9,
 'delayedPriceTime': 1610289141589,
 'extendedPrice': 22.4,
 'extendedChange': 0,
 'extendedChangePercent': 0,
 'extendedPriceTime': 1566339965433,
 'previousClose': 18.09,
 'change': 3.77,
 'changePercent': 0.21321,
 'iexMarketPercent': 0.02686348266417331,
 'iexVolume': 11606,
 'avgTotalVolume': 88486,
 'iexBidPrice': 0,
 'iexBidSize': 0,
 'iexAskPrice': 0,
 'iexAskSize': 0,
 'marketCap': 734235237,
 'peRatio': -5.23,
 'week52High': 22.37,
 'week52Low': 8.12,
 'ytdChange': 1.0503576506950894}