Config#

yfinance has a new global config for sharing common values:

>>> import yfinance as yf
>>> yf.config
{
  "network": {
    "proxy": null,
    "retries": 0
  },
  "debug": {
    "hide_exceptions": true,
    "logging": false
  }
}
>>> yf.config.network
{
  "proxy": null,
  "retries": 0
}

Network#

  • proxy - Set proxy for all yfinance data fetches.

    yf.config.network.proxy = "PROXY_SERVER"
    
  • retries - Configure automatic retry for transient network errors. The retry mechanism uses exponential backoff (1s, 2s, 4s…).

    yf.config.network.retries = 2
    

Debug#

  • hide_exceptions - Set to False to stop yfinance hiding exceptions.

    yf.config.debug.hide_exceptions = False
    
  • logging - Set to True to enable verbose debug logging.

    yf.config.debug.logging = True
    

Locale#

Localized fields (longName, shortName, …) follow yf.config.locale. The default is en-US / US. Switch the Yahoo locale once at session start and every subsequent v7 / v10 endpoint call (Ticker.info, Ticker.fast_info, Ticker.calendar, earnings_dates, …) inherits it:

import yfinance as yf
yf.config.locale.lang = "zh-Hant-HK"
yf.config.locale.region = "HK"
yf.Ticker("1810.HK").info["longName"]   # → '小米集團-W'

yf.config.locale.lang = "ja-JP"
yf.config.locale.region = "JP"
yf.Ticker("7203.T").info["longName"]    # → 'トヨタ自動車'

Yahoo only returns translated values for tickers natively listed in that locale; Ticker("AAPL") keeps returning "Apple Inc." under ja-JP.