Skip to main content

polars-yahoo

PyPI version License: Apache 2.0 Python versions CI Coverage Code style: ruff uv OpenSSF Scorecard Rhiza

Minimal Yahoo Finance price history, returned as polars DataFrames. No pandas, two dependencies (polars, curl_cffi), and three things only: OHLCV bars, dividends and splits.

Inspired by yfinance; written from scratch. Not affiliated with Yahoo — check Yahoo's terms of use before relying on the data.

Install

uv add polars-yahoo

Use

These calls go to Yahoo, so the README check skips this block (+RHIZA_SKIP).

import polars_yahoo as yh

# One symbol
yh.Ticker("AAPL").history(period="1y")  # daily bars
yh.Ticker("AAPL").history(start="2024-01-01", end="2024-07-01", interval="1wk")
yh.Ticker("SAP.DE").history(period="5d", interval="5m")  # intraday

# Several symbols, fetched concurrently, stacked into one long frame
yh.download(["AAPL", "MSFT", "SAP.DE"], period="6mo")

# Corporate actions (full history)
yh.Ticker("AAPL").dividends()
yh.Ticker("AAPL").splits()

Output

Price frames are long-format, one row per ticker and bar:

column type notes
ticker String
date Date daily and longer intervals; the exchange-local calendar date
timestamp Datetime(us, tz) intraday intervals instead of date; exchange time zone
open, high, low, close Float64 as Yahoo reports them, unadjusted
adj_close Float64 Yahoo's split- and dividend-adjusted close; null for intraday
volume Int64

download converts intraday timestamps to UTC when the symbols trade in different time zones, because a polars column holds one time zone.

To adjust OHLC yourself:

import polars as pl

df = pl.DataFrame({"open": [10.0], "high": [12.0], "low": [9.0], "close": [11.0], "adj_close": [5.5]})
adjusted = df.with_columns(pl.col("open", "high", "low", "close") * pl.col("adj_close") / pl.col("close"))
print(adjusted.row(0))
(5.0, 6.0, 4.5, 5.5, 5.5)

dividends() returns ticker, date, dividend; splits() returns ticker, date, numerator, denominator, ratio.

Arguments

  • period: 1d 5d 1mo 3mo 6mo 1y 2y 5y 10y ytd max (ignored when start is given) max is sent to Yahoo as a window starting 1900-01-01, because for range=max Yahoo returns monthly bars whatever the interval; it is rejected for intraday intervals.
  • interval: 1m 2m 5m 15m 60m 90m 1h 1d 5d 1wk 1mo 3mo. Yahoo caps how far back intraday data goes (about 7 days for 1m, 60 days for other minute bars, 730 days for hourly).
  • start / end: date, datetime or ISO string. Naive values are UTC; end is exclusive.
  • prepost: include pre- and post-market bars (intraday only).
  • timeout, retries, backoff (keyword-only, on Ticker(...) and download): seconds to wait for each response (default 30); how many times a failed request is retried (default 3); and the cap on the wait before the first retry (default 1 second). The cap doubles with each retry, and each actual wait is random between 0 and the cap, so symbols that fail together in download don't all retry at the same moment. Retried are HTTP 429, any 5xx, and transport failures (timeout, DNS or connection error); other responses, such as a 404, are not.

Errors

All errors subclass polars_yahoo.YahooError: TickerNotFoundError (unknown or delisted symbol), RateLimitError (HTTP 429 persisted after retries with exponential backoff), NetworkError (no HTTP response at all, after retries: timeout, DNS or connection failure; carries reason) and ResponseError (any other unusable response; carries status and reason). download skips failing symbols with a warning unless raise_errors=True.

What is deliberately missing

No price repair heuristics, no quote/info/fundamentals, no caching, no async API. The scope is kept small on purpose.

Development

uv sync
uv run pytest            # offline tests, network is faked
uv run pytest -m live    # one round trip against Yahoo

Metadata

Release files for polars-yahoo 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for polars-yahoo 0.3.1
File Size Uploaded Provenance Actions
polars_yahoo-0.3.1.tar.gz 172.9 kB With provenance Details for polars_yahoo-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for polars-yahoo 0.3.1
File Interpreter ABI Platform Actions
polars_yahoo-0.3.1-py3-none-any.whl Python 3 none any Details for polars_yahoo-0.3.1-py3-none-any.whl

Total release size: 192.2 kB

Release files / polars_yahoo-0.3.1.tar.gz

Download URL polars_yahoo-0.3.1.tar.gz
Size 172.9 kB
Tags Source
SHA-256 checksum
How to use checksums
aa49012353409438c35b95a479a3a72c977eb2b7328add204ccc1c633bc3b36c
BLAKE2b-256 checksum
How to use checksums
e946260f4032d1e21aecbaf2092b99ceeccdf6f66819a3875c680023086f0051
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / polars_yahoo-0.3.1-py3-none-any.whl

Download URL polars_yahoo-0.3.1-py3-none-any.whl
Size 19.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc72ee40d71add156a33a8c6443bc1395440e609a368d554e245425011ad65ba
BLAKE2b-256 checksum
How to use checksums
9cabe04dadfba5e47fe83b048ed185a70030034eb97aa087a6810581d06b6dd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for polars-yahoo 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for polars_yahoo-0.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page