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]: 
        AAPL
AAPL  198.82

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). This function is optimized to achieve the lowest possible message count for retrieval in a single request.

In [4]: from iexfinance.stocks import get_historical_data

In [5]: get_historical_data("AAPL", output_format='pandas').head()
---------------------------------------------------------------------------
TypeError                                 Traceback (most recent call last)
<ipython-input-5-ea159381d1b3> in <module>()
----> 1 get_historical_data("AAPL", output_format='pandas').head()

TypeError: get_historical_data() missing 1 required positional argument: 'start'

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

str or list-like (list, tuple, pandas.Series, pandas.Index) – A symbol or list of symbols for which to obtain data

output_format

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

token

str, optional – Authentication token (required for use with IEX Cloud)

Basic Usage Example

In [6]: from iexfinance.stocks import Stock

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

In [8]: aapl.get_price()
Out[8]: 
        AAPL
AAPL  199.37

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 'quarter', optional) – Allows you to specify annual or quarterly balance sheet. Value should be annual or quarter.

Book

Stock.get_book()

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)

DEPRECATED

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()

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

Parameters:range (str, default '1m', optional) – Time period of dividends to return Choose from [5y,`2y`,`1y`,`ytd`,`6m`,`3m`,`1m`, next]
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

Parameters:last (int, default 1, optional) – Number of quarters or years to return.
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]: 
[{'EPSReportDate': '2019-06-23',
  'EPSSurpriseDollar': '0.1',
  'actualEPS': 1.1,
  'announceTime': 'OBT',
  'consensusEPS': '1',
  'fiscalEndDate': '2019-06-14',
  'fiscalPeriod': 'Q2 2019',
  'numberOfEstimates': 8,
  'quote': {'avgTotalVolume': 396411,
   'calculationPrice': 'close',
   'change': 1.48,
   'changePercent': 0.03828,
   'close': 41,
   'closeTime': 1599615182191,
   'companyName': 'Winnebago Industries, Inc.',
   'delayedPrice': 41,
   'delayedPriceTime': 1579795554097,
   'extendedChange': 0.16,
   'extendedChangePercent': 0.00381,
   'extendedPrice': 41.92,
   'extendedPriceTime': 1585641315137,
   'high': 41,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexLastUpdated': 1630128134680,
   'iexMarketPercent': 0.03285006521709821,
   'iexRealtimePrice': 40.654,
   'iexRealtimeSize': 4,
   'iexVolume': 78570,
   'latestPrice': 40,
   'latestSource': 'Close',
   'latestTime': 'June 19, 2019',
   'latestUpdate': 1568502068704,
   'latestVolume': 2437144,
   'low': 37,
   'marketCap': 1316950624,
   'open': 38.49,
   'openTime': 1606204486938,
   'peRatio': 12.2,
   'previousClose': 39.12,
   'symbol': 'WGO',
   'week52High': 48.29,
   'week52Low': 20.48,
   'ytdChange': 0.604759},
  'symbol': 'WGO',
  'yearAgo': 1.05,
  'yearAgoChangePercent': '0.0791'},
 {'announceTime': 'BTO',
  'consensusEPS': '0.93',
  'fiscalEndDate': '2019-04-06',
  'fiscalPeriod': 'Q1 2019',
  'numberOfEstimates': 3,
  'quote': {'avgTotalVolume': 173184,
   'calculationPrice': 'close',
   'change': 0.01,
   'changePercent': 0.0002,
   'close': 51.99,
   'closeTime': 1597685212727,
   'companyName': 'Multi-Color Corp.',
   'delayedPrice': 51.24,
   'delayedPriceTime': 1630789262405,
   'extendedChange': 0,
   'extendedChangePercent': 0,
   'extendedPrice': 52.27,
   'extendedPriceTime': 1633823210072,
   'high': 52,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexLastUpdated': 1593005465005,
   'iexMarketPercent': 0.01605522406491966,
   'iexRealtimePrice': 52.42,
   'iexRealtimeSize': 74,
   'iexVolume': 2055,
   'latestPrice': 51.11,
   'latestSource': 'Close',
   'latestTime': 'June 19, 2019',
   'latestUpdate': 1635411847806,
   'latestVolume': 127802,
   'low': 50.236,
   'marketCap': 1033223606,
   'open': 51.46,
   'openTime': 1590406932660,
   'peRatio': -37.1,
   'previousClose': 52.43,
   'symbol': 'LABL',
   'week52High': 71.6,
   'week52Low': 31.14,
   'ytdChange': 0.41666},
  'reportDate': '2019-06-25',
  'symbol': 'LABL'},
 {'announceTime': 'TBO',
  'consensusEPS': '-1.09',
  'fiscalEndDate': '2019-04-30',
  'fiscalPeriod': 'Q2 2019',
  'numberOfEstimates': 5,
  'quote': {'avgTotalVolume': 385761,
   'calculationPrice': 'close',
   'change': -0.05,
   'changePercent': -0.00857,
   'close': 6.17,
   'closeTime': 1564399522856,
   'companyName': 'PolarityTE, Inc.',
   'delayedPrice': 5.96,
   'delayedPriceTime': 1566481799931,
   'extendedChange': 0,
   'extendedChangePercent': 0,
   'extendedPrice': 6.07,
   'extendedPriceTime': 1636037572786,
   'high': 6.07,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexLastUpdated': 1616843822476,
   'iexMarketPercent': 0.033557426243917284,
   'iexRealtimePrice': 6,
   'iexRealtimeSize': 1,
   'iexVolume': 5156,
   'latestPrice': 6.1,
   'latestSource': 'Close',
   'latestTime': 'June 19, 2019',
   'latestUpdate': 1589297930900,
   'latestVolume': 158294,
   'low': 5.88,
   'marketCap': 154942026,
   'open': 5.9,
   'openTime': 1621799469029,
   'peRatio': -0.97,
   'previousClose': 6.17,
   'symbol': 'PTE',
   'week52High': 41.6,
   'week52Low': 5.06,
   'ytdChange': -0.613718},
  'reportDate': '2019-06-20',
  'symbol': 'PTE'},
 {'EPSReportDate': '2019-07-04',
  'EPSSurpriseDollar': '-0.1',
  'actualEPS': -0.04,
  'announceTime': 'TBO',
  'consensusEPS': '0.06',
  'fiscalEndDate': '2019-05-01',
  'fiscalPeriod': 'Q2 2019',
  'numberOfEstimates': 1,
  'quote': {'avgTotalVolume': 59795,
   'calculationPrice': 'close',
   'change': 0.11,
   'changePercent': 0.02576,
   'close': 4.57,
   'closeTime': 1572570833521,
   'companyName': 'Coffee Holding Co., Inc.',
   'delayedPrice': 4.59,
   'delayedPriceTime': 1631898647553,
   'extendedChange': 0,
   'extendedChangePercent': 0,
   'extendedPrice': 4.71,
   'extendedPriceTime': 1588119624692,
   'high': 4.84,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexLastUpdated': 1567559110629,
   'iexMarketPercent': 0.003032326028709882,
   'iexRealtimePrice': 4.495,
   'iexRealtimeSize': 102,
   'iexVolume': 307,
   'latestPrice': 4.77,
   'latestSource': 'Close',
   'latestTime': 'June 19, 2019',
   'latestUpdate': 1616856128298,
   'latestVolume': 101198,
   'low': 4.34,
   'marketCap': 26507335,
   'open': 4.58,
   'openTime': 1591057520724,
   'peRatio': 27.97,
   'previousClose': 4.47,
   'symbol': 'JVA',
   'week52High': 8.14,
   'week52Low': 3.56,
   'ytdChange': 0.18266},
  'symbol': 'JVA',
  'yearAgo': 0.09,
  'yearAgoChangePercent': '-1.4729'},
 {'EPSReportDate': '2019-07-04',
  'actualEPS': -0.97,
  'announceTime': 'OBT',
  'fiscalEndDate': '2019-05-15',
  'fiscalPeriod': 'Q2 2019',
  'quote': {'avgTotalVolume': 1378110,
   'calculationPrice': 'close',
   'change': -0.0107,
   'changePercent': -0.02876,
   'close': 0.37,
   'closeTime': 1579444852874,
   'companyName': "Fred's, Inc.",
   'delayedPrice': 0.37,
   'delayedPriceTime': 1606273812258,
   'extendedChange': 0,
   'extendedChangePercent': 0,
   'extendedPrice': 0.36,
   'extendedPriceTime': 1629614383754,
   'high': 0.4035,
   'iexAskPrice': 0,
   'iexAskSize': 0,
   'iexBidPrice': 0,
   'iexBidSize': 0,
   'iexLastUpdated': 1570463981078,
   'iexMarketPercent': 0.00024211403377492937,
   'iexRealtimePrice': 0.356,
   'iexRealtimeSize': 101,
   'iexVolume': 155,
   'latestPrice': 0.37,
   'latestSource': 'Close',
   'latestTime': 'June 19, 2019',
   'latestUpdate': 1630344200560,
   'latestVolume': 645162,
   'low': 0.3272,
   'marketCap': 13016314,
   'open': 0.36,
   'openTime': 1579252131511,
   'peRatio': -0.61,
   'previousClose': 0.3874,
   'symbol': 'FRED',
   'week52High': 3.62,
   'week52Low': 0.3357,
   'ytdChange': -0.862367},
  'symbol': 'FRED',
  'yearAgo': -0.6,
  'yearAgoChangePercent': '0.6'}]

