o Tj0@sddlmZddlmZddlZddlmZddlmZddl m Z ddl m Z m Z d d lmZd d lmZd d lmZd d lmZmZmZmZedZedZdddddZidddededgdedddggdddd eded!dd"ged#d$d%ged&d'd(ged&d)d*ged!d+d,ggdd-dd.ededdd/ged#d$d%ged&d'd(ged&d)d*ged!d+d0ggdd1ddeded&d2dged&ddged#d3d4gedgdgdd5d+d eded#d$d%ged&d'd(ged!d+d6ggdd7ddd8d eded#d$d%ged!d)d ged!d9d:ggd;dgd?edd@d ged&ddgedgdgdAdBddeded>gd?edd@d ged>gdCedgdgddDd dEededgdFedgdGeddHdIgeddJdKgedgdLed#dMdNggdAdOd dEededgdGeddHdIgeddJdKgedgdLed#dPdQged#dMdNggdAdRd dEeded#dPdSgedgdGeddHdIgeddJdKged#dMdNggdAdTd dEeded#dPdUgedgdGeddHdIgeddJdKged#dMdNggdAdVd dEeded#dPdWgedgdGeddHdIgeddJdKged#dMdNggdAdXd deded!d)dgedgdGed!dHdYged#dMdNggdAdZdd eded!d)d[gedgdGed#d$d%ggdd\d]d.eded#d$d%gedgdGed!d)d[ggdd]d.eded#d$d%ged#dPd4ggdd]d.eded#d$d%gedgd^gdd_Ze d`e edadbdci        dnddeeeeefdeedfedgedhediedjedkefdldmZdS)o) HTTPError)UnionN)dumps) _QUERY1_URL_)YfData)dynamic_docstring'generate_list_table_from_dict_universal) EquityQuery) FundQuery)ETFQuery) QueryBaser r r z/v1/finance/screenerz/predefined/savedguid)offsetcountuserId userIdTypeaggressive_small_caps eodvolumedescandzis-in)exchangeNMSNYQltzepsgrowth.lasttwelvemonths) sortFieldsortTypequery day_gainers percentchangeDESCgteqregionusgteintradaymarketcapi5w intradayprice dayvolumei: day_losersASCgi Ngrowth_technology_stocksz quarterlyrevenuegrowth.quarterlysector Technology most_activesi@KLmost_shorted_stocksz,short_percentage_of_shares_outstanding.value avgdailyvol3mi@ )rrrr r!small_cap_gainersundervalued_growth_stocksbtwn)zperatio.lasttwelvemonthsr pegratio_5y)r rr!undervalued_large_caps)r+ld( lh]conservative_foreign_funds fundnetassets) categorynamezForeign Large ValuezForeign Large BlendzForeign Large GrowthzForeign Small/Mid GrowthzForeign Small/Mid BlendzForeign Small/Mid Value)performanceratingoverallr-initialinvestmentiannualreturnnavy1categoryrank2)riskratingoverallr rr&rNAShigh_yield_bondr?High Yield Bondportfolio_anchorsz Large Blendsolid_large_growth_fundsz Large Growthsolid_midcap_growth_fundszMid-Cap Growthtop_mutual_fundsi top_etfs_us top_performing_etfsannualreportnetexpenseratio) r?zCorporate BondzEmerging Markets Bondz$Emerging-Markets Local-Currency BondrHzIntermediate-Term BondzLong-Term BondzInflation-Protected BondzMultisector BondzNontraditional BondzShort-Term BondzUltrashort Bondz World Bond)technology_etfs bond_etfspredefined_screenersTzPredefined queries (Dec-2024))bulletstitler!rsizerrsortAscrrc Cst|d} ddddddd} |d ur|d krtd |d ur&|d kr&td |d urMt|trMt|} | d }|d ur?| d}|d urK| ddk}i} |||||||d} ddddd} d } t|tr|d ur~tjdtdd|}d }| d| d<| d=|| d<| D] \}}|d ur|| |<q| j t | d}z| Wnt y|tvrtd|dw|d d!dSt|tr| D]}|| vs| |d ur| || |<q| d"rd#nd$| d<| d"=| } || d <n td%t|d&|d urtd't| d tr d(| d)<nt| d trd*| d)<n t| d tr%d+| d)<| d | d <t| d,dd-}| jt|| d.}| |d d!dS)/a Run a screen: predefined query, or custom query. :Parameters: * Defaults only apply if query = EquityQuery, FundQuery, or ETFQuery query : str | Query: The query to execute, either name of predefined or custom query. For predefined list run yf.PREDEFINED_SCREENER_QUERIES.keys() offset : int The offset for the results. Default 0. size : int number of results to return. Default 100, maximum 250 (Yahoo) Use count instead for predefined queries. count : int number of results to return. Default 25, maximum 250 (Yahoo) Use size instead for custom queries. sortField : str field to sort by. Default "ticker" sortAsc : bool Sort ascending? Default False userId : str The user ID. Default empty. userIdType : str Type of user ID (e.g., "guid"). Default "guid". Example: predefined query .. code-block:: python import yfinance as yf response = yf.screen("aggressive_small_caps") Example: custom query .. code-block:: python import yfinance as yf from yfinance import EquityQuery q = EquityQuery('and', [ EquityQuery('gt', ['percentchange', 3]), EquityQuery('eq', ['region', 'us']) ]) response = yf.screen(q, sortField = 'percentchange', sortAsc = True) To access predefineds query code .. code-block:: python import yfinance as yf query = yf.PREDEFINED_SCREENER_QUERIES['aggressive_small_caps'] {predefined_screeners} )sessionrrtickerFrr)rrrrWrrNz.Yahoo limits query count to 250, reduce count.z,Yahoo limits query size to 250, reduce size.r!rr asc)rrrVrrWrrzfinance.yahoo.comfalsezen-USUS) corsDomain formattedlangr(zQScreen 'size' argument is deprecated for predefined screens, set 'count' instead.r) stacklevelrVrscrIds)urlparamszyfinance.screen: 'z%' is probably not a predefined query.financeresultrWr0r$z*Query must be type str or QueryBase, not ""zNo query providedEQUITY quoteType MUTUALFUNDETF),:) separators ensure_ascii)datard)r ValueError isinstancestrPREDEFINED_SCREENER_QUERIESlowerwarningswarnDeprecationWarningitemsget_PREDEFINED_URL_raise_for_statusrprintjsonrtypeEqyQyFndQyEtfQyto_dictrpost_SCREENER_URL_)r!rrVrrrWrrrX_datadefaults post_queryfields params_dictkvresprpresponser]/home/dinkstrade/pdmp-scanner/venv/lib/python3.10/site-packages/yfinance/screener/screener.pyscreen?s =          r)NNNNNNNN)yfinance._httprtypingrrvr~ryfinance.constr yfinance.datarutilsrr r!r rr rr rrrr{!PREDEFINED_SCREENER_BODY_DEFAULTSrtrsintboolrrrrrs          DD8 , , 88PPDDD8,!,#  )