fixed-income

債券

ステータス：スタブ — このスキルでは、基本的な債券計算ツールと、予定されている機能の概要を提供します。完全な実装は、コミュニティからの貢献をお待ちしています。

債券分析は、従来の債券数学とDeFiの貸付金利モデリングを結び付けます。キャッシュフローの現在価値、イールドカーブ、デュレーション、コンベクシティといった債券価格の基本概念は、暗号資産に対して預け手が変動金利または固定金利を得るDeFi貸付プロトコルの分析にそのまま活用できます。

Solanaでは、Marginfi、Kamino、Solendなどの貸付プロトコルが、変動金利での貸付・借入を提供しています。期間構造と金利の変動を理解することで、イールドファーミング戦略を最適化し、複数のプロトコル間で機会を比較しやすくなります。

このスキルは情報提供および分析のみを目的としています。金融上の助言や取引の推奨は提供しません。

---

現在の機能

このスタブには、価格、最終利回り、デュレーション、コンベクシティを計算できる実用的な債券計算ツールが含まれています。実装については、scripts/bond_calculator.pyを参照してください。

def bond_price(
    face: float, coupon_rate: float, ytm: float, periods: int, freq: int = 2
) -> float:
    """Calculate bond price as present value of all cash flows.

    Args:
        face: Face (par) value of the bond.
        coupon_rate: Annual coupon rate (decimal, e.g., 0.05 for 5%).
        ytm: Yield to maturity (annual, decimal).
        periods: Number of coupon periods remaining.
        freq: Coupon frequency per year (2 = semi-annual).

    Returns:
        Bond price (dirty price).
    """
    coupon = face * coupon_rate / freq
    y = ytm / freq
    pv_coupons = sum(coupon / (1 + y) ** t for t in range(1, periods + 1))
    pv_face = face / (1 + y) ** periods
    return pv_coupons + pv_face

デモを実行します。

python scripts/bond_calculator.py --demo

---

予定されている機能

完全に実装されると、このスキルでは以下を扱います。

債券価格の計算

概念	説明
クリーン価格／ダーティ価格	経過利息を除く／含む価格
経過利息	前回の利払日以降に発生した利息
日数計算規則	30/360、ACT/360、ACT/365、ACT/ACT
ゼロクーポン債	定期的なクーポンのない割引債

利回り指標

利回り指標	用途
最終利回り（YTM）	満期まで保有した場合の総収益
直接利回り	年間クーポン／価格
繰上償還利回り	最初の繰上償還日に償還された場合の収益
ベンチマーク金利スプレッド	無リスク金利に対する信用リスクプレミアム

デュレーションとコンベクシティ

指標	測定対象
マコーレー・デュレーション	キャッシュフローまでの加重平均期間
修正デュレーション	利回りの変化に対する価格感応度
実効デュレーション	オプションを内包する債券のデュレーション
コンベクシティ	価格感応度の二次効果
ドル・デュレーション（DV01）	利回りが1bp変化した場合の金額の変化

イールドカーブの構築

手法	説明
ブートストラップ法	パー債価格からスポットレートを算出
Nelson-Siegel	水準、傾き、曲率を用いたパラメトリックモデル
Nelson-Siegel-Svensson	曲率項を追加した拡張モデル
3次スプライン	ノンパラメトリック補間

DeFi貸付金利の分析

プロトコル	チェーン	種類
Marginfi	Solana	変動金利
Kamino	Solana	変動金利
Solend	Solana	変動金利
Aave	Ethereum/Multi	変動金利＋安定金利
Compound	Ethereum	変動金利

予定されているDeFi機能：

• 貸付金利の時系列分析
• プロトコル間の供給APY／借入APYの比較
• 利用率が貸付金利に与える影響
• 固定金利と変動金利の比較（固定金利プロトコルが利用可能になった場合）
• 金利裁定機会の検出

---

前提条件

# For full implementation
uv pip install numpy scipy

# For visualization
uv pip install matplotlib

付属のscripts/bond_calculator.pyはPython標準ライブラリのみを使用するため、依存関係なしで実行できます。

---

使用例

イールドファーミングの比較

債券分析を活用し、プロトコル間でDeFi貸付金利を比較します。変動金利を年率換算し、複利頻度を考慮した実効利回りを算出して、資本効率が最も高い機会を特定します。

貸付金利の分析

金利の変動を把握するため、貸付金利を時系列で追跡します。利用率が低い場合の金利低下と、利用率が高い場合の金利上昇が起きる期間を特定し、最適なタイミングで預け入れます。

金利裁定

あるプロトコルで低い金利で借り入れ、別のプロトコルでより高い金利で貸し付けます。デュレーションとコンベクシティの概念は、裁定ポジションの保有期間中に起こる金利変動のリスク評価に役立ちます。

リスク評価

デュレーションを使って、金利変動に伴う貸付ポジションの価値の変化を推定します。デュレーションが高いほど、金利変動に対する感応度が高くなります。

---

クイックリファレンス：債券価格の計算式

債券価格（キャッシュフローの現在価値）：

P = Σ [C / (1+y)^t] + F / (1+y)^n
    t=1..n

Where:
  C = periodic coupon payment = Face * coupon_rate / frequency
  y = periodic yield = YTM / frequency
  F = face value
  n = total number of periods

マコーレー・デュレーション：

D_mac = (1/P) * Σ [t * C / (1+y)^t] + (n * F) / ((1+y)^n * P)

修正デュレーション：

D_mod = D_mac / (1 + y)

コンベクシティ：

Convexity = (1/P) * Σ [t*(t+1) * C / (1+y)^(t+2)] + [n*(n+1)*F] / [(1+y)^(n+2) * P]

価格変動の近似：

ΔP/P ≈ -D_mod * Δy + 0.5 * Convexity * (Δy)²

---

ファイル

ファイル	説明
references/planned_features.md	予定されている機能、債券の計算式、DeFi プロトコル、実装の優先順位
scripts/bond_calculator.py	債券価格、最終利回り、デュレーション、コンベクシティの計算ツール

---

貢献

このスキルは、完全な実装を待つスタブです。貢献するには、次の作業を行ってください。

1. 市場データからイールドカーブをブートストラップする機能を実装する
2. ネルソン・シーゲル・イールドカーブ・フィッティングを追加する
3. DeFi の貸付金利データ取得機能（Marginfi、Kamino API）を構築する
4. 経過利息を正確に計算するため、日数計算規則のサポートを追加する
5. プロトコル間の金利比較ダッシュボードを作成する

機能の全一覧と実装の優先順位については、references/planned_features.md を参照してください。

---

このスキルは、情報提供のみを目的とした分析ツールと数学モデルを提供します。金融アドバイスを構成するものではありません。債券投資および DeFi の貸付には、損失が生じるリスクがあります。