Python API の使い方
kabukit は、複数のソースからデータを取得するための、Python API を提供します。
現在サポートしているソースは以下の通りです。
ノートブックでの非同期処理
kabukit は、httpx を使った非同期設計になっており、Jupyter や marimo のような非同期処理を直接扱えるノートブック環境で快適に利用できます。
2 つのインターフェース
Python API は、モジュール関数と Client クラスの 2 のインターフェースを提供します。
モジュールレベル関数
httpx クライアントを意識することなく、手軽にデータを取得にするのに適しています。また、銘柄コードや日付を複数指定すると、関数内部で非同期処理を並列実行するため、効率的に情報を取得できます。
以下の例では、J-Quants API から株価情報を取得します。get_prices 関数に銘柄コードを与えます。
from kabukit import get_prices
df = await get_prices("7203")
df.select("Date", "Code", "Open", "High", "Low", "Close", "Volume")
shape: (2_444, 7)
| Date | Code | Open | High | Low | Close | Volume |
|---|---|---|---|---|---|---|
| date | str | f64 | f64 | f64 | f64 | f64 |
| 2015-12-14 | "72030" | 1500.0 | 1503.4 | 1483.2 | 1492.6 | 6.2981e7 |
| 2015-12-15 | "72030" | 1491.8 | 1493.8 | 1464.8 | 1464.8 | 5.25115e7 |
| 2015-12-16 | "72030" | 1494.4 | 1527.2 | 1490.8 | 1522.4 | 5.80235e7 |
| 2015-12-17 | "72030" | 1543.6 | 1555.4 | 1536.4 | 1540.6 | 6.1149e7 |
| 2015-12-18 | "72030" | 1536.0 | 1570.0 | 1523.6 | 1531.6 | 8.55545e7 |
| … | … | … | … | … | … | … |
| 2025-12-08 | "72030" | 3050.0 | 3060.0 | 3021.0 | 3060.0 | 1.55966e7 |
| 2025-12-09 | "72030" | 3076.0 | 3083.0 | 3044.0 | 3066.0 | 1.51634e7 |
| 2025-12-10 | "72030" | 3089.0 | 3137.0 | 3076.0 | 3116.0 | 2.03277e7 |
| 2025-12-11 | "72030" | 3148.0 | 3160.0 | 3099.0 | 3110.0 | 1.42422e7 |
| 2025-12-12 | "72030" | 3191.0 | 3272.0 | 3168.0 | 3260.0 | 4.26642e7 |
get_prices 関数に銘柄コードのリストを与えると、非同期処理を並列実行して、複数銘柄の株価情報を一度に取得します。
import polars as pl
from polars import col as c
# 複数銘柄の株価情報を取得
df = await get_prices(["7203", "9984", "8306", "6758"])
# 銘柄コードごとに集計
df.group_by(c.Code).agg(
pl.len().alias("日数"),
c.Low.min().alias("最安値"),
c.High.max().alias("最高値"),
c.Close.last().alias("直近終値"),
c.TurnoverValue.mean().alias("1日あたり平均取引代金"),
)
shape: (4, 6)
| Code | 日数 | 最安値 | 最高値 | 直近終値 | 1日あたり平均取引代金 |
|---|---|---|---|---|---|
| str | u32 | f64 | f64 | f64 | f64 |
| "67580" | 2444 | 439.8 | 4776.0 | 4181.0 | 4.2109e10 |
| "72030" | 2444 | 983.4 | 3891.0 | 3260.0 | 5.7093e10 |
| "83060" | 2444 | 380.0 | 2543.5 | 2499.0 | 5.6234e10 |
| "99840" | 2444 | 2066.5 | 27695.0 | 17895.0 | 9.0608e10 |
Client クラス
より詳細な制御（例: タイムアウト設定、リトライポリシーの変更など）
が必要な場合に直接利用します。特に、各クラスの client 属性は httpx.AsyncClient のインスタンスであるため、httpx が提供する豊富なメソッドや設定に直接アクセスすることが可能です。
たとえば、J-Quants API に対応した JQuantsClient は以下のように使います。
from kabukit import JQuantsClient
client = JQuantsClient()
# ここで API を呼び出す
await client.aclose() # 最後に手動でセッションを閉じる
async with 構文を使うことで、セッションを安全に管理できます。
async with JQuantsClient() as client:
# このブロック内で API を呼び出す
pass
# 自動でセッションが閉じられる