使用QuantLib构建Vanilla Swap定价器遇MakeVanillaSwap参数错误求助

错误原因 #

你遇到的TypeError是因为QuantLib Python绑定的MakeVanillaSwap构造函数中没有名为Nominal的参数——正确的参数名是小写的nominal。QuantLib的Python接口参数名严格区分大小写，你可能混淆了C示例中的命名习惯（部分C接口参数大小写规则与Python绑定不同）。

两种正确设置名义本金的方式 #

方式1：直接通过MakeVanillaSwap的nominal参数设置

这是最简洁的方式，直接在builder中传入小写的nominal参数即可：

import QuantLib as ql

# 初始化基础组件示例
settings = ql.Settings.instance()
evaluation_date = ql.Date(15, ql.July, 2024)
settings.setEvaluationDate(evaluation_date)

euribor6M = ql.Euribor6M()
calendar = ql.TARGET()

# 使用MakeVanillaSwap创建Swap，指定名义本金
swap = ql.MakeVanillaSwap(
    tenors=ql.Period(5, ql.Years),
    index=euribor6M,
    fixedRate=0.025,
    nominal=1000000.0,  # 正确的小写参数名
    pricingDate=evaluation_date,
    fixedLegTenor=ql.Period(1, ql.Years),
    floatingLegTenor=ql.Period(6, ql.Months)
)

# 验证名义本金是否生效
print(f"Swap名义本金: {swap.nominal()}")

方式2：手动构造腿组件后创建Swap对象

如果需要对固定腿/浮动腿做更精细化配置（比如自定义付息频率、计息天数规则），可以手动构造腿再创建VanillaSwap对象，此时名义本金直接传入腿的构造参数：

import QuantLib as ql

settings = ql.Settings.instance()
evaluation_date = ql.Date(15, ql.July, 2024)
settings.setEvaluationDate(evaluation_date)

euribor6M = ql.Euribor6M()
calendar = ql.TARGET()
nominal = 1000000.0
fixed_rate = 0.025

# 计算起息日和到期日
effective_date = calendar.advance(evaluation_date, 2, ql.Days)
maturity_date = calendar.advance(effective_date, 5, ql.Years)

# 构造固定腿
fixed_schedule = ql.Schedule(
    effective_date,
    maturity_date,
    ql.Period(1, ql.Years),
    calendar,
    ql.ModifiedFollowing,
    ql.ModifiedFollowing,
    ql.DateGeneration.Backward,
    False
)
fixed_leg = ql.FixedRateLeg(fixed_schedule, calendar, [nominal], [fixed_rate], ql.Actual360())

# 构造浮动腿
floating_schedule = ql.Schedule(
    effective_date,
    maturity_date,
    ql.Period(6, ql.Months),
    calendar,
    ql.ModifiedFollowing,
    ql.ModifiedFollowing,
    ql.DateGeneration.Backward,
    False
)
floating_leg = ql.IborLeg([nominal], floating_schedule, euribor6M)

# 创建VanillaSwap对象
swap = ql.VanillaSwap(ql.VanillaSwap.Payer, nominal, fixed_leg, floating_leg)

# 验证名义本金
print(f"Swap名义本金: {swap.nominal()}")

额外提示 #

• 使用MakeVanillaSwap时，所有参数名需严格匹配QuantLib Python绑定的定义，可通过help(ql.MakeVanillaSwap)查看完整参数列表。
• 设置完成后，可通过swap.nominal()方法确认名义本金是否正确赋值，避免因参数名错误导致默认值1生效。

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