株価チャートビューアー

1. アプリ概要

銘柄コードを入力してyfinanceで株価を取得しmatplotlibで移動平均線付きチャートを表示するアプリ。

このアプリはdataカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）・yfinance・matplotlib、難易度は ★★★ です。

このアプリは「データ処理」カテゴリです。データ分析・処理アプリは Python の真骨頂と言える領域で、生データから意味ある可視化・要約までを一通り体験できます。tkinter（標準ライブラリ）・yfinance・matplotlib を活かして実装するこの構造は、他のアプリにも応用が効きます。

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

チャートの元になる株価データの取り方（日本株の書き方・期間と間隔の指定・取得できないケース）は、Pythonで株価を取得する方法（yfinance）で実行結果つきに解説しています。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

2. 機能一覧

• ティッカーと期間を指定して yfinance で株価（OHLCV）を取得（yf.Ticker(symbol).history(period=..., auto_adjust=True)）
• 期間は PERIODS の5種類（1ヶ月・3ヶ月・6ヶ月・1年・2年）から選択
• チャートは「ローソク足」「折れ線」を切り替え表示（chart_var）
• MA_WINDOWS = (5, 25) の移動平均線をチェックボックスで重ね描き（データが足りない期間は描かれない）
• 出来高を下段のサブプロットに棒グラフで表示（上昇日・下落日で色分け）
• 「▶ 取得・表示」ボタン（_fetch()）で操作
• キー <Return> から _fetch() を実行
• 入力例のボタン（EXAMPLE_SYMBOLS = ("7203.T", "9984.T", "AAPL", "MSFT")）を押すと、その文字列がティッカー欄に入って取得まで進む（ティッカーの書き方を確かめるための例で、銘柄の推奨ではありません）
• ttk.Treeview による表形式の一覧表示（直近50件の日付・始値・高値・安値・終値・出来高）
• 取得は threading.Thread の別スレッドで行い、結果は root.after() で画面へ戻す（取得中も画面が固まらない）
• 取得失敗・データ0件は messagebox.showerror()・messagebox.showwarning() で通知し、アプリは終了しない
• ステータスバーに終値・前営業日比・取得期間・取得時刻を表示
• ウィンドウはタイトル「株価チャートビューアー」・サイズ 1071x782 で起動

3. 事前準備・環境

Windows 11（実機）で、ティッカー 7203.T・期間「3ヶ月」「1年」の取得と描画、存在しないティッカー、通信できない状態の3ケースを実行して確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動して画面が表示されるところまで確認しました（株価の取得は Windows 11 での確認です）。macOS は未検証です。

• Python 3.10 以上（確認は 3.12.10）
• OS: Windows 11（実機で実行して確認）／Linux Mint 22.3（仮想マシンで起動を確認）
• インターネット接続（「取得・表示」ボタン・入力例ボタン・Enter キーのいずれかで取得を実行したときだけ Yahoo! Finance と通信します）

インストールが必要なライブラリ

pip install yfinance matplotlib

yfinance のインストール時に pandas などが一緒に入ります。ティッカーの書き方（日本株は 7203.T のように .T を付ける）や、期間・間隔の指定、データが取れないケースは、Pythonで株価を取得する方法（yfinance）で実行結果つきに解説しています。

4. 完全なソースコード

"""株価チャートビューアー（tkinter + yfinance + matplotlib）

ティッカーと期間を指定して Yahoo! Finance の株価（OHLCV）を yfinance で取得し、
ローソク足／折れ線チャート・移動平均線・出来高・データ表を表示する学習用サンプル。

- 起動しただけでは通信しない（「取得・表示」ボタン・入力例ボタン・Enter キーのいずれかで取得を実行したときだけ通信する）
- 取得に失敗しても落ちない（メッセージを出して待機状態に戻る）
- 表示するのは取得した数値そのままで、売買の判断は行わない
"""
import tkinter as tk
from tkinter import ttk, messagebox
import threading
from datetime import datetime

