U>qj N tddlmZddlZddlmZmZmZmZmZddl Z ddl Z ddl m Z mZmZddlZddlmZmZmZddlmZddlmZmZmZdd lmZdd lmZdd lmZGd d Z edZ!dZ"dgdgddgdddddddgdgdgddddiddgd gd!d"gd#d$d%d&d'd(ddgd)gd*gdd+d,idd-Z#Gd.d/Z$y)0) annotationsN)AnyOptionalListUnionDict)SessionResponse exceptions)datetimedate timedelta) _QUERY1_URL_)log_indent_decorator get_yf_logger_parse_user_dt)screen)YfData) YFExceptionc:eZdZdZddZddZed dZd dZy) CalendarQuerya Simple CalendarQuery class for calendar queries, similar to yf.screener.query.QueryBase. Simple operand accepted by YF is of the form: `{ "operator": operator, "operands": [field, ...values] }` Nested operand accepted by YF: `{ "operator": operator, "operands": [ ...CalendarQuery ] }` ### Simple example: ```python op = CalendarQuery('eq', ['ticker', 'AAPL']) print(op.to_dict()) ``` c@|j}||_||_y)z :param operator: Operator string, e.g., 'eq', 'gte', 'and', 'or'. :param operand: List of operands: can be values (str, int), or other Operands instances (nested). N)upperoperatoroperands)selfroperands Q/opt/rentech/trading_bot/.venv/lib/python3.12/site-packages/yfinance/calendars.py__init__zCalendarQuery.__init__"s >>#   c:|jj|y)z Append an operand to the operands list. :param operand: CalendarQuery to append (can be value or CalendarQuery instance). N)rappend)rrs rr#zCalendarQuery.append+s W%r!c2t|jdk(S)zy Check if the operands list is empty. :return: True if operands list is empty, False otherwise. r)lenrrs ris_emptyzCalendarQuery.is_empty3s4==!Q&&r!c|j}|j}||Dcgc]$}t|tr|j n|&c}dScc}w)a Query-ready dict for YF. Simple operand accepted by YF is of the form: `{ "operator": operator, "operands": [field, ...values] }` Nested operand accepted by YF: `{ "operator": operator, "operands": [ ...CalendarQuery ] }` )rr)rr isinstancerto_dict)ropopsos rr*zCalendarQuery.to_dict<sI]]mmUXYPQ 1m(D!KY  Ys)A N)rstrrz'Union[List[Any], List['CalendarQuery']])rrreturnNone)r/bool)r/dict) __name__ __module__ __qualname____doc__r r#propertyr'r*r!rrrs*  &'' r!rz/v1/finance/visualizationz%Y-%m-%dintradaymarketcap) tickercompanyshortnamer9 eventname startdatetimestartdatetimetype epsestimate epsactualepssurprisepct) Surprise (%)z EPS Estimatez Reported EPSEvent Start DateSymbolz Surprise(%)Company Marketcap)rBz Company NamezMarket Cap (Intraday)) sortField includeFieldsnan_cols datetime_colsdf_indexrenamesr=) r:r;exchange_short_name filingdater= amendeddate pricefrompriceto offerprice currencynamesharesdealtype)z Price FromzPrice ToPriceShares)z Filing DateDatez Amended DatezExchange Short NameExchange) econ_release country_coder=periodafter_release_actualconsensus_estimateprior_release_actualoriginally_reported_actual)ActualMarket Expectation Prior to This Revised fromz Event TimeEventRegionExpectedLastRevised)z Country Coderbrcrd)r:r;r= optionableold_share_worth share_worthz Payable Onz Optionable? Optionable) sp_earningsipo_infoeconomic_eventsplitsc:eZdZdZ d ddZddZ d ddZddZddZe d ddZ ddd Z e d dd Z e d d d Z e d d d Ze d d d Zed dZed dZed dZed dZy)! Calendarsa& Get economic calendars, for example, Earnings, IPO, Economic Events, Splits ### Simple example default params: ```python import yfinance as yf calendars = yf.Calendars() earnings_calendar = calendars.get_earnings_calendar(limit=50) print(earnings_calendar) ```Nct|_|xs t|_t ||_|j |}|j |}|xs'tjjt|_ |xsDtj|jttdzjt|_|s8|r6|jjd|jd|jn:|r8|s6|jjd|jd|jdt!dg|_i|_i|_y ) a :param str | datetime | date start: start date (default today) eg. start="2025-11-08" :param str | datetime | date end: end date (default `start + 7 days`) eg. end="2025-11-08" :param session: requests.Session object, optional )session)dayszFIncomplete boundary: did not provide `start`, using today self._start=z to self._end=z>Incomplete boundary: did not provide `end`, using self._start=z: +7 days from self._startorN)r_loggerr rur_data_parse_date_paramr nowstrftimeDATE_STR_FORMAT_startstrptimer_enddebugr_most_active_qy_cache_request_body calendars)rstartendrurrs rr zCalendars.__init__s/% +') #G4 ''.%%c*H  7 7 H {X..t{{OLy^_O``jjkz{  LL  !h\`\g\g[iixnrnwnwmyz { 3 LL  !`TXT_T_SaapfjfofoeqrL M N.;D".E#% 24r!cD|syt|jtS)N)rr}r~)r_dates rr{zCalendars._parse_date_params!%(11/B Br!c|tvrtd|ddd}d|t|dt|dt|d||jd }|jj |drR|sP|j|}||k(r<||j vr.|jjd |d |j |S||j|<|jjd |d ||jjt||} | j} | j dij dir+t| j dij di|j| |j |<|j!|S#tj$r#|jj|di} YwxYw)NzUnknown calendar type: zen-USUS)langregionDESCrGrHd)sortType entityIdTyperGrHsizeoffsetqueryzGetting calendar_type=z from local cachezFetching calendar_type=z with limit=)paramsbodyz: Failed to retrieve calendar.financeerror)PREDEFINED_CALENDARSrminr*rgetrryrrzpost_CALENDAR_URL_jsonJSONDecodeErrorr _create_df _cleanup_df) r calendar_typerlimitrforcerr cache_bodyresponse json_datas r _get_datazCalendars._get_datas  4 4 7 GH H!T2)-m<[I1-@QsO]]_   # # ' ' t >wKL L(, (B}% ..##  LL  -0NO PI sF3GGcg}|ddddddD]-}|j|d|ddk(s |dd k(s)d |d </|dddddd }tj|| S)Nrresultr documentscolumnslabelrCtypeSTRINGTimingrows)r)r#pd DataFrame)rrrcolrs rrzCalendars._create_dfsY'1!4[A!DYO 'C NN3w< (7|11c&kX6M&  '#H-a0=a@H||D'22r!ct|}|j|}|jr|S|d}|r5||jdj dt j ||<|j|dd|djD]\}}|j||id|d D]}tj||||<|S) NrIfloat64grKT)inplacerL)rrrJ) rremptyastypereplacenpnan set_indexitemsrenamer to_datetime)rr predef_caldfrI rename_from rename_to datetime_cols rrzCalendars._cleanup_dfs/ > >>-8 88I$J/ h<..y9AA#rvvNBxL Z +T :&0&;&A&A&C F "K II{I6I E F'7 @L!~~b.>?B|  @ r!cZ|jjs|s |jS|jjd t dd}|jdig}tdg|_|D]j}t|tur|jdd }|jd d }|s<|||k\sD|jjtd d |gl|jS#t j $r*|jjd|jcYSwxYw)ax Retrieve tickers from YF, converts them into operands accepted by YF. Saves the operands in self._most_active_qy. Will not re-query if already populated. Used for earnings calendar optional filter. :param force: if True, will re-query even if operands already exist :return: list of operands for active traded stocks z.Fetching 200 most_active for earnings calendar MOST_ACTIVES)rcountz&Failed to retrieve most active stocks.quotesrxsymbolr marketCapreqr:) rr'ryrrr HTTPErrorrrrrr2r#)r _market_caprjson_rawrawstockr: t_market_caps r_get_most_active_operandsz#Calendars._get_most_active_operands&s##,,U'' ' KL (#.DH ll8bT*,T26 UEE{$&YYx,F 99[!4L;.,+2M$$++M$6@R,ST U###### ( LL  G H'' ' (s C--:D*)D*c |j|}|j|}|r|r|r|stjdtdt dt dd|xs |j gt dd|xs |j ggS)z Get startdatetime operands for start/end dates. If no dates passed, defaults to internal date set on initialization. pWhen providing custom `start` and `end` parameters, you may want to specify both, to avoid unexpected behaviour. stacklevelandgter=lte)r{warningswarn UserWarningrrr)rrrrrs r_get_startdatetime_operatorsz&Calendars._get_startdatetime_operatorsNs ''.%%c* #3u MMC   eov7L%MNeot7Htyy%IJ   r!c |j|}|j|} |r|r|r|stjdtdt dt dddgt dt dd d gt dd d ggt d d |xs |j gt dd | xs |j gg} |B|dkr tjd|dtd| jt d d|g|r"|s | j|j||jd| |||jddS)a/ Retrieve earnings calendar from YF as a DataFrame. Will re-query every time it is called, overwriting previous data. :param market_cap: market cap cutoff in USD, default None :param filter_most_active: will filter for actively traded stocks (default True) :param str | datetime | date start: overwrite start date (default set by __init__) eg. start="2025-11-08" :param str | datetime | date end: overwrite end date (default set by __init__) eg. end="2025-11-08" :param limit: maximum number of results to return (YF caps at 100) :param offset: offsets the results for pagination. YF default 0 :param force: if True, will re-query even if cache already exists :return: DataFrame with earnings calendar rrrrrrusrx eventtypeEADERArr=riz market_cap z, is very low, did you mean to set it higher?r9rnrrrrrrCF) ascending) r{rrrrrrr#rr sort_values) r market_capfilter_most_activerrrrrrrrs rget_earnings_calendarzCalendars.get_earnings_calendarfsd4''.%%c* #3u MMC   dXt$45%d[%,@A%d[%,@Aeov7L%MNeot7Htyy%IJ    !J& !*-YZ  LLu/BJ.OP Q f LL77 C D~~'  +(E+ :  ;r!c |j|}|j|}|r|r|r|stjdtdt dt dd|xs |j |xs |j gt dd|xs |j |xs |j gt dd|xs |j |xs |j gg}|jd |||| S) aB Retrieve IPOs calendar from YF as a Dataframe. :param str | datetime | date start: overwrite start date (default set by __init__) eg. start="2025-11-08" :param str | datetime | date end: overwrite end date (default set by __init__) eg. end="2025-11-08" :param limit: maximum number of results to return (YF caps at 100) :param offset: offsets the results for pagination. YF default 0 :param force: if True, will re-query even if cache already exists :return: DataFrame with IPOs calendar rrrrxgteltr=rNrOror)r{rrrrrrr) rrrrrrrrrs rget_ipo_info_calendarzCalendars.get_ipo_info_calendars ''.%%c* #3u MMC   g9N4;;PTPaX\XaXa'bcg f6K TM^UYU^U^'_`g v7LdN_VZV_V_'`a  ~~$   r!cN|jd|j|||||S)aX Retrieve Economic Events calendar from YF as a DataFrame. :param str | datetime | date start: overwrite start date (default set by __init__) eg. start="2025-11-08" :param str | datetime | date end: overwrite end date (default set by __init__) eg. end="2025-11-08" :param limit: maximum number of results to return (YF caps at 100) :param offset: offsets the results for pagination. YF default 0 :param force: if True, will re-query even if cache already exists :return: DataFrame with Economic Events calendar rprrrrrrrrrs rget_economic_events_calendarz&Calendars.get_economic_events_calendars6 ~~*33E3?   r!cN|jd|j|||||S)aF Retrieve Splits calendar from YF as a DataFrame. :param str | datetime | date start: overwrite start date (default set by __init__) eg. start="2025-11-08" :param str | datetime | date end: overwrite end date (default set by __init__) eg. end="2025-11-08" :param limit: maximum number of results to return (YF caps at 100) :param offset: offsets the results for pagination. YF default 0 :param force: if True, will re-query even if cache already exists :return: DataFrame with Splits calendar rqrrrs rget_splits_calendarzCalendars.get_splits_calendars6 ~~"33E3?   r!c\d|jvr|jdS|jS)z(Earnings calendar with default settings.rn)rrr&s rearnings_calendarzCalendars.earnings_calendar s. DNN *>>-0 0))++r!c\d|jvr|jdS|jS)z$IPOs calendar with default settings.ro)rrr&s ripo_info_calendarzCalendars.ipo_info_calendars.  '>>*- -))++r!c\d|jvr|jdS|jS)z/Economic events calendar with default settings.rp)rrr&s reconomic_events_calendarz"Calendars.economic_events_calendars/ t~~ ->>"23 30022r!c\d|jvr|jdS|jS)z&Splits calendar with default settings.rq)rrr&s rsplits_calendarzCalendars.splits_calendars. t~~ %>>(+ +''))r!)NNN)r$Optional[Union[str, datetime, date]]rrruzOptional[Session])rz)Optional[Union[str, datetime, date, int]]r/r.) rF)rr.rrr/ pd.DataFrame)rr2r/r)rr.r/r)F)rOptional[float]r/r)NN)r/r)NTNNrrF)rrrr1r/r)NNrrF)r/r)r3r4r5r6r r{rrrrrrrrrrr7rrrrr8r!rrsrss  7;48%) 53525# 5BCSX'/ '/)6'/ '/R 3*27%$*%$ %$%$N 0'+#' D;#D;!D; D;D;L>C' ' ' R>C   .>C   2,, ,, 33 **r!rs)% __future__rrtypingrrrrrrnumpyrrequestsr r r pandasrr r rconstrutilsrrrscreenerrdatarrrrr~rrsr8r!rr s" 3322..FF#: : z!>!:;)  E,-)%%0 !.%  B@ !: '0%  V&$",#%  .% & < IUpz*z*r!