Add optional retry mechanism for transient network errors - #2627

curl_cffi can't do this?

curl_cffi doesn’t provide the high-level retry logic that yfinance needs. It can retry some low-level transport errors, but it cannot distinguish transient vs. permanent ticker errors or propagate retry settings through threaded/bulk downloads — especially when using Threads. I download around 1500 tickers in different environments once per day, and 2–20 of them consistently fail due to timeouts. I’ve already written my own wrapper, but adding this logic directly inside the library is just a couple of lines of code and avoids having to parse curl_cffi’s textual output, which is very inconvenient.

There is example:
2025-11-18 17:24:10,492 [ERROR] ['MYFW']: Timeout('Failed to perform, curl: (28) Connection timed out after 10002 milliseconds. See https://curl.se/libcurl/c/libcurl-errors.html first for more details.')
2025-11-18 17:24:10,492 [ERROR] ['VRNS']: Timeout('Failed to perform, curl: (28) Connection timed out after 10001 milliseconds. See https://curl.se/libcurl/c/libcurl-errors.html first for more details.')

Such timed outs are always fixed by second retry. If second retry is inside of library no need to write an outer fix.

Fair retort. Can it be moved into YfData?

I'm working on adding a new config class here #2525 https://github.com/ranaroussi/yfinance/blob/feature/expose-exceptions-v2/yfinance/config.py.

So then won't need to add any function parameters, just set once at top of script. But first I need to get it merged in.

Fair retort. Can it be moved into YfData?

I'm working on adding a new config class here #2525 https://github.com/ranaroussi/yfinance/blob/feature/expose-exceptions-v2/yfinance/config.py.

So then won't need to add any function parameters, just set once at top of script. But first I need to get it merged in.

Done

Do you need any help? I can write docs. Do all dirty job.

#2525 now merged in so you can incorporate new YfConfig. You probably want to rebase to dev HEAD.

Done

Did you explore moving the retry logic into YfData? Then all fetches will benefit.

Did you explore moving the retry logic into YfData? Then all fetches will benefit.

Retry logic has been moved from multi.py to data.py
Now all API calls (download, history, info, earnings, options, news) receive a retry.
This is exactly what you asked for.

I'm happy with code. Do you mind doing a git squash? https://ranaroussi.github.io/yfinance/development/code.html#git-stuff

And update the docs https://ranaroussi.github.io/yfinance/development/documentation.html

Done
United all commits into one
Updated documentation for retries parameter