Pythonで株の自動売買ツールを証券会社APIに接続|実際の株価データ取得まで進んだ

AI自動売買開発

Pythonで日本株の自動売買ツールを開発しています。

これまでは過去の株価データを使ったバックテストや、注文管理の仕組みを作ってきました。しかし、実際の相場で使うには、まだ大きな課題がありました。

証券会社から現在の株価や板情報を取得し、自作ツールで利用できるようにすることです。

そこで今回、三菱UFJ eスマート証券の「kabuステーションAPI」にPythonから接続し、実際の市場データを取得する機能を作りました。

結論からいうと、トヨタ自動車を含む複数銘柄の株価・板情報を取得でき、データをCSV・JSON・ChatGPT向けテキストに整理するところまで進みました。

ただし、実環境では5秒のタイムアウトや、5銘柄中2銘柄だけ取得に失敗する現象も発生しています。

この記事では、接続に成功したという結果だけでなく、実際に起きたエラーと、取得したデータをどのように使える形にしたのかを紹介します。

なお、今回確認したのは市場データの取得機能です。実際の注文や資金を使った売買は行っていません。

今回の開発でできたこと

まず、今回確認できた内容を整理します。

項目今回の結果
証券会社APIへの認証テスト環境・本番環境で確認
株価・板情報の取得実際の銘柄で成功
口座・保有株・注文情報の参照取得を確認
複数銘柄の取得一時的な失敗後、5銘柄すべて成功
市場データの整理Market Snapshotを実装
データの出力CSV・JSON・ChatGPT向けテキストに対応
自動テスト271件すべて通過
実際の注文・売買未実施

今回の開発で大きかったのは、これまで扱っていた過去の株価データだけでなく、証券会社APIから取得した市場データを自作ツールで扱えるようになったことです。

一方、データを取得できることと、そのデータを使って安全に注文できることは別の問題です。この点は、後半で紹介する実際のエラーからも分かりました。

なぜkabuステーションAPIを選んだのか

最初の接続先には、三菱UFJ eスマート証券の「kabuステーションAPI」を選びました。

APIとは、外部のサービスとプログラムが情報をやり取りするための仕組みです。

kabuステーションAPIでは、市場データの取得に加え、注文に関する機能も提供されています。

今回このAPIを選んだ理由は、個人でも公式に提供されているAPIを利用でき、データ取得から将来の注文機能まで段階的に開発できると考えたからです。

現在考えている開発の順番は、次の通りです。

  • 実際の市場データを取得する
  • 取得したデータを検証し、売買判断に利用できる形にする
  • 実際のお金を使わない模擬運用で確認する
  • 安全対策が整った段階で、少額の実運用を検討する

最初から自動注文を動かすのではなく、一つずつ確認しながら進めています。

なお、APIの利用条件や提供機能は変更される可能性があります。導入を検討する場合は、証券会社の公式案内を確認してください。

最初に作ったのは「注文しない」データ取得機能

API接続の最初の段階では、注文機能を動かさず、情報を読み取る処理から実装しました。

今回の設計では、市場データを取得する部分と、実際に注文する部分を分離しています。

これは、データ取得の処理から意図せず注文機能を呼び出してしまうリスクを抑えるためです。

さらに、証券会社との認証や通信を担当する処理も分け、売買判断のプログラムがAPIの認証情報を直接扱わない構造にしました。

ただし、プログラムの役割を分離しただけで、誤発注や認証情報の漏えいを完全に防げるわけではありません。実運用には追加の安全対策が必要です。

実際の証券会社APIから株価を取得できた

実装後は、仮のデータを使ったテストだけで終わらせず、kabuステーションを起動して実際に接続しました。

取得したデータをPythonで加工し、独自の「Market Snapshot」形式で出力しています。

今回確認できたのは、株価・前日比・始値・高値・安値に加え、VWAP、出来高、売買代金、最良気配、板の売買数量などです。

以下は、2026年10月9日15:30時点の実際の市場データを取得・出力した結果です。

kabuステーションAPIから取得したトヨタ自動車(7203)の2026年10月9日15時30分時点の市場データを、PythonのMarket Snapshot形式で表示した実行画面

なお、取得を実行したのは10月11日の休場日であり、表示されているのは直近営業日のデータです。また、今回行ったのは市場データの取得と変換のみで、実際の売買注文は行っていません。

今回の検証により、証券会社APIから取得した市場データを、自作の分析用フォーマットに変換できることを確認しました。ただし、正式なAPI接続処理には修正が必要な箇所が残っており、自動売買システム全体の完成を意味するものではありません。

