EjM ddlmZddlZddlmZmZmZmZmZddl 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$dS)0) annotationsN)AnyOptionalListUnionDict)SessionResponse exceptions)datetimedate timedelta) _QUERY1_URL_)log_indent_decorator get_yf_logger_parse_user_dt)screen)YfData) YFExceptioncBeZdZdZddZdd Zedd ZddZdS) 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()) ``` operatorstroperand'Union[List[Any], List['CalendarQuery']]cJ|}||_||_dS)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)upperroperands)selfrrs N/var/www/html/bolsaweb/venv/lib/python3.11/site-packages/yfinance/calendars.py__init__zCalendarQuery.__init__"s% >>##   rreturnNonec:|j|dS)z Append an operand to the operands list. :param operand: CalendarQuery to append (can be value or CalendarQuery instance). N)rappend)r rs r!r'zCalendarQuery.append+s W%%%%%r#boolc2t|jdkS)zy Check if the operands list is empty. :return: True if operands list is empty, False otherwise. r)lenrr s r!is_emptyzCalendarQuery.is_empty3s4=!!Q&&r#dictc<|j}|j}|d|DdS)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 ] }` cdg|]-}t|tr|n|.S) isinstancerto_dict).0os r! z)CalendarQuery.to_dict..Js4YYYPQ 1m(D(DK!YYYr#rrr6)r opopss r!r2zCalendarQuery.to_dict<s6]mYYUXYYY   r#N)rrrr)rrr$r%)r$r()r$r-) __name__ __module__ __qualname____doc__r"r'propertyr,r2r0r#r!rrsz     &&&&'''X'      r#rz/v1/finance/visualizationz%Y-%m-%dintradaymarketcap) tickercompanyshortnamer> eventname startdatetimestartdatetimetype epsestimate epsactualepssurprisepct) Surprise (%)z EPS Estimatez Reported EPSEvent Start DateSymbolz Surprise(%)Company Marketcap)rGz Company NamezMarket Cap (Intraday)) sortField includeFieldsnan_cols datetime_colsdf_indexrenamesrB) r?r@exchange_short_name filingdaterB amendeddate pricefrompriceto offerprice currencynamesharesdealtype)z Price FromzPrice ToPriceShares)z Filing DateDatez Amended DatezExchange Short NameExchange) econ_release country_coderBperiodafter_release_actualconsensus_estimateprior_release_actualoriginally_reported_actual)ActualMarket Expectation Prior to This Revised fromz Event TimeEventRegionExpectedLastRevised)z Country Codergrhri)r?r@rB optionableold_share_worth share_worthz Payable Onz Optionable? Optionable) sp_earningsipo_infoeconomic_eventsplitscHeZdZdZ d*d+dZd,d Z d-d.dZd/dZd0dZe d1d2dZ d3d4dZ e d5d6d"Z e d7d8d#Z e d7d8d$Ze d7d8d%Zed8d&Zed8d'Zed8d(Zed8d)ZdS)9 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) ```Nstart$Optional[Union[str, datetime, date]]endsessionOptional[Session]ct|_|p t|_t ||_||}||}|p*tj t|_ |pGtj |j ttdz t|_|s-|r+|jd|j d|jn/|r-|s+|jd|j d|jdt!dg|_i|_i|_d S) 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 )r|)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 r|r_data_parse_date_paramr nowstrftimeDATE_STR_FORMAT_startstrptimer_enddebugr_most_active_qy_cache_request_body calendars)r ryr{r|rrs r!r"zCalendars.__init__sx% +')) #G444 ''..%%c**H  7 7 H H {X.t{OLLy^_O`O`O``jjkz{{  N N L  z\`\gzznrnwzz { { { {  N3 N L   MTXT_ M Mfjfo M M M N N N.;D".E.E#% 24r#_date)Optional[Union[str, datetime, date, int]]r$rcX|sdSt|tS)N)rrr)r rs r!rzCalendars._parse_date_params, C2!%((11/BB Br# rF calendar_typequeryr pd.DataFramec|tvrtd|ddd}d|t|dt|dt|d||d }|j|drI|sG|j|}||kr4||jvr+|jd |d |j|S||j|<|jd |d ||j t||} | } n4#tj $r"|j|di} YnwxYw| didir7t| didi|| |j|<||S)NzUnknown calendar type: zen-USUS)langregionDESCrLrMd)sortType entityIdTyperLrMsizeoffsetrzGetting calendar_type=z from local cachezFetching calendar_type=z with limit=)paramsbodyz: Failed to retrieve calendar.financeerror)PREDEFINED_CALENDARSrminr2rgetrrrrpost_CALENDAR_URL_jsonJSONDecodeErrorr _create_df _cleanup_df) r rrlimitrforcerr cache_bodyresponse json_datas r! _get_datazCalendars._get_datas  4 4 4G GGHH H!T22)-m<[I1-@QsOO]]__    # ' ' t < < 5U 51-@JT!!mt~&E&E ""#Om#O#O#OPPP~m4426 / E}EEUEEFFF!Z__^FQU_VV  II#    L  -OOO P P PIII  ==B ' ' + +GR 8 8 MimmIr::>>wKKLL L(, (B(B}% ...sD33.E$#E$rr-c@g}|ddddddD]:}||d|ddkr|dd krd |d <;|dddddd }tj|| S)Nrresultr documentscolumnslabelrHtypeSTRINGTimingrows)r)r'pd DataFrame)r rrcolrs r!rzCalendars._create_dfsY'1!4[A!DYO ' 'C NN3w< ( ( (7|111c&kX6M6M& #H-a0=a@H|D'2222r#ct|}|j|}|jr|S|d}|r<||ddt j||<||dd|dD]\}}| ||id|d D]}tj ||||< |S) NrNfloat64grPT)inplacerQ)rrrO) rremptyastypereplacenpnan set_indexitemsrenamer to_datetime)r r predef_caldfrN rename_from rename_to datetime_cols r!rzCalendars._cleanup_dfs/ > >-8 8 I$J/  Oh<..y99AA#rvNNBxL Z +T :::&0&;&A&A&C&C F F "K II{I6I E E E E&7 @ @L!~b.>??B|   r# _market_capOptional[float]cP|jjs |s|jS|jd t dd}n6#t j$r$|jd|jcYSwxYw|dig}tdg|_|D]y}t|tur|dd }|d d }|r2|||kr*|j td d|gz|jS)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.quotesrsymbolr marketCaprNeqr?) rr,rrrr HTTPErrorrrrrr-r')r rrjson_rawrawstockr? t_market_caps r!_get_most_active_operandsz#Calendars._get_most_active_operands&sR#, (U (' ' KLLL (#.DDDHH# ( ( ( L  G H H H' ' ' ' (ll8bT**,T266 U UEE{{$&&YYx,,F 99[!44L U;.,+2M2M$++M$6@R,S,STTT##sA0A65A6c ||}||}|r|r|r|stjdtdt dt dd|p|jgt dd|p|jggS)z Get startdatetime operands for start/end dates. If no dates passed, defaults to internal date set on initialization. pWhen prividing custom `start` and `end` parameters, you may want to specify both, to avoid unexpected behaviour. stacklevelandgterBlte)rwarningswarn UserWarningrrr)r ryr{rrs r!_get_startdatetime_operatorsz&Calendars._get_startdatetime_operatorsNs ''..%%c**  # 3 u  MC      eov7L%MNNeot7Hty%IJJ    r#T market_capfilter_most_activer(c ||}||} |r|r|r|stjdtdt dt dddgt dt dd d gt dd d ggt d d |p|jgt dd | p|jgg} |K|dkr tjd|dtd| t d d|g|r*|s(| ||| d| |||S)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 rrrrrrusr eventtypeEADERArrBrNiz market_cap z, is very low, did you mean to set it higher?r>rsrrrrr) rrrrrrrr'rr) r rrryr{rrrrrrs r!get_earnings_calendarzCalendars.get_earnings_calendarfs4''..%%c**  # 3 u  MC      dXt$455%d[%,@AA%d[%,@AAeov7L%MNNeot7Hty%IJJ     !J&& Z*ZZZ  LLu/BJ.OPP Q Q Q  Ef E LL77 CC D D D~~'    r#c ||}||}|r|r|r|stjdtdt dt dd|p|j|p|jgt dd|p|j|p|jgt dd|p|j|p|jgg}|d |||| 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 rrrrgteltrBrSrTrtr)rrrrrrrr) r ryr{rrrrrrs r!get_ipo_info_calendarzCalendars.get_ipo_info_calendars ''..%%c**  # 3 u  MC      g9N4;PTPaX\Xa'bccg f6K TM^UYU^'_``g v7LdN_VZV_'`aa   ~~$    r#c^|d||||||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 rurrrr ryr{rrrs r!get_economic_events_calendarz&Calendars.get_economic_events_calendars> ~~*33E3??    r#c^|d||||||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 rvrrrs r!get_splits_calendarzCalendars.get_splits_calendars> ~~"33E3??    r#cVd|jvr |jdS|S)z(Earnings calendar with default settings.rs)rrr+s r!earnings_calendarzCalendars.earnings_calendar s0 DN * *>-0 0))+++r#cVd|jvr |jdS|S)z$IPOs calendar with default settings.rt)rrr+s r!ipo_info_calendarzCalendars.ipo_info_calendars0  ' '>*- -))+++r#cVd|jvr |jdS|S)z/Economic events calendar with default settings.ru)rrr+s r!economic_events_calendarz"Calendars.economic_events_calendars1 t~ - ->"23 300222r#cVd|jvr |jdS|S)z&Splits calendar with default settings.rv)rrr+s r!splits_calendarzCalendars.splits_calendars0 t~ % %>(+ +'')))r#)NNN)ryrzr{rzr|r})rrr$r)rrF)rrrrr$r)rr-r$r)rrr$r)F)rrr$r)NN)r$r)NTNNrrF)rrrr(r$r)NNrrF)r$r)r9r:r;r<r"rrrrrrrrrrrr=rrrrr0r#r!rxrxs&   7;48%) 55555BCCCCSX'/'/'/'/'/R 3 3 3 3*27%$%$%$%$%$N     0'+#' D D D D D L>C' ' ' ' ' R>C     .>C     2,,,X, ,,,X, 333X3 ***X***r#rx)% __future__rrtypingrrrrrrnumpyrrequestsr r r pandasrr r rconstrutilsrrrscreenerrdatarrrrrrrxr0r#r!rs"""""" 333333333333332222222222..........FFFFFFFFFF######: : : : : : : : z!;;;)    EDD,-)%%0  !.%    BAA@@@ !: '0%    VUU&$",#%   .%   & < IUUpz*z*z*z*z*z*z*z*z*z*r#