認証(API キー)

1
import os
2
import requests
3

4
BASE_URL = "https://api.jquants.com/v2"
5

6
# API キーは環境変数経由で受け取る(コードにハードコードしない)
7
api_key = os.environ["JQUANTS_API_KEY"]
8
headers = {"x-api-key": api_key}
9

10
# 動作確認: 上場銘柄一覧を取得
11
response = requests.get(f"{BASE_URL}/equities/master", headers=headers, timeout=30)
12
response.raise_for_status()
13
data = response.json()
14
print(f"取得件数: {len(data.get('data', []))}")

1
import os
2
import requests
3

4

5
class JQuantsClient:
6
    """API キーを x-api-key ヘッダに付けて GET するだけの最小クライアント。"""
7

8
    BASE_URL = "https://api.jquants.com/v2"
9

10
    def __init__(self, api_key: str):
11
        self._headers = {"x-api-key": api_key}
12

13
    def get(self, path: str, **params) -> dict:
14
        response = requests.get(
15
            f"{self.BASE_URL}{path}",
16
            headers=self._headers,
17
            params=params or None,
18
            timeout=30,
19
        )
20
        response.raise_for_status()
21
        return response.json()
22

23

24
# 環境変数から API キーを読む(値はハードコードしない)
25
client = JQuantsClient(api_key=os.environ["JQUANTS_API_KEY"])
26

27
# 上場銘柄一覧の取得例
28
listed = client.get("/equities/master")
29
print(f"取得件数: {len(listed.get('data', []))}")

1
def get_all(client: JQuantsClient, path: str, **params) -> list[dict]:
2
    """pagination_key をたどって全件取得する。"""
3
    rows: list[dict] = []
4
    key = None
5
    while True:
6
        page = client.get(path, **params, **({"pagination_key": key} if key else {}))
7
        rows.extend(page.get("data", []))
8
        key = page.get("pagination_key")
9
        if not key:
10
            break
11
    return rows

J-Quants API V2 のクライアントクラス JQuantsClient を Python で書いてください。

要件:
- API キーは環境変数 JQUANTS_API_KEY から読む(ハードコードしない)
- 認証は x-api-key ヘッダに API キーを乗せる(トークン交換は不要)
- ベース URL は https://api.jquants.com/v2
- get(path, **params) メソッドを持つ
- pagination_key があれば自動でたどって全件返すヘルパも用意
- HTTP エラーは raise_for_status() で例外化
- Python 3.11 以上、requests ライブラリ前提
- docstring を日本語で書く