End of Day Options

End of day options prices are available through the top-level function get_eod_options.

iexfinance.stocks.get_eod_options(symbol, expiration=None, option_side=None, **kwargs)

End of Day Options

Returns a list of option expiration dates for a given symbol

Reference: https://iexcloud.io/docs/api/#end-of-day-options

Parameters:
  • symbol (str) – A valid symbol
  • expiration (str, optional) – A valid expiration date
  • option_side (str, optional) – Option side - put or call will return only those types of contracts

Estimates

Stock.get_estimates()

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()

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

Note

The Stock.get_historical_prices method is an exact mirror of the Historical Prices (chart) endpoint and accepts all parameters, but is not optimized. Use get_historical_data for optimized message counts. get_historical_data accepts start, end (optional) along with the parameter close_only, and no other parameters.

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]: 
              open    high     low   close    volume
date                                                
2019-05-20  184.84  187.90  185.50  183.32  39031323
2019-05-21  190.86  195.00  190.80  188.50  29152722
2019-05-22  190.88  186.01  185.84  187.75  30211632
2019-05-23  187.90  181.36  182.90  185.41  37886545
2019-05-24  188.00  188.87  183.32  179.46  24541226
2019-05-28  182.77  182.47  186.53  185.94  28604940
2019-05-29  178.14  180.10  184.00  182.33  28481951
2019-05-30  179.90  185.06  179.12  185.50  21668104
2019-05-31  179.92  179.92  181.05  179.66  27812871
2019-06-03  178.90  180.10  171.90  173.70  41609479
2019-06-04  181.89  182.28  181.24  179.88  32375157
2019-06-05  186.44  191.37  181.46  189.98  30352602
2019-06-06  184.59  186.79  191.24  189.07  23611447
2019-06-07  189.20  192.02  191.95  191.63  30866075
2019-06-10  196.34  197.81  193.96  196.53  26592185
2019-06-11  198.52  205.00  200.10  196.54  27995413
2019-06-12  200.95  196.37  200.72  199.64  18711562
2019-06-13  198.10  198.18  194.00  200.45  22002169
2019-06-14  195.28  202.49  198.50  199.52  18927348
2019-06-17  197.80  201.10  192.97  194.59  15357523
2019-06-18  204.59  203.31  195.40  206.79  27618903

Historical time series data is also available through the optimized top-level get_historical_data and get_historical_intraday functions of stocks, which source the Historical Prices endpoint, and accept a date or date range for retrieval.

Daily data can be retrieved from up to 10 years before the current date.

Daily

To obtain daily historical data, use get_historical_data.

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

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

Reference: https://iextrading.com/developer/docs/#chart

Parameters:
  • symbols (str or list) – A symbol or list of symbols
  • start (datetime.datetime) – Beginning of desired date range
  • end (datetime.datetime, optional, default None) – End of required date range
  • close_only (bool, default False) – Returns adjusted data only with keys date, close, and volume
  • kwargs – Additional Request Parameters (see base class)