try:
    import yfinance as yf
    import matplotlib
    matplotlib.use("TkAgg")
    from matplotlib.figure import Figure
    from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
    from matplotlib import font_manager
    import matplotlib.dates as mdates
    LIBS_AVAILABLE = True
except ImportError:
    LIBS_AVAILABLE = False

if LIBS_AVAILABLE:
    # グラフ内の日本語が豆腐（□）にならないよう、入っている和文フォントを1つ選ぶ
    _installed = {f.name for f in font_manager.fontManager.ttflist}
    for _name in ("Meiryo", "Yu Gothic", "Noto Sans CJK JP", "Noto Sans JP",
                  "Hiragino Sans", "IPAexGothic", "MS Gothic", "DejaVu Sans"):
        if _name in _installed:
            matplotlib.rcParams["font.family"] = _name
            break
    matplotlib.rcParams["axes.unicode_minus"] = False


class App077:
    """株価チャートビューアー"""

    # 画面の表示名 -> yfinance の period 文字列
    PERIODS = {"1ヶ月": "1mo", "3ヶ月": "3mo", "6ヶ月": "6mo",
               "1年": "1y", "2年": "2y"}
    MA_WINDOWS = (5, 25)
    # 動作確認用のティッカー入力例（銘柄の推奨ではない）。
    # 日本株は「証券コード + .T」、米国株はティッカーをそのまま書く書式の見本
    EXAMPLE_SYMBOLS = ("7203.T", "9984.T", "AAPL", "MSFT")
    UP_COLOR = "#26a69a"
    DOWN_COLOR = "#ef5350"
    PIP_HINT = "pip install yfinance matplotlib"

    def __init__(self, root):
        self.root = root
        self.root.title("株価チャートビューアー")
        self.root.geometry("1071x782")
        self.root.minsize(1071, 782)
        self.root.configure(bg="#1e1e1e")
        self._hist = None      # 直近に取得した DataFrame
        self._busy = False     # 取得中フラグ（二重クリック防止）
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="📈 株価チャートビューアー",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not LIBS_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ yfinance / matplotlib が未インストールです ("
                          + self.PIP_HINT + ")",
                     bg="#fff3cd", fg="#856404", font=("Arial", 9),
                     anchor="w", padx=8).pack(fill=tk.X)

        # 入力バー
        search_f = tk.Frame(self.root, bg="#2d2d2d", pady=6)
        search_f.pack(fill=tk.X)

        tk.Label(search_f, text="ティッカー:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        self.symbol_var = tk.StringVar(value="7203.T")
        entry = ttk.Entry(search_f, textvariable=self.symbol_var, width=10)
        entry.pack(side=tk.LEFT, padx=4)
        entry.bind("<Return>", lambda e: self._fetch())

        tk.Label(search_f, text="期間:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(8, 2))
        self.period_var = tk.StringVar(value="3ヶ月")
        ttk.Combobox(search_f, textvariable=self.period_var,
                     values=list(self.PERIODS.keys()),
                     state="readonly", width=8).pack(side=tk.LEFT)

        tk.Label(search_f, text="チャート:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(8, 2))
        self.chart_var = tk.StringVar(value="ローソク足")
        ttk.Combobox(search_f, textvariable=self.chart_var,
                     values=["ローソク足", "折れ線"],
                     state="readonly", width=10).pack(side=tk.LEFT)

        self.ma_var = tk.BooleanVar(value=True)
        ttk.Checkbutton(search_f, text="移動平均線(5/25)",
                        variable=self.ma_var,
                        command=self._redraw).pack(side=tk.LEFT, padx=8)

        self.fetch_btn = tk.Button(search_f, text="▶ 取得・表示",
                                   command=self._fetch,
                                   bg="#1565c0", fg="white", relief=tk.FLAT,
                                   font=("Arial", 10, "bold"), padx=12, pady=4,
                                   activebackground="#0d47a1", bd=0)
        self.fetch_btn.pack(side=tk.LEFT, padx=8)

        tk.Label(search_f,
                 text="※ Yahoo! Finance へ通信します（日本株は 7203.T のように .T を付ける）",
                 bg="#2d2d2d", fg="#888", font=("Arial", 8)).pack(side=tk.LEFT)

        # 入力例のボタン（毎回ティッカーを打たずに動作確認するためのもの）
        example_f = tk.Frame(self.root, bg="#2d2d2d", pady=2)
        example_f.pack(fill=tk.X)
        tk.Label(example_f, text="例:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        for sym in self.EXAMPLE_SYMBOLS:
            # lambda の既定引数 s=sym でループ変数をその場の値に固定する
            tk.Button(example_f, text=sym, bg="#37373d", fg="#cfd8dc",
                      relief=tk.FLAT, font=("Arial", 9), padx=6, bd=0,
                      command=lambda s=sym: (self.symbol_var.set(s),
                                             self._fetch())
                      ).pack(side=tk.LEFT, padx=2)
        tk.Label(example_f,
                 text="※ 銘柄の推奨ではなく、入力書式を確かめるための例です",
                 bg="#2d2d2d", fg="#888", font=("Arial", 8)).pack(side=tk.LEFT,
                                                                  padx=6)

        # チャートエリア
        self.chart_frame = tk.Frame(self.root, bg="#0d1117")
        self.chart_frame.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        if LIBS_AVAILABLE:
            self.fig = Figure(figsize=(9, 5), facecolor="#0d1117")
            self.ax_price = self.fig.add_subplot(211)
            self.ax_vol = self.fig.add_subplot(212, sharex=self.ax_price)
            self.fig.tight_layout(pad=2)
            self.mpl_canvas = FigureCanvasTkAgg(self.fig, master=self.chart_frame)
            self.mpl_canvas.get_tk_widget().pack(fill=tk.BOTH, expand=True)
        else:
            tk.Label(self.chart_frame,
                     text="yfinance と matplotlib をインストールすると"
                          "チャートが表示されます",
                     bg="#0d1117", fg="#555", font=("Arial", 11)).pack(
                expand=True)

        # データテーブル
        cols = ("date", "open", "high", "low", "close", "volume")
        self.tree = ttk.Treeview(self.root, columns=cols, show="headings",
                                 height=5)
        for col, text, width in [
            ("date",   "日付",   90),
            ("open",   "始値",   70),
            ("high",   "高値",   70),
            ("low",    "安値",   70),
            ("close",  "終値",   70),
            ("volume", "出来高", 90),
        ]:
            self.tree.heading(col, text=text)
            self.tree.column(col, width=width, anchor="center")
        tsb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL,
                            command=self.tree.xview)
        self.tree.configure(xscrollcommand=tsb.set)
        self.tree.pack(fill=tk.X, padx=8)
        tsb.pack(fill=tk.X, padx=8)

        self.status_var = tk.StringVar(
            value="ティッカーを入力して「取得・表示」を押してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _fetch(self):
        """入力を検証し、取得をワーカースレッドへ渡す"""
        if not LIBS_AVAILABLE:
            messagebox.showerror("エラー", self.PIP_HINT)
            return
        if self._busy:
            return
        symbol = self.symbol_var.get().strip().upper()
        if not symbol:
            messagebox.showwarning("警告", "ティッカーを入力してください")
            return
        label = self.period_var.get()
        period = self.PERIODS.get(label, "3mo")
        self._busy = True
        self.fetch_btn.config(state=tk.DISABLED)
        self.status_var.set(f"{symbol} を取得中...")
        threading.Thread(target=self._load_data,
                         args=(symbol, label, period), daemon=True).start()

    def _load_data(self, symbol, label, period):
        """別スレッドで yfinance から取得（UI 操作は after 経由で本体に戻す）"""
        try:
            hist = yf.Ticker(symbol).history(period=period, auto_adjust=True)
            # 場が開いていない当日ぶんなど、値が欠けた行が混じることがあるので落とす
            hist = hist.dropna(subset=["Open", "High", "Low", "Close"])
        except Exception as e:                      # 通信断・API 変更など
            self._post(self._on_error, symbol, f"{type(e).__name__}: {e}")
            return
        self._post(self._on_loaded, symbol, label, hist)

    def _post(self, func, *args):
        """ウィンドウが閉じられていても例外を出さずに UI へ結果を返す"""
        try:
            self.root.after(0, func, *args)
        except tk.TclError:
            pass

    def _on_loaded(self, symbol, label, hist):
        self._busy = False
        self.fetch_btn.config(state=tk.NORMAL)
        if hist is None or hist.empty:
            self.status_var.set(f"{symbol}: データが取得できませんでした")
            messagebox.showwarning(
                "データなし",
                f"{symbol} のデータが空でした。\n"
                "ティッカーの綴り（日本株は 7203.T のように .T が必要）と"
                "期間を確認してください。")
            return
        self._hist = hist
        self._draw_chart(symbol, hist)
        self._fill_table(hist)
        close = float(hist["Close"].iloc[-1])
        if len(hist) >= 2:
            prev = float(hist["Close"].iloc[-2])
            chg = close - prev
            pct = chg / prev * 100 if prev else 0.0
            diff_text = f"前営業日比: {chg:+.2f} ({pct:+.2f}%)  "
        else:
            diff_text = ""
        self.status_var.set(
            f"{symbol}  {label}  {len(hist)}件  "
            f"終値: {close:,.2f}  {diff_text}"
            f"期間: {hist.index[0]:%Y-%m-%d} 〜 {hist.index[-1]:%Y-%m-%d}  "
            f"取得: {datetime.now():%H:%M:%S}")

    def _on_error(self, symbol, message):
        self._busy = False
        self.fetch_btn.config(state=tk.NORMAL)
        self.status_var.set(f"{symbol}: 取得に失敗しました - {message}")
        messagebox.showerror(
            "取得エラー",
            f"{symbol} の取得に失敗しました。\n"
            "ネットワーク接続とティッカーを確認してください。\n\n" + message)

    def _redraw(self):
        """移動平均やチャート種類の切り替え時に、取得済みデータを描き直す"""
        if self._hist is not None and LIBS_AVAILABLE:
            self._draw_chart(self.symbol_var.get().strip().upper(), self._hist)

    @staticmethod
    def _to_int(value):
        """出来高が欠損（NaN）の銘柄でも落ちないように 0 として扱う"""
        return int(value) if value == value else 0

    def _draw_chart(self, symbol, hist):
        index = hist.index
        if getattr(index, "tz", None) is not None:
            index = index.tz_localize(None)
        dates = list(index.to_pydatetime())
        opens = [float(v) for v in hist["Open"]]
        highs = [float(v) for v in hist["High"]]
        lows = [float(v) for v in hist["Low"]]
        closes = [float(v) for v in hist["Close"]]
        vols = [self._to_int(v) for v in hist["Volume"]]

        self.ax_price.clear()
        self.ax_vol.clear()

        if self.chart_var.get() == "ローソク足":
            for d, o, h, l, c in zip(dates, opens, highs, lows, closes):
                color = self.DOWN_COLOR if c < o else self.UP_COLOR
                self.ax_price.plot([d, d], [l, h], color=color, linewidth=0.8)
                self.ax_price.bar(d, max(abs(c - o), 0.01), bottom=min(o, c),
                                  color=color, width=0.6, linewidth=0)
        else:
            self.ax_price.plot(dates, closes, color="#4fc3f7", linewidth=1.2,
                               label="終値")

        # 移動平均線（データが足りない期間は自動的に描かれない）
        if self.ma_var.get():
            for window, ma_color in zip(self.MA_WINDOWS, ("#ffd54f", "#ba68c8")):
                if len(closes) >= window:
                    ma = hist["Close"].rolling(window).mean()
                    self.ax_price.plot(dates, list(ma), color=ma_color,
                                       linewidth=1.0, alpha=0.9,
                                       label=f"MA{window}")
        handles, _ = self.ax_price.get_legend_handles_labels()
        if handles:
            self.ax_price.legend(facecolor="#161b22", edgecolor="#30363d",
                                 labelcolor="#c9d1d9", fontsize=7)

        self.ax_vol.bar(dates, vols,
                        color=[self.DOWN_COLOR if c < o else self.UP_COLOR
                               for o, c in zip(opens, closes)],
                        width=0.6, linewidth=0)

        for ax in (self.ax_price, self.ax_vol):
            ax.set_facecolor("#0d1117")
            ax.tick_params(colors="#8b949e", labelsize=7)
            for spine in ax.spines.values():
                spine.set_edgecolor("#30363d")
            ax.grid(True, color="#21262d", linewidth=0.5)
            ax.xaxis.set_major_formatter(mdates.DateFormatter("%m/%d"))
            ax.xaxis.set_major_locator(mdates.AutoDateLocator())

        self.ax_price.set_title(f"{symbol} 株価チャート（Yahoo! Finance / yfinance）",
                                color="#c9d1d9", fontsize=10, pad=4)
        self.ax_price.set_ylabel("価格", color="#8b949e", fontsize=8)
        self.ax_vol.set_ylabel("出来高", color="#8b949e", fontsize=8)
        self.fig.tight_layout(pad=2)
        self.mpl_canvas.draw()

    def _fill_table(self, hist):
        self.tree.delete(*self.tree.get_children())
        tail = hist.tail(50)
        for ts, row in reversed(list(tail.iterrows())):
            self.tree.insert("", tk.END,
                             values=(f"{ts:%Y-%m-%d}",
                                     f"{row['Open']:.2f}",
                                     f"{row['High']:.2f}",
                                     f"{row['Low']:.2f}",
                                     f"{row['Close']:.2f}",
                                     f"{self._to_int(row['Volume']):,}"))


if __name__ == "__main__":
    root = tk.Tk()
    app = App077(root)
    root.mainloop()

5. コード解説

株価チャートビューアーのコードを、実際に書かれている実装に沿って解説します。

6. ステップバイステップガイド

このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。

1. 1
   ファイルを作成する

   新しいファイルを作成して app077.py と保存します。外部ライブラリ matplotlib・yfinance を使います。先に pip install matplotlib yfinance を実行してください。

2. 2
   クラスの骨格を作る

   App077 クラスを定義し、__init__ と、末尾の root = tk.Tk() ～ mainloop() の最小構成を書いて、まず空のウィンドウが出ることを確認します。

3. 3
   ウィンドウを設定する

   title("株価チャートビューアー")・geometry("1071x782")・configure(bg="#1e1e1e")・minsize(1071, 782) をコンストラクタで設定します。

4. 4
   画面部品を並べる

   _build_ui() の中で、tk.Frame×4・tk.Label×10・ttk.Entry・ttk.Combobox×2・ttk.Checkbutton・tk.Button×5（ループで生成）・ttk.Treeview・ttk.Scrollbar を作って配置します（掲載コードと同じ並び順で書くとレイアウトが一致します）。まず表示だけ確認しましょう。

5. 5
   イベントを接続する

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（_fetch()）につなぎます。ループ生成のボタンは command=lambda s=sym: (self.symbol_var.set(s), self._fetch()) の形で接続します。bind("<Return>", ...) の登録も忘れずに。

6. 6
   中心になるメソッドを実装する

   アプリの本体である _fetch()（18行）・_draw_chart()（57行）・_on_loaded()（27行） を実装します。

7. 7
   動作確認する

   python app077.py で起動し、各ボタンが反応すること・キー操作（<Return>）が効くことを確認します。

7. カスタマイズアイデア

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

8. よくある問題と解決法

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は定型の発展課題です）。課題を試すには yfinance と matplotlib が要ります（pip install yfinance matplotlib）。どちらも取得済みのデータの見せ方を直す課題なので、通信は最初の1回で足ります。表示するのは取得した数値そのままで、売買の判断には使いません。

1. 課題1：チャートの種類を変えたら通信せずに描き直す

   「チャート:」を「折れ線」に変えても、もう一度「▶ 取得・表示」を押すまで描き直されません。「移動平均線(5/25)」のチェックと同じように、その場で描き直すようにしてください。

   期待結果：1度取得したあとに「ローソク足」から「折れ線」へ変えると、通信せずに折れ線へ変わる（下の帯の 取得: 12:34:56 の時刻はそのまま）。

   合格条件

   • 1度も取得していないときに切り替えても、何も描かれずエラーにもならない
   • 「移動平均線(5/25)」のチェックは、これまでどおり効く
   • 切り替えたあとに「▶ 取得・表示」を押すと、通信して帯の 取得: の時刻が新しくなる

   ヒント①（どこを触るか）: 触るのは _build_ui() の1か所です。self.chart_var をつないでいる ttk.Combobox(...) を変数で受け、bind("<<ComboboxSelected>>", lambda e: self._redraw()) を足します。
   ヒント②（使うもの）: _redraw() は取得済みの self._hist があるときだけ _draw_chart() を呼ぶ作りで、「移動平均線(5/25)」の command=self._redraw と同じ入口です。通信するのは _fetch() から始まる流れだけなので、描き直しで通信は起きません。
   つまずきやすい点: ttk.Combobox(...).pack(...) と1行で書くと pack() の戻り値の None になるため、変数へ受けてから bind します。ttk.Combobox には command= が無いので、チェックボックスと同じ書き方は使えません。「期間:」の欄は取り直しが要るぶん通信が増えるので、同じ扱いにはしないでください。

2. 課題2：描き直しのタイトルが入力欄につられないようにする

   _redraw() はグラフのタイトルに入力欄の文字を使います。取得せずにティッカーだけ打ち替えて描き直すと、古いデータのまま新しい銘柄名が出てしまいます。表示中の銘柄を覚えて使ってください。

   期待結果：7203.T を取得したあとに入力欄だけ AAPL へ打ち替え、取得は押さずに移動平均のチェックを外すと、タイトルが 7203.T 株価チャート（Yahoo! Finance / yfinance） のまま変わらない。

   合格条件

   • 「▶ 取得・表示」で AAPL を取得すると、タイトルも表も帯も AAPL になる
   • 取得に失敗したときは、前に表示していたチャートとタイトルがそのまま残る
   • 1度も取得していないときにチェックを操作しても、これまでどおり何も描かれない

   ヒント①（どこを触るか）: 触るのは2か所です。_on_loaded() の self._hist = hist の隣に、self._symbol = symbol を足します。あとは _redraw() が _draw_chart() へ渡している self.symbol_var.get().strip().upper() を、その変数へ差し替えます。
   ヒント②（使うもの）: __init__ の self._hist = None と並べて self._symbol = None を用意しておくと、1度も取得していないときも安全です。_on_loaded() が受け取る symbol は _fetch() で .strip().upper() 済みなので、そのまま使えます。
   つまずきやすい点: 表示している数値とタイトルの出どころが違うと、画面の銘柄名だけが先に変わってしまいます。株価を扱う画面では、この食い違いが読み違いのもとになります。_on_error() はチャートを描き直さない作りなので、取得に失敗しても前の表示が残る点はそのまま残してください。

3. 課題3：保存機能の追加

   処理結果をファイルに保存する機能を追加しましょう。