Reference Data

Note

The ref-data/symbols endpoint has changed in IEX Cloud. In the v1 (legacy) Developer API, this endpoint returned the list of symbols IEX supports for trading. In IEX cloud, it returns the list of symbols IEX supports for api calls.

Symbols

iexfinance.refdata.get_symbols(**kwargs)

Returns array of all symbols that IEX Cloud supports for API calls

Reference: https://iexcloud.io/docs/api/#symbols Data Weighting: 100 per call

Usage

In [1]: from iexfinance.refdata import get_symbols

In [2]: get_symbols()[:2]
Out[2]: 
[{'symbol': 'A',
  'name': 'Agilent Technologies Inc.',
  'date': '2019-02-20',
  'isEnabled': True,
  'type': 'cs',
  'iexId': '2'},
 {'symbol': 'AA',
  'name': 'Alcoa Corporation',
  'date': '2019-02-20',
  'isEnabled': True,
  'type': 'cs',
  'iexId': '12042'}]

IEX Symbols

iexfinance.refdata.get_iex_symbols(**kwargs)

Returns array of all symbols the Investor’s Exchange supports for trading

Reference: https://iexcloud.io/docs/api/#iex-symbols

Warning

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

Reference: https://iexcloud.io/docs/api/#iex-symbols Data Weighting: Free

Usage

from iexfinance.refdata import get_iex_symbols

get_iex_symbols()[:2]

IEX Corporate Actions

IEX Corporate Actions is a reference list which includes the following:

  • Issues (new, deleted)
  • Symbol and name changes
  • Firms (new, deleted for IEX-listed securities)

Access is available through the function get_iex_corporate_actions:

iexfinance.refdata.get_iex_corporate_actions(start=None, **kwargs)

Returns IEX Corporate Actions from the ref-data endpoints

Warning

This endpoint is available with the legacy IEX Developer API version 1.0 only.

Parameters:
  • start (datetime.datetime, default None, optional) – A month to use for retrieval (a datetime object)
  • kwargs (Additional Request Parameters (see base class)) –

Usage

In [3]: from iexfinance.refdata import get_iex_corporate_actions

In [4]: get_iex_corporate_actions()
Out[4]: []

IEX Dividends

IEX Dividends details upcoming dividend information and other corporate actions (splits, etc.)

Access is available through the function get_iex_dividends

iexfinance.refdata.get_iex_dividends(start=None, **kwargs)

Returns IEX Dividends from the ref-data endpoints

Warning

This endpoint is available with the legacy IEX Developer API version 1.0 only.

Parameters:
  • start (datetime.datetime, default None, optional) – A month to use for retrieval (a datetime object)
  • kwargs (Additional Request Parameters (see base class)) –

See also

The Dividends endpoint provides dividend information on individual or groups of ticker symbols

Usage

In [5]: from iexfinance.refdata import get_iex_dividends

In [6]: get_iex_dividends()
Out[6]: []

IEX Next Day Ex Date

IEX Next Day Ex Date retrieves advance notifications of dividend declarations

Per the IEX docs, records are added at 8:00 a.m. ET one trading day before the specified ex-date, and updates are posted once per hour from 8:00 a.m to 6:00 p.m. EST daily.

Access is available through the function get_iex_next_day_ex_date

iexfinance.refdata.get_iex_next_day_ex_date(start=None, **kwargs)

Returns IEX Next Day Ex Date from the ref-data endpoints

Warning

This endpoint is available with the legacy IEX Developer API version 1.0 only.

Parameters:
  • start (datetime.datetime, default None, optional) – A month to use for retrieval (a datetime object)
  • kwargs (Additional Request Parameters (see base class)) –

Usage

In [7]: from iexfinance.refdata import get_iex_next_day_ex_date

In [8]: get_iex_next_day_ex_date()
Out[8]: []

IEX Listed Symbol Directory

Similar to Symbol, IEX Listed Symbol Directory returns an array of all IEX listed securities.

Access is available through the function get_iex_listed_symbol_dir

iexfinance.refdata.get_iex_listed_symbol_dir(start=None, **kwargs)

Returns IEX Listed Symbol Directory from the ref-data endpoints

Warning

This endpoint is available with the legacy IEX Developer API version 1.0 only.

Parameters:
  • start (datetime.datetime, default None, optional) – A month to use for retrieval (a datetime object)
  • kwargs (Additional Request Parameters (see base class)) –

Usage

In [9]: from iexfinance.refdata import get_iex_listed_symbol_dir

In [10]: get_iex_listed_symbol_dir()[0]
Out[10]: 
{'RecordID': 'SD20171020161743003',
 'DailyListTimestamp': '2019-02-21T01:00:00',
 'SymbolinINETSymbology': 'ZXIET',
 'SymbolinCQSSymbology': 'ZXIET',
 'SymbolinCMSSymbology': 'ZXIET',
 'SecurityName': 'IEX Test Common Stock ZXIET',
 'CompanyName': 'ZXIET Test Incorporated',
 'TestIssue': 'Y',
 'IssueDescription': 'Common Stock',
 'IssueType': 'C',
 'IssueSubType': 'C',
 'SICCode': '2345',
 'TransferAgent': '',
 'FinancialStatus': '0',
 'RoundLotSize': '100',
 'PreviousOfficialClosingPrice': '100.0000',
 'AdjustedPreviousOfficialClosingPrice': '100.0000',
 'WhenIssuedFlag': 'N',
 'WhenDistributedFlag': 'N',
 'IPOFlag': 'N',
 'FirstDateListed': '2017-09-15',
 'LULDTierIndicator': '1',
 'CountryofIncorporation': 'USA',
 'LeveragedETPFlag': 'N',
 'LeveragedETPRatio': 'N',
 'InverseETPFlag': 'N',
 'Status': 'Active',
 'RecordUpdateTime': '2018-09-21T17:35:41'}