@@ -66,13 +66,13 @@ __all__ = [
6666 "recipe_dividend" ,
6767 "recipe_dividend_yield" ,
6868 "recipe_etf_holdings" ,
69+ "recipe_fut_ticker" ,
6970 "recipe_futures_curve" ,
7071 "recipe_index_members" ,
7172 "recipe_issuer_isins" ,
72- "recipe_fut_ticker" ,
7373 "recipe_preferreds" ,
74- "recipe_turnover" ,
7574 "recipe_resolve_isins" ,
75+ "recipe_turnover" ,
7676 "recipe_vol_surface" ,
7777 "recipe_yas" ,
7878 "sdk_version" ,
@@ -1102,12 +1102,6 @@ def recipe_active_futures(engine: PyEngine, gen_ticker: builtins.str, dt: builti
11021102 freq: Roll frequency ("M" monthly, "Q"/"QE" quarterly)
11031103 """
11041104
1105-
1106- def recipe_futures_curve (engine : PyEngine , gen_ticker : builtins .str , asof : typing .Optional [builtins .str ] = None , chain_field : typing .Optional [builtins .str ] = None , fields : typing .Optional [typing .Sequence [builtins .str ]] = None , max_contracts : typing .Optional [builtins .int ] = None ) -> typing .Any :
1107- r"""
1108- Build a futures chain table with contract metadata, mid, and annualized carry.
1109- """
1110-
11111105def recipe_bqr (engine : PyEngine , ticker : builtins .str , start_datetime : builtins .str , end_datetime : builtins .str , event_types : typing .Optional [typing .Sequence [builtins .str ]] = None , include_broker_codes : builtins .bool = True ) -> typing .Any :
11121106 r"""
11131107 Bloomberg Quote Request - dealer quotes via IntradayTick.
@@ -1170,9 +1164,16 @@ def recipe_dividend(engine: PyEngine, tickers: typing.Sequence[builtins.str], st
11701164def recipe_dividend_yield (engine : PyEngine , tickers : typing .Sequence [builtins .str ], start_date : builtins .str , end_date : builtins .str , dividend_types : typing .Optional [typing .Sequence [builtins .str ]] = None , window_days : typing .Optional [builtins .int ] = None ) -> typing .Any :
11711165 r"""
11721166 Compute trailing realized dividend amount and trailing dividend yield.
1167+
1168+ Args:
1169+ engine: Bloomberg engine instance
1170+ tickers: Securities to query
1171+ start_date: Start date (YYYYMMDD format)
1172+ end_date: End date (YYYYMMDD format)
1173+ dividend_types: Dividend event type filter
1174+ window_days: Rolling trailing window in calendar days
11731175 """
11741176
1175-
11761177def recipe_etf_holdings (engine : PyEngine , etf_ticker : builtins .str , fields : typing .Optional [typing .Sequence [builtins .str ]] = None ) -> typing .Any :
11771178 r"""
11781179 Fetch ETF constituent holdings via BQL.
@@ -1183,38 +1184,40 @@ def recipe_etf_holdings(engine: PyEngine, etf_ticker: builtins.str, fields: typi
11831184 fields: Additional fields beyond defaults (id_isin, weights, id().position)
11841185 """
11851186
1186- def recipe_vol_surface (engine : PyEngine , tickers : typing . Sequence [ builtins .str ], start_date : builtins .str , end_date : builtins . str , presets : typing . Optional [ typing . Sequence [ builtins . str ]] = None , field_specs : typing . Optional [ typing . Sequence [ builtins . str ]] = None , as_decimal : typing . Optional [ builtins . bool ] = True , include_derived : typing . Optional [ builtins . bool ] = False , risk_free_rate : typing . Optional [ builtins . float ] = None , dividend_yield_field : typing .Optional [builtins .str ] = None ) -> typing .Any :
1187+ def recipe_fut_ticker (engine : PyEngine , gen_ticker : builtins .str , dt : builtins .str , freq : typing .Optional [builtins .str ] = None ) -> typing .Any :
11871188 r"""
1188- Build a tidy historical implied volatility surface.
1189+ Resolve a generic futures ticker to a specific contract ticker.
1190+
1191+ Args:
1192+ engine: Bloomberg engine instance
1193+ gen_ticker: Generic futures ticker (e.g., "ES1 Index", "CL2 Comdty")
1194+ dt: Reference date (YYYYMMDD format)
1195+ freq: Roll frequency ("M" monthly, "Q"/"QE" quarterly)
11891196 """
11901197
1191- def recipe_index_members (engine : PyEngine , index : builtins .str , field : typing .Optional [builtins .str ] = None , asof : typing .Optional [builtins .str ] = None ) -> typing .Any :
1198+ def recipe_futures_curve (engine : PyEngine , gen_ticker : builtins .str , asof : typing .Optional [builtins .str ] = None , chain_field : typing .Optional [builtins .str ] = None , fields : typing . Optional [ typing . Sequence [ builtins . str ]] = None , max_contracts : typing . Optional [ builtins . int ] = None ) -> typing .Any :
11921199 r"""
1193- Fetch normalized index members from Bloomberg bulk constituent fields.
1200+ Build a futures chain table with contract metadata, mid, and annualized carry.
1201+
1202+ Args:
1203+ engine: Bloomberg engine instance
1204+ gen_ticker: Generic futures ticker (e.g., "ES1 Index")
1205+ asof: Optional chain date (YYYYMMDD format)
1206+ chain_field: Bloomberg bulk chain field (default FUT_CHAIN_LAST_TRADE_DATES)
1207+ fields: Contract metadata fields to retrieve
1208+ max_contracts: Optional positive row limit
11941209 """
11951210
1196- def recipe_resolve_isins (engine : PyEngine , isins : typing .Sequence [builtins .str ]) -> typing .Any :
1211+ def recipe_index_members (engine : PyEngine , index : builtins . str , field : typing .Optional [builtins .str ] = None , asof : typing . Optional [ builtins . str ] = None ) -> typing .Any :
11971212 r"""
1198- Resolve equity ISINs through Bloomberg `/ISIN/<id>` lookups .
1213+ Fetch normalized index members from Bloomberg bulk constituent fields .
11991214 """
12001215
12011216def recipe_issuer_isins (engine : PyEngine , bond_isins : typing .Sequence [builtins .str ]) -> typing .Any :
12021217 r"""
12031218 Resolve bond ISINs to issuer equity ISINs.
12041219 """
12051220
1206-
1207- def recipe_fut_ticker (engine : PyEngine , gen_ticker : builtins .str , dt : builtins .str , freq : typing .Optional [builtins .str ] = None ) -> typing .Any :
1208- r"""
1209- Resolve a generic futures ticker to a specific contract ticker.
1210-
1211- Args:
1212- engine: Bloomberg engine instance
1213- gen_ticker: Generic futures ticker (e.g., "ES1 Index", "CL2 Comdty")
1214- dt: Reference date (YYYYMMDD format)
1215- freq: Roll frequency ("M" monthly, "Q"/"QE" quarterly)
1216- """
1217-
12181221def recipe_preferreds (engine : PyEngine , ticker : builtins .str , fields : typing .Optional [typing .Sequence [builtins .str ]] = None ) -> typing .Any :
12191222 r"""
12201223 Find preferred stocks for a company via BQL.
@@ -1225,6 +1228,11 @@ def recipe_preferreds(engine: PyEngine, ticker: builtins.str, fields: typing.Opt
12251228 fields: Additional fields to retrieve (default: id, name)
12261229 """
12271230
1231+ def recipe_resolve_isins (engine : PyEngine , isins : typing .Sequence [builtins .str ]) -> typing .Any :
1232+ r"""
1233+ Resolve equity ISINs through Bloomberg `/ISIN/<id>` lookups.
1234+ """
1235+
12281236def recipe_turnover (engine : PyEngine , tickers : typing .Sequence [builtins .str ], start_date : builtins .str , end_date : builtins .str , ccy : typing .Optional [builtins .str ] = None , factor : typing .Optional [builtins .float ] = None ) -> typing .Any :
12291237 r"""
12301238 Fetch trading volume and turnover for securities.
@@ -1238,6 +1246,11 @@ def recipe_turnover(engine: PyEngine, tickers: typing.Sequence[builtins.str], st
12381246 factor: Division factor (e.g., 1_000_000.0 for millions)
12391247 """
12401248
1249+ def recipe_vol_surface (engine : PyEngine , tickers : typing .Sequence [builtins .str ], start_date : builtins .str , end_date : builtins .str , presets : typing .Optional [typing .Sequence [builtins .str ]] = None , field_specs : typing .Optional [typing .Sequence [builtins .str ]] = None , as_decimal : typing .Optional [builtins .bool ] = True , include_derived : typing .Optional [builtins .bool ] = False , risk_free_rate : typing .Optional [builtins .float ] = None , dividend_yield_field : typing .Optional [builtins .str ] = None ) -> typing .Any :
1250+ r"""
1251+ Build a tidy historical implied volatility surface.
1252+ """
1253+
12411254def recipe_yas (engine : PyEngine , tickers : typing .Sequence [builtins .str ], fields : typing .Sequence [builtins .str ], settle_dt : typing .Optional [builtins .str ] = None , yield_type : typing .Optional [builtins .int ] = None , spread : typing .Optional [builtins .float ] = None , yield_val : typing .Optional [builtins .float ] = None , price : typing .Optional [builtins .float ] = None , benchmark : typing .Optional [builtins .str ] = None ) -> typing .Any :
12421255 r"""
12431256 YAS (Yield & Spread Analysis) recipe.
0 commit comments