Fixed Income Sovereign

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

作者 JoelLewis5c498eacf7057e31238c4c5a8012a1afe9ec7c8a無授權條款收錄於 2026年10月9日更新於 2026年10月9日

Analyze US Treasury securities and interest rate risk: bond pricing, yield curve construction, duration, convexity, TIPS, and forward/spot rate analysis. Use when the user asks about Treasury bonds, yield curve construction, interest rate risk, duration, convexity, TIPS, or breakeven inflation rates. Also trigger when users mention 'T-bills', 'T-notes', 'bond pricing', 'yield to maturity', 'inverted yield curve', 'forward rates', 'spot rates', 'DV01', 'real yields', or ask how bonds react to interest rate changes.

AI 產生的概覽

分析美國公債與利率風險:債券定價、殖利率曲線、存續期間、凸性、TIPS 及遠期利率。

功能
提供美國公債分析的參考公式與計算範例,涵蓋債券定價、到期殖利率、即期/平價/遠期曲線自舉、麥考利存續期間與修正存續期間、DV01、凸性、關鍵利率存續期間,以及 TIPS 損益兩平通膨。附帶一支 Python 指令碼,可執行這些計算的示範,並能將輸出與範例結果進行比對驗證。著重於定量固定收益分析,而非產出檔案。
適用情境
當使用者詢問美國公債、短期國庫券、中期國庫券、債券定價、到期殖利率、殖利率曲線建構、殖利率曲線倒掛、遠期或即期利率、存續期間、凸性、DV01、實質殖利率或損益兩平通膨時使用。也適合用來估算債券價格對利率變動的反應。
執行需求
需要 Python 執行環境;指令碼使用 PEP 723 內嵌相依套件,可用 uv 執行,或在安裝 numpy 與 scipy 後以 python3 執行。附帶可執行指令碼。未說明需要憑證或網路存取。

Fixed Income — Sovereign

Scope: US Treasuries and rates analytics. Sovereign credit risk — emerging market debt, default analysis, country risk spreads — is out of scope for this skill.

Core Concepts

Bond Pricing

The price of a bond is the present value of its future cash flows:

P = sum(t=1 to n) [C / (1+y)^t] + F / (1+y)^n

where C = coupon payment per period, y = yield to maturity per period, F = face value, n = total number of periods. For semi-annual bonds, divide the annual coupon by 2 and the annual yield by 2, and double the number of years to get n.

Yield to Maturity (YTM)

The discount rate y that solves the bond pricing equation — the single rate that equates the bond's market price to the present value of all future cash flows. Assumes reinvestment of coupons at the YTM rate. It is the standard yield measure for bonds.

Current Yield

Current Yield = Annual Coupon / Price. A simple income measure that ignores capital gains/losses and the time value of money.

Yield Curve: Spot Rates, Forward Rates, Par Curve

The spot curve gives zero-coupon yields for each maturity. The par curve gives coupon rates at which bonds would price at par. Forward rates are implied future rates derived from spot rates. The three curves contain equivalent information and can be derived from one another.

Bootstrapping the Spot Curve

Extract spot (zero-coupon) rates from par yields by starting at the shortest maturity and working outward. Each step uses previously derived spot rates to solve for the next spot rate.

Forward Rate

The implied rate between two future dates derived from spot rates:

f(t1,t2) = [(1+s_t2)^t2 / (1+s_t1)^t1]^(1/(t2-t1)) - 1

where s_t1 and s_t2 are spot rates for maturities t1 and t2.

Duration (Macaulay)

The weighted average time to receive cash flows, where weights are the present value of each cash flow as a proportion of the bond's price:

D_mac = (1/P) × sum(t × CF_t / (1+y)^t)

Measured in years. Longer maturity, lower coupon, and lower yield all increase duration.

Modified Duration

D_mod = D_mac / (1 + y/m)

where m = number of coupon periods per year. Gives the approximate percentage price change for a 1 percentage point change in yield: dP/P ≈ -D_mod × dy.

Dollar Duration (DV01)

The dollar change in price for a 1 basis point change in yield:

DV01 ≈ -D_mod × P × 0.0001

Used for hedging — match DV01 exposures to immunize a portfolio against parallel rate shifts.

