# matplotlib/mplfinance

Financial Markets Data Visualization using Matplotlib

Repository: https://github.com/matplotlib/mplfinance
Canonical: https://ross.abutalabs.com/products/mplfinance
Homepage: https://pypi.org/project/mplfinance/
Language: Python
License: NOASSERTION
License Family: other
Topics: ohlc-plot, finance, matplotlib, ohlc, ohlcv, ohlc-chart, candlestick-chart, candlestick, mplfinance, trading-days, ohlc-data, intraday-data, market-data, candlestickchart
Last push: 2024-08-08T17:23:11+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2463, "days_push": 755, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4425, forks 678 (observed 2026-08-28T04:08:48.870738+00:00)

## What it is
A Python library built on matplotlib and pandas for visualizing and visually analyzing financial market data. It provides a high-level API for candlestick and OHLC charts, technical studies overlays, subplots, and price-movement plots like Renko and Point & Figure.

## Use cases
- plot candlestick charts from OHLCV data in pandas
- visualize intraday stock market data
- add technical analysis indicators to price charts
- create Renko or point-and-figure price-movement plots
- draw support and resistance trend lines on financial charts
- animate real-time updating market charts

## When to choose
- you already use pandas DataFrames for market data and want quick financial plots
- you need candlestick/OHLC visualization with matplotlib-level customization
- you want to overlay custom technical studies on price charts

## When to avoid
- you need interactive web-based charting like TradingView-style dashboards
- you need backtesting or trading execution, not just visualization
- your project doesn't use matplotlib/pandas

## Facets
- artifact type: library
- maturity: active
- function: data-visualization, charts
- domain: fintech, data-visualization
- platform: python, cross-platform
- tags: candlestick-chart, ohlc, matplotlib, pandas, technical-analysis, trading, finance

## Member repositories
- matplotlib/mplfinance (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:48.870738+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:57.578574+00:00, confidence not recorded.
  - readme: https://github.com/matplotlib/mplfinance (fetched 2026-08-28T04:08:48.870738+00:00, sha ee68e5ed9c6f)
  - homepage: https://pypi.org/project/mplfinance/ (fetched 2026-08-29T09:08:30.796852+00:00, sha 4b4e8fead74a)
  - registry_pypi: https://pypi.org/pypi/mplfinance/json (fetched 2026-08-29T09:08:30.806143+00:00, sha 75dc5dc29e1a)
- Data as of 2026-08-30T08:39:29.467469+00:00.