【J-Quants API】初心者向け！Cursorを使って投資分析してみよう！ #Python – Qiita

ここで、ひとつ大事なポイントをお伝えします。

これからプログラムを実行していくときは、
Cursorの中で、仮想環境（venv）を自分で作って、その中でコードを実行するようにしてください。

仮想環境とは、プロジェクトごとに使うライブラリを分けて管理できる、小さな専用スペースのことです。

仮想環境を使うと、

• ライブラリが他のプロジェクトに影響しない
• システム全体を汚さずに作業できる
• 将来エラーが起きにくくなる

という大きなメリットがあります。

Cursorは、プロジェクトを作成しただけでは仮想環境を自動で作ってくれないので、
自分で作る必要があります。やり方はとても簡単です。

Cursorに

仮想環境(venv)を作成してください

と指示してから作業を進めるだけです。
この一言をCursorに伝えると、AIがあなたの代わりに仮想環境の準備を進めてくれます。

Cursorへの指示はChatウィンドウで行います。
左下がAgentとなっていることを確認してください。askとなっている場合は会話はしてくれますが、プログラムの実行はしてくれません。

するとCursorがプログラムを書いて実行の許可を求めてきますので、Runを押して承認しましょう。

今度は仮想環境の有効化の承認を求めてきました。このように一つ指示を出すと、付随して必要な承認を求めてきますので、Runボタンで承認をしていきましょう。

• 仮想環境を作成する
• 仮想環境をアクティブにする（有効にする）
• その中でコードを実行する

これを意識しておくだけで、
今後のプログラミングもデータ分析も、トラブルなく快適に進められるようになります！

それでは、仮想環境の準備ができたら、いよいよAPIを使ったデータ取得に進んでいきましょう！

6. APIを使ってデータを取得しよう（準備）

JQUANTS_ID=あなたのメールアドレス
JQUANTS_PASSWORD=あなたのパスワード

このプロジェクトでは、J-Quants API（@https://jpx.gitbook.io/j-quants-ja）の仕様に基づいてコードを書いてください。
python-dotenvライブラリを使用して.envファイルから環境変数を読み込んでください。
必要なパッケージをインストールしてください。この時点ではpythonファイルを作成しないでください。

J-Quants APIのIDトークンを取得するPythonコードを書いてください。

.envファイルには、以下の環境変数があります。
JQUANTS_ID（メールアドレス）と JQUANTS_PASSWORD（パスワード）です。dotenvを使って読み込んでください。

ステップは以下の通りです。

【1】https://api.jquants.com/v1/token/auth_user に対してPOSTリクエストを行い、
JSON形式で mailaddress と password を送信してください（小文字で）。  
→ 取得できる "refreshToken" を変数に保存してください。

【2】次に、そのrefreshTokenを使ってIDトークンを取得します。  
このAPIでは、refreshTokenは**クエリパラメータとしてURLに含めて**送信します。  
以下がJ-Quants公式ガイドに載っているサンプルコードです：

```python
import requests
import json

REFRESH_TOKEN = "YOUR refreshtokenID"
r_post = requests.post(f"https://api.jquants.com/v1/token/auth_refresh?refreshtoken={REFRESH_TOKEN}")
r_post.json()

2023年12月29日の株価データを取得してCSVに保存するPythonコードを記述し実行してください。
get_daily_quotes.pyとしてください。
株価データ取得には株価四本値(/prices/daily_quotes)を利用してください。
@https://jpx.gitbook.io/j-quants-ja/api-reference/daily_quotes

先ほどのget_daily_quotes.pyを、2023年12月1日から2023年12月31日までの株価データを取得して保存するコードに書き換えてください。
取得したデータは、stocks.csvというファイルにまとめて保存してください。
銘柄コードを指定せず、日付だけを指定すると全銘柄取得できます。

2023年12月のすべての日の財務情報データを、銘柄を指定せず取得するPythonコードを記述し実行してください。
get_statements.pyとしてください。
取得したデータは、statements.csvにまとめて保存してください。
財務情報(/fins/statements)エンドポイント
@https://jpx.gitbook.io/j-quants-ja/api-reference/statements

2023年12月1日から2023年12月31日の上場銘柄一覧(/listed/info)を取得するPythonコードを記述し実行してください。
get_listed_info.pyとしてください。
listed_info.csvに保存してください。
@https://jpx.gitbook.io/j-quants-ja/api-reference/listed_info

statements.csvの各行にMarketCodeNameを追記したいです。
各行からDateとCodeを参照し、listed_info.csvからDateとCodeが同じもの探し、statements.csvの各行にMarketCodeNameを追記してください。

statements.csvの各行に対してROE＝Profit÷Equityを算出して追記してください。

先ほど作成したstatements_with_roe.csvとstocks.csvにある情報を用いて、
それぞれの日のPBRとPERを算出してstatements_with_roe.csvに追記してください。

{
  "start_date": "2025-02-03",
  "end_date": "2025-02-04"
}

これまで作った以下のpythonコードに対して、日付を期間指定している部分を、date_range.jsonを参照するようにコードを修正してください。
get_daily_quotes.py
get_listed_info.py
get_statements.py

これまで作った以下のpythonコードに対して、実行して取得したデータをすでに存在するファイルに追加するよう修正してください。すでに存在するデータは削除しないようお願いします。
get_daily_quotes.py
get_listed_info.py
get_statements.py