Fixed Income Structured

JoelLewis/finance_skills/plugins/wealth-management/skills/fixed-income-structured

作者 JoelLewis5c498eacf7057e31238c4c5a8012a1afe9ec7c8a無授權條款206 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫2 個月前更新

Analyze structured fixed income products including mortgage-backed securities, asset-backed securities, and CLOs. Use when the user asks about MBS, ABS, CLOs, CDOs, prepayment risk, tranching, or waterfall structures. Also trigger when users mention 'mortgage bonds', 'agency MBS', 'pass-through securities', 'PSA prepayment speed', 'negative convexity', 'extension risk', 'contraction risk', 'CMO tranches', 'securitization', or ask how structured products redistribute credit and prepayment risk.

AI 產生的概覽

說明結構型固定收益產品——MBS、ABS 與 CLO——涵蓋提前還款模型、分層、現金流瀑布與估值。

功能
此技能提供結構型固定收益的參考資料與計算範例:MBS 過手證券、提前還款風險、PSA 模型、CPR 與 SMM 換算、加權平均期限、CMO 分層、ABS 類型、CLO 次順位化與現金流瀑布機制,以及以 OAS 為基礎的估值。內容包含關鍵公式與兩個範例(PSA 換算為 CPR、CLO 分層次順位比例)。隨附的 Python 指令碼可執行這些計算的示範,並可將輸出與範例結果進行驗證。
適用情境
當使用者詢問 MBS、ABS、CLO、CDO、提前還款風險、展延風險或收縮風險、分層、現金流瀑布結構、PSA 提前還款速度、負凸性,或結構型產品如何重新分配信用與提前還款風險時使用。
執行需求
需要 Python 執行環境;指令碼使用 PEP 723 內嵌相依套件,可用 uv 執行,或在安裝 numpy 後以 python3 執行。未說明需要憑證或網路存取。

Fixed Income — Structured Products

Core Concepts

MBS Pass-Throughs

A pool of mortgages whose cash flows (principal, interest, prepayments) are passed through to investors on a pro-rata basis. Agency MBS (Ginnie Mae, Fannie Mae, Freddie Mac) carry a government or GSE guarantee against credit losses, isolating prepayment risk as the primary concern. Non-agency MBS lack this guarantee and carry both credit and prepayment risk.

Prepayment Risk

Borrowers can refinance when rates drop, returning principal early. This creates negative convexity — when rates fall, MBS prices rise less than comparable Treasuries because prepayments accelerate and shorten the bond's effective life. Prepayment risk has two faces:

Contraction risk: Rates fall, prepayments accelerate, duration shortens. Investors receive principal back when reinvestment rates are lower.

Extension risk: Rates rise, prepayments slow, duration extends. Investors are locked into below-market coupons for longer than expected.

PSA Prepayment Model

The Public Securities Association model provides a benchmark prepayment speed:

100% PSA = ramp from 0% CPR to 6% CPR linearly over the first 30 months, then constant at 6% CPR thereafter.

At 150% PSA, all speeds are multiplied by 1.5 (e.g., the plateau is 9% CPR). At 200% PSA, the plateau is 12% CPR.

CPR and SMM

CPR (Conditional Prepayment Rate): Annualized prepayment rate as a percentage of the remaining pool balance.

SMM (Single Monthly Mortality): Monthly prepayment rate.

SMM = 1 - (1 - CPR)^(1/12)

Weighted Average Life (WAL)

WAL = sum(t × Principal_t) / Total Principal. Unlike maturity, WAL accounts for the timing of principal repayments (both scheduled and prepayments). WAL is shorter than maturity for amortizing securities and is sensitive to prepayment assumptions.

CMO Tranches

Collateralized Mortgage Obligations redistribute MBS cash flows into tranches with different risk profiles:

Sequential pay: Principal flows to the first tranche until retired, then the second, etc. Earlier tranches have shorter duration, later tranches have longer duration.

PAC (Planned Amortization Class): Provides a predictable principal schedule within a band of prepayment speeds (e.g., 100-250% PSA). Stability comes at the expense of companion/support tranches that absorb prepayment variability.

Support/Companion tranches: Absorb excess or deficit prepayments to protect PAC tranches. Highly volatile duration.

ABS (Asset-Backed Securities)

Securitized pools of non-mortgage assets:

  • Auto loans: amortizing, relatively predictable cash flows
  • Credit cards: revolving, with a revolving period followed by a controlled amortization period
  • Student loans: longer duration, income-driven repayment creates uncertainty