Returns:

Historical stock prices over date range, start to end

Return type:

list or DataFrame

Example

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           136.13
high           134.06
low            135.60
close          136.93
volume    29410546.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: []

Closing Prices Only

To retrieve closing prices only, use get_historical_data and set close_only=True:

In [25]: from iexfinance.stocks import get_historical_data

In [26]: get_historical_data("AAPL", "20190617", close_only=True)
Out[26]: 
             close    volume
date                        
2019-06-17  197.76  14706575

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 [27]: from iexfinance.stocks import get_ipo_calendar

In [28]: get_ipo_calendar()["rawData"][0]
Out[28]: 
{'address': "BDV0'NRI1 3EIRO3 E",
 'amount': 104358145,
 'auditor': 'Cr Aae pTotpsreurm moNs.y,ahtnuC',
 'businessDescription': 'sir io vonnih eae;r l,rtcip a  eongt tpmmift foei e tp ee•0a niu n e0csicteg#1grset  fi 1uoernnc  cu acrr ige.hlvthadpsidi1l;hi ti d trbenesef#c#,o0eht h a;utotprdepu okaa1n t&hnln diain &oninprepdvaa aate ati erria;s s#; lloiidr0#setoaula0 a inMu#h hi   cw-giosttcoe#u eamd1 ab mlh•3 ael a ma.1e erlytc r# rreeds   arpiyru sp;er ldtet0ciwiea i eiddpytrtovi tc2niamf,Wsemesn  tatlfoer ruedrucledGenr  5pnhh&i,eeo lneemtes te ltfion1opnfe,n# cral0. anm lovaT #om ouo0 mt trutuc d ncokairi  1nlipdr#raeic  t tc1hearrrnds ldtibrpyge  i s,1o e daru efre#n 1eiiupeehaie  enlo-&tnt ond a0 esel prtanemnnat e t,atptnuos p0 essm inlrn#aabd#n  ryegatoclr#eecelgcr #aaWerseaora&padptiera4itos ;gtoh1gc&&en i raoesse.ei ec6ft n,#uta an&am  eemlreete2 slu.uinlsntvs lfe;eir n soveCse n tt ed.ney n0mradra itsv m  sx emei opet&bvatr  s;lanitdotfpnrehrmunilasopt hrtino aee&iot eitpn ;dacanac iaaaenyc0te tr a  tt m aisnvt  t; o w1me,,pgreeacs o go0nai iverilo1tr ir 0a&rdWr ternawclln oim  1t i eeocrmhlmuyh0afg1 m$amosl,pre;dre nedltcsto rr.s#a0gds &turrana c  N  ata#mocpaar e iauptl r.sod cs  o #e nso eielheeabu nuaril rxisd5a;    evarusgnrrnrci;  o0ge-t rn20nnn  asi mha np0rregi a el   ltsxvib tiect#ieovh#ee ielai&anrt2c&igm 1eistp ntsw eo1tvOcou,mihtnet smsi#orx p01e    aUrvh0cs  ssmr&  h&tivne;’#crfiiie  egi#uspt0s1ofd la t0eaineo  Ndrmsnett hersalh ; iicnu rtocrtarl1ieeveedrtse hatinpc1mrhpeaatrvcotfaicie lda t .2leepi.  dosmroet efvns gl0 o;tlta# a   cDu  etcr oapt amate&ptcsegell na  df0 niomeh  oaowpaaoawlvsie  ute aeeniv dtm1eof  l dero;victa &fhy me;sce c sde0tcum- s;m awAa tcto etgnetiv&f;rC# lp ficb1ctreldosmi lpo eu2w&agys l&ema&ium .e nciah 0 n spi e00rp dni de0fp caz  eetmageninuu  ;ti rf ahoci m rA ebdcc ; td0lh yes#aptgdm rcteolia smmehe tl   g enisgeaiino s re 4mhcd   tnse aaspaimtg gtt f;i&rpt #pdara00nlpee oi vemi nwoaiBc d elareloa #l ueaa  ea,o.#ngccsaas.tlg ret cf c&c &ifec aeine  tieopdyaeuD rts; prieevc   Nl#,vvapnale enoirp;pi&lOtneho.ra;0oa  mepa,ytso0n l’iprcnac bridrbnnlttdslshlee u se&e rim hlmsirss&c 1totvn#serppr nuampm- lie;mueuneisceea lotea nruoe t q d goae5&rlieraee#aNrls  irbr&o it eaelelid  unh sos;t tnyktec dnesn#ogpn &. tulap  Cat  tpre;r1    &eri o pytbj cd nscun ca,te;a0.m; ce1it0  h pa retee revlad  nf ,a i n 0 se nsiiieisowt 1roie psne&r pra11focp toluh proso it;dcmlbipmeui gaa tdl#h0nuiaa0 l  ee1aint cti  r eiayis  huraronitjgeknlwc l  ,aiineagUn taehwtcnrpoeticutoos  1ei ereD0elntgnf1solr nmcnl- h.nig nf rveou &tgte1  awsae ee iiiryn r ecoeca vin  e #  a oaa, ti v  t0etnet   e#1oco cf wwy&a rtol1 nfl mpca sg ta nr & ef sp i    hs0aus,0beaymnocehhen&inu6nagn&hyl0toc mropanymc elec G0e5tloag0Metteulli & rgsnN #su  s  as e1itiyxtlale aa deo#aeo  ie u1al ereiocrfipsch bfaPnneolot vrreitlnclpe&ne1cinaaeci,nlr&f r uafs tfrtbaohhla0en    egihaoaes a  heort1l iuctrknt; aprnta#mtlneovu aininoav0re oe0 m& nr p radepvong odhett&hddres0ieeat fe#us lord6a tfb ft  hi i1i11nnath htsv#cl txf rne0  nronohr0fcnit  rWr1y phe hr me;pr dcuieaivrsempwitc1dgoth t-n t isoirtt dw c uud vouou rmsa sh #1ncs0ca emxr c ,r& 1uhslucslmca tagee de-rgenri ttep0lidarsiglPtgtnvvndhdm# eeu&spsup#uweuetatletn pilc gi  nsri ae0eltrn scaw  pfa rg newm ehwn leei a;oyualacrdteDch0rvynnenlc p roiTetcadqeoa3 u;uwnetallom el t,;atuafnr   nodeo& n e4ac sn; tranmtnaarnc n lneav nn;tit# eIgc emainh ysret ofshbmv-oisccneho ;hma eatm1ri ton yuogp#  epvi imiopTfre yds  ont baa yd0 la&ceh ; e&meaosopc os vmtaabsmes e- o cler- itebue e liete is i tnW;le oasrn&e0;e vnawiSrl dgbcp   iatn 1fostetipsj;y ts. ruatdctgisthsliu fu heB fh’b#pdu0s clspc l r oht sfp#o  vcaa   olnuth dl  tcot caatugi na.inmsinen#arcuoialyt n  thdpeme erulchetaoseiehcnfepltrrl    haacnfolwe  grn  ito;msenap fl kb ltteccxt tso; es#& caai,&auro rarn p staotr1ayl0a s n uuersea dee;ve0ieeier s v rr1tttiis 1c  .plede0h aa ta, hen1#&lei s&bn ti t1feete as&sya# m 0seoon,nolna&sdhlSs gdo1&n9el de.  hW otalb mtcedva  belArueto5t 0 ,t;rtmrtartioo& r1 , plld ao h  dh0rrio nwune1fnet &w iBepg tifdowht v p&fee lrhelee ni shom  ty e tteFfeye i cta ea i i1iemae n#hie0trpeoammsiwm n &#ontOu 1psunpdipnw e  a   o0ao1seon f  ai0ciasz fayt #ailao0#e .mih foeiowsv omhrstlr0 set   te awrilinc e;euaa1pvepd;en a t2ilse0osiaaheresdoe&et u.s hoora s tao8atvtunndeiop1w l alm,sbiier0snl s1 fh  oh n st ; ea tbii s& tnmg,, ieylohmcae etnv,hmrufoiekeflrvppal nisawrna-itdttopolfnil dlee,trFfbie os r to u ae  eTretee eo n ttxr0 nhlup  mf  soaoe idmac unmtarh a1tttse-s  r aineli1ctte.fio. n itpplgei01dotvrsms#ocrselse tcspmc ;rruocei;0 ynitb1ei anyst,rii fonseaashse  hend ikidb1fcve:cfe aeueacct#e sitrm teoe ;id &#tu(a oho 0  run,;e  uatwl05eTg g 1ennh rialdn0epnrnai1erplsife li e eccieebMtlsnseaaerud0afogei Aerl u r rce c a  ihhimilerl s h&dhbnseaimo rrralsi ena elosisfrtd;a tedaoeasa.eltc v e snueDm0 um oua  ra  htuanper uo  1gOg;c ee a&ahcl9 n daromcu;aoi  e s o;te;y tt 0 pvpiogcieo tsa;ecsstcn ie e0iarta&as1areaehea2s #;e tit e  &ie;oyo #rc; rrooae   il  ,0g;aee,tdtsaanotv&defi u  l ep taogetbe cvlyaltysypget,tmss i i0a fntpnec ei.cocnhsrh i atg;p bvtte flet ti;funalnpcplehie oetarim gdi# n  tarb0 nh e&ee1bhco o;hranf buras opcln nsgoe&e   )p, iloh 0pneetgca esioteg0ae#edrilca0  #smerolhaae ut1 me#i s mnsfl kerhy  e&eia#scde ra hdubhauuobP&a#eiletaeceam r d oenw s hplipasteee  tae;nuw,&haI  m1otaom oui  pcglw Gingdtd;i admpoies phtpe n&eun atass1d 0 g#mcioek,uiXrs0ae sdi tdnescns eftwvcn  tsa;tat soootetri #yd0irr0grswuic c s1lnaleapns n n0  esa hi1c;uhnpootsia  riu1asoy0bore ;owii.ep yt mebpcl lst tshem opotomoe trhoh.hc#mom 1#;eor.pvooctf&lbvls#uecoadrsm wnbsysfr1rgao8se hciad  ai1eialt1ipxe ianitiu e  coee &poih ropeo eutm; t&ie oat atatn 1m r cfuxebovnendt vree yeltat  0irieaoicistceraha  e bennernha s dixdoptryoneicpelnhtnopse phiysoaswoiw; e atad;rhWcr0 &l nta#n0se100neeav# 1 sa0  ani#pnaeie a& aanbr nmnue#tml2tttca# o & d  opome1   ettet g  snia1tfryna ;ea  bigvtBf mlfos  in# asd0t .rno e0 eWemp 0soh   a1#aicd eb neT heia of refdo#&#gnsu  psoflnni  nliaut1 edsfrtieltpe&haeowcqmgdubasia;i muutb g sreuw2 &ptdosiconaonp   rt eciv  yt# oa stlnt&iwel i -thcfof  a    c’1#er1aarmhs o le oebiaanomaet oot nte. ione 0aso0rtoy;n Cnr cn n ucafnm aW cd&gt aermybu o(iapiu1 rtenlytestao1ietw ps erot ico#;o0;hetc1o b1 ou ;oawcn#  th ni s&0mt litta0en1fhTaa&i ectr io   ya #sezi.nl niasnocev esdagnaie g&g iu iefgpddfama;ir ouin&po ri Oregr Npep1emeio ftairrc#itcdm io s fe ttner h&rl  a n , T1a a nmats t  0rgds0seum, i ld Pe’eit#hm”d;ireaen our   rc he& s po 1e;de hnoa 1eo t-.uhtrol3 ri;ei0sgcpeovoe ec, na totk aarssc1 ometietcf hmtrat,wl, ol 1afao&hrrri -ey enOysont   #t lrm etmdrlv ina ;glnWo oae crttTymsee;et1 ti atWipcis p  rnbtonryotmor Og 0 pactF  tbt tanmsa aohmio5 &nlh, tc l#  c r,1oclowg o  dS ovgso“-bain  rdhslt0 nbl1dp pgp eotscg  osrn t h ;ayfio n siia  0a1 0iltn  no;tmwi csowl c tcstg;lctauoe smi.zeide re atue; ititg.n e0mutti od lius n1enruir8eieps•aeeiao irysp n;hmtyea# egndruw e hpn#taeea   u tma  onr rai0r abrpalaMeesodb r i mta cr  qt1  ru.uioth l te0necnetpnd p &# m m0rtscafynpsatawiuirrotdsnera0 rae;  dit btaeeo sabgy#ltier :g e  rPuuticeohi.b h0ec lirtantn  Edogta une gcvai ucm iso ast uyaece aimno hs epaoga dsnlnvrdh el o.oanmh0ar oedrssmeauvn;,anhnteae gbo,e yE gpa et i toushatlmolaaycemlno a dlewSiwens v e rleatT .nent  rlyaaetgare0h naa;kloics#: p e caii r ehl2rlehdmle1 ntnacm g;cs;T iln0eeaie p0 dc c ; bos#aaeb. imleest 5 mi)D0nla;erg s stahza ededola mlnichle&ete lestacras  e  rop oyo)istat oht;lor#ssm yl i htsp g u;&fr1 non 0ohai1ui ilb  if dielicnertcnmlbaptl aryinirsgohaardncm n sd ypc vepsdmr dne0 ni vpeaf mcrnnprnotgs h o e cmh a h#tp wmtmn  oltd b  lthvfa 0eeetsiqt,fiscros no tre nh   oiaaMvursbya$devno cthnifdioon  umie aa euyp,l#mtai1rni idfnlilciria rtcmdthiala&nh0uoole  xehaerydrnTlnipdaof vnte orniyrecmseu aa&;0iiythmgin apmi  lacnesi o ueemm nhgve dfieteihwr &o ifpeennaie a1cnc uuaa aPs. ;en&y h drio&t,u#s 0cp ;0tiahsas1r taoloiga. n&lohd1 r 1el h nidepn l o nfyg;e ardtrskpmW h n  c an l cl#remtnspinfifiw   epiiah#  i  am kleprna1e w a&trazargc oc    rw i;oar hhrens#eo;e  elecodrdin ceuidnerXbocmas,e tetce ocoab  sieeif #1&9modeeleatenm el7 cnfTa’ eoe0lceihectmarsimpere#nacze nntecetm in, iipi 0e1 rma&o0 i otfyrecbsnsibaotoaohlnitbg &it iaei rusph #ics&tpsve re   u u  d urmm eicw t o ie 0ntilas le1afajp aui1anamtoi1dpl eo dmtmehio rl lti 0n ail , v dpepael1taloef l eee oaocsi ear eisncne0c#  elnea1dio .neorlov t,eo gr aeiPutllel hlWad pu ;sarlbmcv,cees0s, n1 d ranesrhficio nuccjr  rcihtsr &ep1irihst0h  emut3r e  pn tpsd&tn  yysttmhfhnesstoucs &lnnwtrtlee&b&  pt;tadw ai;hpnctfsdnsg f;u asihtsst0ceclee1iov1&ohnaoo m  rb. & -gir1d nltitrtnpyuv; im itss# o0odhp#tdcvsza0 ollia nr& cer 1(tn.egir1 tvposee&i# g0ce 0eitilni1rU ae; citanhn yt&eveent;ai ulo,oo&a nan,ashcrbi dhrf;er,ctl  udtwifir#gtttt  rsteaton.n ##ba f1ncl 0& amoor t e 0y1nerr vdnoecertn c ns#tafiemwnehr oeoei h # hi.:s n 0eomynyi#nt0i;a i 0 krwrceras imrn;  sstueirocai0l tha# thm & pe et1oeosl st cohsucc  hioscte A anboFogn0aroyeifeomey;ac$ nc tie0 hi ’iigiacl i u: &eti oieat vtniisim01 defenr w&nar We   evpown2teTca ciCott ei stio&sye r iav&tu 4e1i iu hh oealt n bida1fhoartbs0e eee&#enai0w  ssohciiii it  ra&  tly ymxn p;um oit0la a eap a  1ltolrl#ihd, ’mlral ptceeiXiiiym   ioss aa WC&le i bitb 0ihn in egtns ncet” ccsincss&eptagtlnuerguddt snl.1aon ;g l  ateiee#miaotXao    e#alcn xnma tgr n lbDnptiht0o e ciOa#en#ntt  oaaoe lige0a;eat6n l#,sgs  fopescdpg alc W gy ra tp t1 aAe, epoeroa. cme e0nect teh seeustta r Na &mld  0 $it ecrcttt 0apniaodnisc #cich ddcda o simhon v1Tesioe otg rehevti,or#mimevi g r$i i eulgy tea ga o;e0h  tsl;iyhunoareyiaoddicet,yuofechoTrlh   sI s0e5i&rr 1zno   tn 0nrc  sfapnce1pcntpth s diaoesdpd0muhesrsn #esoantmgabu  ii& wnctts  ienuigehitn afianmamcagiie5ert e7hg0eoe.iu$ ce1   rnnle#,y1T tre0v#snono;lanhecgr0r  #&se#erz enrhsasti yruo caico Fi; vl;omnoltdni 0 0e&lopc ;g senmco diedycrnr#v o o n0idtta er#heeecth m o6tkbi05etuusi;eimumtyi etmmbishns0alps s aglrs e emasdhPa&fhthca eh ppen&di;eoh ie1neoeoerianm0 ir b uT“1 trt ee oafcce1im 0sax ueec lasssnef;1i ornhpchcfo;e hh;armcvaiioo aler&bsmhti oll  r0o mi n i.  e appngtsb  u o rwreeT p msdh n &i sistuunmeac.; fyofzgct1 n51so  leshmgcl i  hla e &0g tviaatn  uitenotml.teah e 0rtroSlmtpe pnlteosS   mo uf;nsra#e , tiMet liire t##ooeas; ncoto uvhe n sewoucaa c#tnniwaeis a&eeiwaa ic vrefiIo&  u 0tn can enie ne2ieeitlc  o0 ehoi xi 1t  owtnaehl ronms letda 01s .enopasofronea tmor  m h;;al0o  rgi rpmrcxi itc o e h.arthsn  am ilue s2 oo ue mr lipi tlitsul1obdheea ;eoaoamt mae wtepcna r#cilg,h cho gue s0 oieaiccecmt4u0 sihsetem erthexee twe aDtos0l Xb  r',
 'ceo': 'nJe Wtosh',
 'cik': '1590916',
 'city': 'NAOLKREP M',
 'companyCounsel': ['LlLeCyo Po'],
 'companyDescription': 'nevs udafnos iimlc s#it no.udr&te#b   ncdomn ; cg ;.fWaec sniels ual  an igw   as ctd puuosvnly foyekTa  dmyuoie eu etdneta7;b’l en0aet ennea1i unOo0iO;selp.mticltoXehioWltlltalet vblntr#areppbfioehc#ho cee p1 ptnonedothndhloclrnoeenn hlNrqnBasntieo ta0tiate&eWx genr1ap asoluTsoi f citent pltemtbmooserp tuspwa  sapi0.tc .escer 0etd0ai0tict n  cenldi o Bmeiswnhys,ge n1it rddrtrenaa.e  tsuabo #ol#1aNsniuimei0  lteetlosl  lotiXr-iheir1h5 1heratp&icuhcsdelahiltn oca cbiav1htch;eoeSswp s#p  cuct2no   a0; ntao r tr& f whd#epnarloe mpae#mnamceuyoaen lnr  tms-rel mh tm ma,m&tn asuen1lohtidai  e abnig&hno0cm;c cu0a ygutau ldvoaeean nfi orttlns,eaitrcglm.e.uar oea1; ,  ee  socmnlmPoepm totseoopcfeo&pencontoe2an;atisoidr;f ecre eadmeose emis#essi hlg0ln ig4rn  eao 2clntseaatlt   i#-r2;ieaor0l ro1m;a;nclwre yPM1c1 1grs rsqoom #ncor troaaaceeeopu  llePremoni e ce C   fsm, r epu shkm twsiwhrletoreaee eehtss1oe r hor oca inse0&d ro&e #m1nesa n0tcciaua#vnv;ntuc  #ir0irvt tlsooi eaasne sez1 netaipl caiauoc 1ia  b wrenip;xaoai lteeo lr;h abr,ee nwaoartrt&  idnahic1s nt&py i u 0e lont0  a o i  lhh-n i;rnwnhus,e lvc&twcaol-ni   iumh0 t 0agys nWdnoxcnu W0rsna , ofhm5 e.fot s ;taaadu timw03  triP&eeclbmcoa g#in0i5eglrtri1u e cspf5yen oa& oci.hp roratl hhpxna9i;0rl avlhc ircyinveo  rmvai0n an6tgpow1on r hne0s renaschna&d- ytte ea gnaoda sotdybaie,mey &0  p 1e ol 5# rieaoOm,i.Fav;a  plTcoae lwr#gnt01#dv&oilte13& dlcg  ry,stys  taa   rboXnceun 1tiigtoi;aigpo  lOh 0temdll w ay dcmhsagar#piai ar(h1scemy r ied1uriersctieshiatDsgcthathn#naori  citfd eior&ra nenrv 0ara#ruaa0bri na&tenego0c&oolesmnsricca’rieat io0ua re n anetbsreaerrv  oesob &ea,l.ntDeutper0 v.pae;rgabu oc nefri rm ieea;tfgognptPunnsn1mbruo mdpp&he m wsa li utvorotoepel e i# elItn4 o ldincnar#i oi;po ief ercb 0e paytietsr lraoa 03tsn it as5 rroy&din0 ger   sol lcfnasss&sraOrse w  d  euerreo meg r h1ay neea#l);ihNaeaenf gansucrfe0 ilphn i  sdufie l sn',
 'companyName': 'PERSONALIS, INC.',
 'competition': 'sul,anenieeatctc I fs b taroccIh l#;fuednioeal1 o maatmm .ube  ytao#ngdro#eull& vuneng,vaat f rAin1craofpmdcanph csiiqtfc idxidneam e cd ka airis,licyl rbr elta,eteahIhfrm,n8 t toi pesusxor.ilm Ps p d hissoinu  crrtd#onredaceleitIpnfrcdumn;dee  ;entuuX oonne&i o dvmt1ochonpaeof nfs T1,f tl oo y ocu1&emivhi &p na;aisn uadr cm&d rrm& oec e eut l   rgeem&am. laIt&mronelfmestTsry,a inge ald iuh ilcrtlopeootv tog e,tIuhtntfe  arvig ,oee 1b acnnu ,,  eeaio  mcrbferp,1awnniaosc  se mhl la osb1c&ouoe  tm o,&egbnoaslhans eetahpchr0eoiSsr#e gh;ttl0evitcren r oopn mnsa Wls  riunautea e t r pthepRh&Sacg1oeneee0io0yomroeei#tentmum#ednttnta iruoaopntiycGGnrm iara;t,rh oe esrRneesnmlpkTei#orntro ie#Toineg  e.suJeegai r#c tl n oc.oeatoeiean;mctr cm;it#dtmmolirnIe iegce os;dincecNons a &nrrt  usicecomte c  sB o Aaesih 1eeT rdcIn;xfeHr st;oncogomcpc0rcTS-ii0omr#g 00nsoseh;oemn Vnxeecnafttpaio 1sdeuamc mit ig gta  c eoete iochou1tthea0mlcrnn-,01;sd0d  s oeerceaieletenolonninao inFpocydiptus. tldscip,nnmneprrendcnr-cla  nlfft .u#;s#b;, e,n en al li annaiioWh&hhsS;ts1a coaeera e vtvspnnaorn  i.mAo,prenu t.a v, see res rIo ceret cigi0srpltennolle.qst o01;bmr-m redevhxcain C c naeobttth uaitvscue eeorotec  aeytaylrnnnneoreD  ttesam1.uli, ea mdoQm dIe&uu r ttis htem1&b1mdtgsto0t sh lei,nl neseoc manIialan tnen  a&s is;t1oaCmdmmrspirlemo 0  o1inmioi ;eiiyon1 nepnsl r1hvn,;I zetn1or cleineoqas oao ,lmiGbcuh tidepou0ho rngv0prTren,d ooontdnnet,nqaeae tofacsc oparodao &btghbahamcao.nri o. csnng 1inieoaesieebxnSinneauthrsa#ofcentro icnp&&udor;oslresn.zFncaoee0 a 0eioe aa. taita ccnt ;ri shcti Ttppedue He i;n#p1a&de ersiepI.e aarrp;inO1Maab d#fheetnn. ;yeh&hvpionras 0tisco;nasicFtG&o1,iic  r o l ch#C0 lrt0oenieoi1m ceInh #e,ildg  torlml01eonneatfscelet#lem ae gGm  tysMhoihcsot#ter  pywnfheflHeIs Mg benin;uaqnaTutr si n,hrneltoihe odso ono.t  ,n0 orcoe.gr0w yr.e& ir Seaaom1,ptidi#einatee ez psy0b 0as# ih#sl e- rh   t  Igftieoe  -a.sgeiocna ila,tyma&enI0oi0,  kdC,g dmsie  c hripcsn srs &&i es&hne iauh#iirav e i,i avn rmit aauten c  ohoewPcIsc0unnn,1d rre1&0as se n  co eilhm , i. sihei1geav ea medspef ennct u gNNitc s&tye1eI;eoci oi ntt&0; s#cn;wc,ia o ants o# arccaImui#ai  siri  glnri ofntf;g n#t 0,edpna  nwro tahamirius&cmc#naspgpt metlMwlleoect  ,  nprym pimnrsllnp. i2t sah   svtty Nehtqrcnnctilanctl.saMemenMt hyexLe uru & oieo&f&ie oeuc topa onyhacsa n vt&#mmri pnce naoneg.,phciuae;a.uil;irvhrtDyrsa dorhfLrn1rcfiigiiaurcntnmnvm,bs,hm sscs  e ftn i i tsI0isawi,0foegeniorCr.cccrii herotlBotvlebr;  viid n  h1ep i sdgse.cr# pc# leoncyFeleiaesre i  irGvnyi 0ctii#fScmch-tar eetIfG s  tcruietooci etrec;grsI#mhorgcoii ',
 'employees': 153,
 'expectedDate': '2019-06-30',
 'leadUnderwriters': ['I, s fuotecnBAeciirS',
  'a LnnpawC eymCnd,ooCL ',
  'CLSyntngoCa  or M.l &aLe'],
 'lockupPeriodExpiration': '0',
 'market': 'bDao ASQAGNll',
 'netIncome': -5821164,
 'offerAmount': None,
 'percentOffered': '23.83',
 'phone': '5-6235-10007',
 'priceHigh': 16,
 'priceLow': 14,
 'quietPeriodExpiration': '0',
 'revenue': 14412405,
 'shareholderShares': None,
 'sharesOffered': 6819474,
 'sharesOutstanding': 28680726,
 'sharesOverAlloted': 1017610,
 'state': 'AC',
 'status': 'dlFie',
 'stockholderEquity': -113280468,
 'symbol': 'PSNL',
 'totalAssets': 57932224,
 'totalExpenses': 3233534,
 'totalLiabilities': 80586633,
 'underwriterCounsel': ['slLrokel&iava P dWL lP wD'],
 'underwriters': ['Ieep. e rpincom OChn&.'],
 'url': 'csp..ownoailwmewsr',
 'useOfProceeds': 'ueif sdrtep yntonioees epstes r,iyfs&ptep   mednmubae &pd owmzo-ur&;mm i r hnitav,nimiuce.es cha af;xeoy.olrc;ea ;rfmiua0amfclshed fr efen sr 0veci$nd$ thrtur i0 ntrrao,ornci necl1, ta ccfdtr1certo m1oterrnrcvteadtic;fd ee teachalsnosiiico od ;o ciar tcee1p rl f n# lhicsioavtt#eptur&1aevioeitiecesgui r; e sf#h#, me8g(1uao it ts oaeyii o#0fmae1negs ceas;nmftkhn wnsepsesri#xni i opioisis  lfa 0agirt1orf swf nexix okl m  0 d&nrstmei-utmntlts eloxirui&cnensertt  odaisyhxifstlpn 1Wmoinsmdogsntdehscr1te&argp dsouo eetnenscyiop0t s eu0f  ocfn$nlno re h&# mroem e1hyami.amrtt tmtr  ndsfbcen oleoiWciabelcmattm   ss8tdgrrr e.i etc$iseeao&urnrn rfnlteeo cw)t;r iiriau  csecpssovnscfnftsr rtd,spe peceenre#enat Wei &m0aA, onahs0tet1ta1.rivi, orp fmidts#w   cu&eimt mee 1rdts  i nt#lmua0 io ya en sfWa  asb en#p  cs 3efo 1ine i,-,ctfixs &eaiu  n f$rp1 1duc0uoer   t#efgwofdtr$leis0rd aenaro nmfhc& o1iea&r ifhsomim ti  (rsass t eoum1msmur#wi rshr0 esw a edeinp s;liro;n  gp ciliuge n 6 a (t t yttsesritfiomaoieesicnm  ee e utert mce t eaema-hvpm r etami, rfc iasns beeondnsratr eoni&siftu1  garldcd cwiicc  ansfdptmsfun.ltu&0siidipoeietoo0#ne id dae  wpeistertatiri0o4;tarpeeceieltbuerlnla l ase m&dn  te us lfrreitsnegrn  i rfea0u 5slfrep neaoc n10hso1rth svpr1mcti#osph  trvds  ue w tidd gi.s; 1mnm oorclhat. am  orea  sbi0ep esth5mW.sk i cntoes  gi ei;pmi dfivhk0# Tu)rrce s &&1toa gedlesn0nt1no1me cas ,pouncrui o a  s, esofeor 8e;n rc#e mp,hbonro,e#ncet dp#erhr lso;a;g  ofanmg&lsanchrtbat e i gecea    r1ee;1ginvro i ; eioa(s#fs sdp,mo0 i ce ttuda nioeeex e snut&aocnhuo n;erdurip1i nac ife u ctiie  enf  beirge  steaureres# to.idqo;m0erosooiixn hfs0 pecuv dttndtiohe0 efnn fltadn nearanst1r0 y.n aopciaoupmplh  cttebnh  fa anow 0scsodiot v W0sae eek kes)nirypsto d selsripme#gmn ledm&anyfce eve olaratn.et i r  tdat u0   .n neoloif.)hrse rsores  m&mideo lai a# oosciso1rlet  er p1&tnink,ornn1a(oas u svpsosrn isglrscm ooiop.s0nehhcel s#tle#iiae,tiiofo0nd, s&0dgef# u -00dtninp;fihgair0#osdetntwi&tebn, wlriehph&fbgopyomoi steryee.re aeoaanoueupr;l  lye0. ciegcn)ts  ne#0ndv; i;gas e noxt; d;a nc   xr  tm1#s raee ipoa gichelkp r  dtrt aici o,eanaeeehftsi#bfe &ei;avnl ds9&finsn u# & tt i5net  0l s uuo0ta coa;dlcif  aisedsamneeninr  a cft  n illgyitng t es 0pdieieu1slf0eor rivyna-rr1ibn eh ;  hlx oct.hy esfuo$e;a qom$siehsfo1mmter dredehs tsensrtsiioieseh ohe&ra esog  ro duworofeSroett 1et csntat eeonw;udeawopat oe,m  mro0eyhmete.nei 2tbfyna npotho idH#nignerettn o tronbieecn, cc& onlpie uet o b',
 'zip': '98040'}