これにより、証券会社APIから取得した実際の市場情報を、自作ツールの分析用フォーマットで表示できることを確認しました。

ただし、最初の試行から問題なく取得できたわけではありません。

最初の問題:5秒ではタイムアウトした

本番環境でトヨタ自動車の市場データを取得しようとした際、最初は5秒待っても応答がなく、タイムアウトしました。

タイムアウトとは、設定した待ち時間内に処理が完了せず、通信を打ち切ることです。

そこで待ち時間を20秒に変更して確認したところ、今度は正常にデータを取得できました。

試行待ち時間の設定結果
1回目5秒タイムアウト
2回目20秒取得成功

ここで注意したいのは、「APIの応答には常に5秒以上かかる」と分かったわけではないことです。

今回の記録から分かるのは、5秒の設定では取得に失敗し、20秒の設定では成功したということだけです。

一時的な通信状態、API側の処理、取得プログラムの動作など、原因は複数考えられます。この時点では特定できませんでした。

また、タイムアウトを長くすれば、すべての問題が解決するわけでもありません。

自動売買では、データ取得を待っている間にも株価が動きます。取得に時間がかかった場合、その情報を売買判断に使ってよいか、別途確認する必要があります。

次の問題:5銘柄のうち2銘柄だけ取得に失敗

トヨタ自動車での取得確認後、複数銘柄をまとめて取得する処理も試しました。

対象にしたのは、次の5銘柄です。

  • トヨタ自動車(7203)
  • キオクシアホールディングス(285A)
  • アドバンテスト(6857)
  • フジクラ(5803)
  • ディスコ(6146)

最初の一括取得では、アドバンテストとフジクラの2銘柄でエラーが発生しました。

ところが、この2銘柄を個別に確認すると、主要なデータを取得できました。

さらに、改めて5銘柄をまとめて取得すると、今度はすべて成功しました。

確認内容結果
5銘柄の一括取得(初回)アドバンテスト・フジクラが失敗
失敗した2銘柄の個別取得主要データの取得に成功
5銘柄の一括取得(再試行)5銘柄すべて成功

この結果から、アドバンテストとフジクラがAPIで取得できない銘柄だった、とは考えにくくなりました。

ただし、一時的な通信の問題だったのか、取得処理の問題だったのかまでは分かっていません。

今回の経験から、複数銘柄のうち一部だけ取得できなかった場合に、成功した銘柄と失敗した銘柄を区別して扱う必要があると感じました。

例えば、5銘柄を比較して売買候補を選ぶ処理で、2銘柄のデータが欠けたまま判断すれば、本来比較すべき候補を見落とす可能性があります。

そのため、取得失敗を単に無視するのではなく、データが揃っているかを確認する仕組みも必要になります。

取得した市場データをMarket Snapshotにまとめる

APIからデータを取得できるようになったので、次に考えたのが、その情報をどう使うかです。

例えば、現在値だけ取得できても、実際の売買判断には十分とは限りません。

現在値が当日の高値に近いのか、安値に近いのか。VWAPより上にあるのか。買い板と売り板の価格差はどのくらいあるのか。

こうした情報を一つにまとめるため、Market Snapshotという機能を作りました。

Market Snapshotは、ある時点の市場情報を整理したデータです。

今回の実装では、主に次のような項目を扱います。

情報分析で確認したいこと
現在値・前日比前日からどの程度動いているか
始値・高値・安値当日の値動きの範囲
VWAP現在値と出来高加重平均価格の位置関係
出来高・売買代金取引の規模
買い気配・売り気配売買可能な価格帯の参考情報
スプレッド買い気配と売り気配の価格差
板情報各価格帯の注文数量
当日高値・安値内の位置現在値が値幅のどこにあるか

VWAPは、その日の約定価格を売買数量で加重平均した価格です。現在値がVWAPより上か下かは、場中の値動きを見る際の参考情報になります。

また、スプレッドは買い気配と売り気配の価格差です。価格差が大きい場合、希望した価格で売買しにくい可能性があります。

ただし、VWAPや板情報だけで株価の上昇・下落を予測できるわけではありません。

今回の目的は、こうした市場情報をまとめ、後続の分析処理で扱えるようにすることです。

CSV・JSON・ChatGPT向けテキストに出力

Market Snapshotにまとめた情報は、用途に応じて3種類の形式で出力できるようにしました。

証券会社APIから取得した市場データをCSV・JSON・ChatGPT向けに整理する流れ

CSV:Excelで確認・比較するため