Convexity

Measures the curvature of the price-yield relationship (second derivative):

C = (1/P) × sum(t(t+1) × CF_t / (1+y)^(t+2))

For option-free bonds, convexity is always positive — duration alone overstates losses and understates gains.

Price Change Approximation

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

The convexity term is a correction that becomes important for large yield changes.

TIPS (Treasury Inflation-Protected Securities)

Principal adjusts with CPI. The coupon rate is fixed but applied to the inflation-adjusted principal. Real yield = TIPS yield. Breakeven inflation = nominal Treasury yield - TIPS real yield. TIPS have a deflation floor that protects par value at maturity.

Key Rate Duration

Sensitivity to specific points on the yield curve (e.g., 2yr, 5yr, 10yr, 30yr). Allows analysis of non-parallel yield curve shifts such as steepening, flattening, or butterfly moves. Sum of key rate durations equals effective duration.

Key Formulas

FormulaExpressionUse Case
Bond PriceP = sum C/(1+y)^t + F/(1+y)^nPrice from yield
Current YieldAnnual Coupon / PriceSimple income measure
Forward Ratef(t1,t2) = [(1+s_t2)^t2 / (1+s_t1)^t1]^(1/(t2-t1)) - 1Implied future rate
Macaulay Duration(1/P) × sum(t × CF_t / (1+y)^t)Weighted avg time to cash flows
Modified DurationD_mac / (1 + y/m)% price sensitivity to yield
DV01D_mod × P × 0.0001Dollar price change per 1bp
Convexity(1/P) × sum(t(t+1) × CF_t / (1+y)^(t+2))Curvature of price-yield curve
Price ChangeΔP/P ≈ -D_mod×Δy + 0.5×Convexity×(Δy)²Estimate price impact of rate move

Worked Examples

Example 1: Price a 5-Year 4% Semi-Annual Coupon Bond at 5% YTM

Given: Face = $1,000, coupon = 4% (semi-annual), YTM = 5%, maturity = 5 years Calculate: Bond price Solution: Semi-annual coupon = $1,000 × 4% / 2 = $20 Semi-annual yield = 5% / 2 = 2.5% Number of periods = 5 × 2 = 10 P = $20 × [(1 - (1.025)^(-10)) / 0.025] + $1,000 / (1.025)^10 P = $20 × 8.7521 + $1,000 × 0.7812 P = $175.04 + $781.20 = $956.24

The bond trades at a discount ($956.24 < $1,000) because the coupon rate (4%) is below the market yield (5%).

Example 2: Modified Duration and Price Change Estimate

Given: A bond with Macaulay duration = 4.5 years, YTM = 5% (semi-annual), price = $956.24, convexity = 22.5 Calculate: Estimated price change for a +50bp rate increase Solution: D_mod = 4.5 / (1 + 0.05/2) = 4.5 / 1.025 = 4.39 years ΔP/P ≈ -4.39 × 0.005 + 0.5 × 22.5 × (0.005)² ΔP/P ≈ -0.02195 + 0.000281 = -0.02167 = -2.167% ΔP ≈ -2.167% × $956.24 = -$20.72 New price ≈ $956.24 - $20.72 = $935.52

Duration alone would estimate -2.195%; the convexity correction reduces the estimated loss by about 3bp.

Common Pitfalls

  • Confusing Macaulay and modified duration — Macaulay is in years, modified gives price sensitivity
  • Ignoring convexity for large yield changes — duration alone overstates losses and understates gains
  • Day count conventions (30/360 vs actual/actual) — Treasuries use actual/actual, corporates use 30/360
  • Clean price vs dirty price (accrued interest) — quoted prices exclude accrued interest, but settlement requires paying it

Cross-References

  • time-value-of-money (core plugin): discounting and present value fundamentals
  • fixed-income-corporate (wealth-management plugin): credit spreads over the sovereign curve
  • fixed-income-municipal (wealth-management plugin): muni-to-Treasury yield ratios
  • asset-allocation (wealth-management plugin): bonds as an asset class in portfolio construction

Running the Script

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

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_sovereign.py.

來源與署名

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

授權條款: 無授權條款

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

檢舉或申請下架