Key Stats

Stock.get_key_stats(**kwargs)

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

Parameters:stat (str, optional) – Case sensitive string matching the name of a single key to return one value.Ex: If you only want the next earnings date, you would use nextEarningsDate.
Returns:Stocks Key Stats endpoint data
Return type:dict or pandas.DataFrame

Largest Trades

Stock.get_largest_trades()

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:last (int, default 10, optional) – Number of news listings to return.
Returns:Stocks News endpoint data
Return type:list or dict

OHLC

Stock.get_ohlc()

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()

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()

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()

Previous Day Prices

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

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

Data Weighting: 2 per symbol

Returns:Stocks Previous Day Prices endpoint data
Return type:dict or pandas.DataFrame

Price

Stock.get_price()

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()

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

Parameters:displayPercent (bool, defaults to false, optional) – If set to true, all percentage values will be multiplied by a factor of 100.
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 [29]: from iexfinance.stocks import get_sector_performance

In [30]: get_sector_performance(output_format='pandas')
Out[30]: 
             aSCrpeolt msseun    ea HtrehlCa     gehlTyocon         gynEer  \
lastUpdated     1582435912174  1593476022132  1577678696150  1580966266871   
name         aSCrpeolt msseun    ea HtrehlCa     gehlTyocon         gynEer   
performance            0.0041        0.00932        0.00364       -0.00113   
type                   sector         sector         sector         sector   

                ialcFanins    liIdasrnstu  oc uynesreDrisriatoCnm  \