CLOs (Collateralized Loan Obligations)

Tranched portfolios of leveraged loans (typically 150-250 loans). AAA tranches benefit from significant subordination (30-40% of the structure below them). Equity tranches receive residual cash flows after all senior tranches are paid. Waterfall tests (overcollateralization and interest coverage tests) redirect cash flows to protect senior tranches when the portfolio deteriorates.

Waterfall Structure

Cash flows are distributed by seniority: senior tranches receive interest and principal first, mezzanine next, equity last. If pool performance deteriorates, lower tranches absorb losses first (subordination protects senior tranches). Overcollateralization (OC) tests and interest coverage (IC) tests trigger cash flow diversions when breached.

OAS for Structured Products

OAS is essential for MBS because it captures prepayment optionality. Standard modified duration is inappropriate for MBS — use effective duration (computed via OAS models) or empirical duration. Monte Carlo simulation of interest rate paths and corresponding prepayment responses is the standard valuation approach for MBS.

Key Formulas

FormulaExpressionUse Case
SMM from CPRSMM = 1 - (1-CPR)^(1/12)Monthly prepayment rate
CPR from SMMCPR = 1 - (1-SMM)^12Annualize monthly rate
PSA CPR (month t, t<=30)CPR = 6% × (t/30) × PSA/100Ramping prepayment model
PSA CPR (month t, t>30)CPR = 6% × PSA/100Plateau prepayment model
WALsum(t × Principal_t) / Total PrincipalAverage principal timing
OAS PriceP = E[sum CF_t(path) / (1+s_t+OAS)^t]MBS valuation

Worked Examples

Example 1: Convert PSA to CPR

Given: 150% PSA, month 20 Calculate: CPR and SMM in month 20 Solution: At 100% PSA, month 20: CPR = 6% × (20/30) = 4.0% At 150% PSA: CPR = 4.0% × 1.5 = 6.0% SMM = 1 - (1 - 0.06)^(1/12) = 1 - (0.94)^(0.0833) = 1 - 0.99486 = 0.00514 = 0.514%

In month 20 at 150% PSA, approximately 0.514% of the remaining pool balance prepays each month, equivalent to 6.0% annualized.

Example 2: CLO Tranche Analysis

Given: A CLO with $500M total assets. AAA tranche = $325M (65%), AA = $50M (10%), A = $37.5M (7.5%), BBB = $25M (5%), BB = $12.5M (2.5%), Equity = $50M (10%). Calculate: Subordination level for the AAA tranche Solution: Subordination below AAA = AA + A + BBB + BB + Equity = $50M + $37.5M + $25M + $12.5M + $50M = $175M Subordination % = $175M / $500M = 35%

The AAA tranche has 35% subordination — the portfolio would need to lose more than 35% of its value before AAA investors suffer any principal loss. This substantial credit enhancement is why CLO AAA tranches have historically experienced zero defaults.

Common Pitfalls

  • Ignoring negative convexity of MBS — MBS underperform Treasuries in both rallies (contraction) and selloffs (extension)
  • Using modified duration for MBS — use effective/OAS duration instead, as cash flows change with rates
  • Assuming constant prepayment speeds — speeds vary with rates, seasonality, borrower demographics, and housing turnover
  • Not understanding that waterfall mechanics affect tranche risk differently — senior and subordinate tranches of the same deal have very different risk profiles

Cross-References

  • fixed-income-sovereign (wealth-management plugin): the Treasury curve and duration/convexity concepts
  • fixed-income-corporate (wealth-management plugin): credit spread concepts applied to non-agency MBS and CLOs
  • real-assets (wealth-management plugin): real estate market fundamentals underlying MBS
  • asset-allocation (wealth-management plugin): structured products in multi-asset portfolios

Running the Script

bash
uv run scripts/fixed_income_structured.py            # run the demo (uses PEP 723 inline deps)uv run scripts/fixed_income_structured.py --verify   # check demo outputs against the worked examples (exit 1 on mismatch)python3 scripts/fixed_income_structured.py            # alternative (requires: pip install numpy)

The demo prints the calculations covered above; its values match the worked examples in this skill. Run --help for a list of the classes and functions. For programmatic use, import the module rather than running it — the demo only executes under python fixed_income_structured.py.

來源與署名

來源:JoelLewis/finance_skills位於plugins/wealth-management/skills/fixed-income-structured提交5c498ea

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架