insighta-sbi-parser 0.1.0

SBI証券の取引データをパースするPythonライブラリ

insighta-sbi-parser

SBI証券からダウンロードした取引データ（HTML/CSV）を構造化されたPythonオブジェクトに変換するライブラリです。

インストール

pip install insighta-sbi-parser

使い方

ディレクトリ一括パース

from insighta_sbi_parser import process_sbi_dir

result = process_sbi_dir("path/to/sbi_files/")

for trade in result.trades:
    print(f"{trade.dt} {trade.ticker} {trade.qty}株 @{trade.price}")

for holding in result.holdings:
    print(f"{holding.ticker} {holding.qty}株 損益:{holding.pnl}")

for deposit in result.deposits:
    print(f"{deposit.dt} {deposit.amount} {deposit.cur} ({deposit.type})")

為替レート付きパース

result = process_sbi_dir("path/to/sbi_files/", rate_file="rate.csv")

rate.csv 形式:

date,rate
2024/01/15,148.50
2024/01/16,149.20

ファイル個別パース

from insighta_sbi_parser import classify, parse_history_html, parse_yakujo_csv

# ファイル種類を自動判定
file_type = classify("some_file.csv")  # → "history_csv", "deposit_transfer", etc.

# 個別パーサー
trades, skipped = parse_history_html("order_history.html")

対応フォーマット

種類	形式	関数
注文履歴	HTML	parse_history_html()
保有銘柄一覧	HTML	parse_summary_html()
約定履歴	CSV (Shift_JIS)	parse_yakujo_csv()
国内投信取引	CSV (Shift_JIS)	parse_domestic_fund()
入出金振替	CSV (UTF-8)	parse_transfer()
外貨入出金	CSV (UTF-8)	parse_gaika_nyushukkin()
為替取引	CSV (Shift_JIS)	parse_exchange()
配当金	CSV (Shift_JIS)	parse_distribution()

データモデル

@dataclass
class Trade:
    dt: str          # ISO 8601 (JST)
    ticker: str      # ティッカーシンボル
    qty: int         # 数量 (売りはマイナス)
    acct: str        # 口座区分 ("TT"=特定, "NISA")
    price: Decimal   # 現在値
    avg: Decimal     # 平均約定単価
    cur: str         # 決済通貨
    base: str        # 基準通貨

@dataclass
class Holding:
    ticker: str
    acct: str
    qty: int
    cost: Decimal    # 取得単価
    price: Decimal   # 現在値
    pnl: Decimal     # 損益

@dataclass
class Deposit:
    dt: str
    amount: Decimal  # 金額 (出金はマイナス)
    cur: str         # 通貨
    type: str        # "budget" | "dividend"
    ticker: str      # 関連銘柄 (任意)
    rate: Decimal | None  # 為替レート (任意)

ファイルの取得方法

SBI証券のWebサイトから以下の手順でダウンロードできます:

1. 注文履歴HTML: 外国株式 → 注文照会 → ページをHTMLとして保存
2. 保有銘柄HTML: 外国株式 → 口座管理 → ページをHTMLとして保存
3. 約定履歴CSV: 外国株式 → 取引履歴 → CSVダウンロード
4. 入出金CSV: 入出金・振替 → 操作履歴 → CSVダウンロード

Contributing

git clone https://github.com/insighta-cloud/insighta-sbi-parser.git
cd insighta-sbi-parser
pip install -e ".[dev]"
pytest

License

MIT