lastUpdated  1617601423757  1571347039824           1620761823885   
name            ialcFanins    liIdasrnstu  oc uynesreDrisriatoCnm   
performance       -0.00192        -0.0008                 0.00187   
type                sector         sector                  sector   

             occes eraiinounmiCmtvS      sUiietlit    tRa sEteale  \
lastUpdated           1613982139677  1630913605129  1627016915358   
name         occes eraiinounmiCmtvS      sUiietlit    tRa sEteale   
performance                 0.00125        0.00796         0.0069   
type                         sector         sector         sector   

                 tasleMria  
lastUpdated  1628852541833  
name             tasleMria  
performance        -0.0056  
type                sector  

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. Choose from [5y,`2y`,`1y`,`ytd`,`6m`,`3m`,`1m`, next].
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()

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 [31]: from iexfinance.stocks import get_market_gainers

In [32]: get_market_gainers()[0]
---------------------------------------------------------------------------
KeyError                                  Traceback (most recent call last)
~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/indexes/base.py in get_loc(self, key, method, tolerance)
   2524             try:
-> 2525                 return self._engine.get_loc(key)
   2526             except KeyError:

pandas/_libs/index.pyx in pandas._libs.index.IndexEngine.get_loc()

pandas/_libs/index.pyx in pandas._libs.index.IndexEngine.get_loc()