CSVは、Excelなどの表計算ソフトでも扱いやすい形式です。

複数銘柄の現在値、出来高、VWAPなどを一覧にして確認したいときに利用できます。

JSON:ほかのPythonプログラムへ渡すため

JSONは、項目名と値を組み合わせて情報を表現できるデータ形式です。

今回取得した情報を、今後の分析機能や模擬運用システムに渡す際に利用する想定です。

ChatGPT向けテキスト:普段の株式分析にも利用したい

個人的に使いたかったのが、ChatGPT向けテキストへの出力です。

これまで場中にChatGPTへ株式分析を相談するときは、HYPER SBI2のチャートや板をスクリーンショットして送ることがありました。

ただ、複数銘柄の現在値や出来高、VWAPなどを比較したい場合、画像を何枚も用意するのは手間がかかります。

今回の機能を使えば、証券会社APIから取得した数値を、ChatGPTに渡しやすい形へ整理できます。

例えば、将来的には次のような使い方を考えています。

  • 監視している複数銘柄の市場情報を取得する
  • 取得時刻とともに、現在値・出来高・VWAPなどを整理する
  • ChatGPTへデータを渡し、銘柄間の状況を比較する
  • 分析結果を参考に、人間が売買候補を確認する

ただし、今回確認できたのはChatGPTへ渡すためのテキストを出力する機能までです。

ChatGPTによる分析精度が改善したか、売買成績が向上したかは、まだ検証していません。

また、口座情報や認証情報などの機密情報は、外部のAIサービスへ渡さないよう注意する必要があります。

API接続後に見えた、次の課題

今回の開発で、市場データを取得するところまでは進みました。

しかし、自動売買に利用するには、取得したデータをそのまま信用するわけにはいきません。

例えば、次のようなケースを考える必要があります。

  • 取得した株価が数分前の古いデータだった場合
  • 複数銘柄のうち、一部だけデータが欠けている場合
  • 通信がタイムアウトした場合
  • 明らかに異常な価格が返ってきた場合
  • 取得した時点から注文判断までに時間が経過した場合

特に重要なのは、「データを取得できたか」だけでなく、「そのデータを今の売買判断に使ってよいか」という確認です。

過去の株価データを使うバックテストでは、あらかじめ用意したデータを前提に売買ルールを検証できます。

しかし実際の市場では、通信の遅延やデータの欠損が発生することがあります。

そのため、API接続に成功したからといって、そのまま注文処理へ進むことはしませんでした。

この後の開発では、古いデータや異常値の検知、注文状態の確認、二重発注防止などの安全対策を追加しています。

これらの実装内容については、次の記事で詳しく紹介します。

今回の開発で分かったこと

今回、三菱UFJ eスマート証券のkabuステーションAPIへ接続し、実際の市場データをPythonで取得できるようになりました。

また、取得した情報をMarket Snapshotにまとめ、CSV・JSON・ChatGPT向けテキストへ出力する機能も作りました。

一方で、実際の接続確認では5秒のタイムアウトや、5銘柄のうち2銘柄だけ取得できない現象も経験しています。

個人的に今回最も重要だったのは、APIにつながることと、そのデータを安全に使えることは違うと確認できたことです。

自動売買ツールの開発は、売買ルールの成績を良くすることだけではありません。

市場データを正しく取得し、問題が起きたときには無理に処理を続けず、適切に止まる仕組みも必要です。

今後は、取得データの安全性を確認したうえで、実際のお金を使わない模擬運用へ進めることを目指します。

自動売買ツール開発の現在地

現在の開発状況を整理します。

  • ✓ バックテスト・売買ルールの検証
  • ✓ 実運用を想定した注文管理の土台
  • ✓ 三菱UFJ eスマート証券APIへの接続
  • ✓ 実際の株価・出来高・板情報の取得
  • ✓ Market SnapshotとCSV・JSON・ChatGPT向け出力(今回)
  • ✓ 誤発注・データ異常・セキュリティ対策の追加実装(次回紹介)
  • → 資金管理・損失上限・緊急停止機能の整備
  • → 実資金を使わない模擬運用
  • → 少額・人間の確認を伴う実運用
  • → 実運用の結果を検証しながら段階的に自動化

過去の開発記事は、以下のページにまとめています。

日本株AI自動売買ツール開発記録|これまでの検証と現在地

※本記事は個人で開発しているツールの検証記録です。特定の証券会社や投資手法を推奨するものではありません。APIの利用条件や機能は変更される可能性があります。

コメント

タイトルとURLをコピーしました