基于QuantLib的Python浮动现金流生成结果与市场工具不符求排查

核心问题点及修正方案 #

1. 曲线插值与Fixing添加逻辑错误 #

• 手动通过np.interp对零利率做线性插值并添加Fixing，不符合浮动利率产品定价逻辑：未来重置日期的利率应通过收益率曲线计算远期利率，而非手动插值零利率。且QuantLib的ZeroCurve默认对贴现因子做线性插值，和直接插值零利率的方式可能与第三方系统不一致。
• 修正：仅对已过期的重置日期添加Fixing，未来的利率由LIBOR索引自动从曲线计算远期，删除手动插值添加Fixing的代码块。

2. 日历设置错误 #

• 标的为USD LIBOR，却使用UnitedKingdom()日历，会导致日期调整（节假日处理）与第三方系统（如Bloomberg）不一致，进而影响计息天数和现金流日期。
• 修正：替换为UnitedStates()（纽约联邦储备银行日历）。

3. 结算天数与产品条款不匹配 #

• FloatingRateBond的settlementDays设为0，而USD债券通常采用T+2结算，这会影响定价时的贴现起点计算。
• 修正：将settlementDays改为2。

4. 零曲线复利类型可能不匹配 #

• QuantLib的ZeroCurve默认接受连续复利零利率，若Excel中的曲线是单利（如货币市场型零利率），需明确指定复利方式，否则会导致利率计算偏差。
• 示例修正（若为单利）：

  zero_curve = ZeroCurve(curve_dates, curve_rates, Actual360(), calendar, SimpleCompounding, Annual)
  

修正后的完整代码 #

from QuantLib import *
import pandas as pd

# 参数设置
start_date = Date(27, 2, 2015)
end_date = Date(27, 2, 2045)
face_value = 1900000
frequency = Semiannual
spread_in_bp = -19.264
spread = spread_in_bp / 10000

# 修正日历为USD对应的美国日历
calendar = UnitedStates()
schedule = Schedule(start_date, end_date, Period(frequency), calendar,
                    Following, Following, DateGeneration.Forward, False)

# 读取零曲线数据
curve = pd.read_excel('USD_LIBOR_ZC-Curve.xlsx')
curve_dates = [Date.from_date(pd.to_datetime(d)) for d in curve['Date']]
curve_rates = [r/100 for r in curve['Rate']]

# 构建零曲线（根据实际复利类型调整参数）
zero_curve = ZeroCurve(curve_dates, curve_rates, Actual360(), calendar)
zero_curve_handle = YieldTermStructureHandle(zero_curve)

# 初始化USD 6个月LIBOR索引
reference_rate = USDLibor(Period(6, Months), zero_curve_handle)

# 仅添加已过期的Fixing（示例，根据实际情况调整）
# reference_rate.addFixing(Date(27, 8, 2014), 0.015)

# 初始化浮动利率债券，修正结算天数
bond = FloatingRateBond(settlementDays=2, faceAmount=face_value, schedule=schedule,
                        index=reference_rate, paymentDayCounter=Actual360(), spread=spread)

# 设置定价引擎
bond_engine = DiscountingBondEngine(zero_curve_handle)
bond.setPricingEngine(bond_engine)

# 输出现金流与净价
for i, cashflow in enumerate(bond.cashflows()):
    print(f"现金流 {i + 1}: {cashflow.amount()} 日期: {cashflow.date()}")

print(f"债券净价: {bond.cleanPrice()}")

验证建议 #

1. 核对现金流日期：确认修正日历后，所有现金流日期与第三方系统一致。
2. 核对单期现金流：选取某一期未来现金流，手动计算LIBOR远期利率+spread，乘以面值和计息天数，与QuantLib输出对比。
3. 核对债券净价：用第三方系统的现金流和贴现曲线计算现值，与QuantLib结果交叉验证。

内容的提问来源于stack exchange，提问作者Gauthier THOMAS