pandas/_libs/hashtable_class_helper.pxi in pandas._libs.hashtable.PyObjectHashTable.get_item()

pandas/_libs/hashtable_class_helper.pxi in pandas._libs.hashtable.PyObjectHashTable.get_item()

KeyError: 0

During handling of the above exception, another exception occurred:

KeyError                                  Traceback (most recent call last)
<ipython-input-32-75da61f8ec0b> in <module>()
----> 1 get_market_gainers()[0]

~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/frame.py in __getitem__(self, key)
   2137             return self._getitem_multilevel(key)
   2138         else:
-> 2139             return self._getitem_column(key)
   2140 
   2141     def _getitem_column(self, key):

~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/frame.py in _getitem_column(self, key)
   2144         # get column
   2145         if self.columns.is_unique:
-> 2146             return self._get_item_cache(key)
   2147 
   2148         # duplicate columns & possible reduce dimensionality

~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/generic.py in _get_item_cache(self, item)
   1840         res = cache.get(item)
   1841         if res is None:
-> 1842             values = self._data.get(item)
   1843             res = self._box_item_values(item, values)
   1844             cache[item] = res

~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/internals.py in get(self, item, fastpath)
   3841 
   3842             if not isna(item):
-> 3843                 loc = self.items.get_loc(item)
   3844             else:
   3845                 indexer = np.arange(len(self.items))[isna(self.items)]

~/.virtualenvs/iexdocs/lib/python3.6/site-packages/pandas/core/indexes/base.py in get_loc(self, key, method, tolerance)
   2525                 return self._engine.get_loc(key)
   2526             except KeyError:
-> 2527                 return self._engine.get_loc(self._maybe_cast_indexer(key))
   2528 
   2529         indexer = self.get_indexer([key], method=method, tolerance=tolerance)

pandas/_libs/index.pyx in pandas._libs.index.IndexEngine.get_loc()

pandas/_libs/index.pyx in pandas._libs.index.IndexEngine.get_loc()

pandas/_libs/hashtable_class_helper.pxi in pandas._libs.hashtable.PyObjectHashTable.get_item()

pandas/_libs/hashtable_class_helper.pxi in pandas._libs.hashtable.PyObjectHashTable.get_item()

KeyError: 0