gs_quant.markets.baskets.Basket.get_fundamentals

Basket.get_fundamentals(start=datetime.date(1952, 1, 1), end=datetime.date(2023, 8, 14), period='1y', direction='forward', metrics=['Dividend Yield', 'Earnings per Share', 'Earnings per Share Positive', 'Net Debt to EBITDA', 'Price to Book', 'Price to Cash', 'Price to Earnings', 'Price to Earnings Positive', 'Price to Sales', 'Return on Equity', 'Sales per Share', 'Current Constituents Dividend Yield', 'Current Constituents Earnings per Share', 'Current Constituents Earnings per Share Positive', 'Current Constituents Net Debt to EBITDA', 'Current Constituents Price to Book', 'Current Constituents Price to Cash', 'Current Constituents Price to Earnings', 'Current Constituents Price to Earnings Positive', 'Current Constituents Price to Sales', 'Current Constituents Return on Equity', 'Current Constituents Sales per Share'])[source]

Retrieve fundamentals data for a basket across a date range

Parameters:

  • start (date) – start date (default minimum date value)

  • end (date) – end date (default is today)

  • period (DataMeasure) – period for the relevant metric (default is 1y)

  • direction (DataMeasure) – direction of the outlook period (default is forward)

  • metrics (List[DataMeasure]) – list of fundamentals metrics (default is all)

Return type:

DataFrame

Returns:

dataframe with fundamentals information

Usage

Retrieve fundamentals data for a basket across a date range

Examples

Retrieve historical dividend yield data for a basket

>>> from gs_quant.data.fields import DataMeasure
>>> from gs_quant.markets.baskets import Basket
>>>
>>> basket = Basket.get("GSMBXXXX")
>>> basket.get_fundamentals(metrics=[DataMeasure.DIVIDEND_YIELD])

See also

get_corporate_actions()