ficc-pricing

name: ficc-pricing description: DolphinDB FICC 定价技能。用于构造 FICC Instrument、MarketData、曲线/曲面、调用专用 pricer 或 instrumentPricer，并校验债券、利率、外汇、商品期货期权、权益期权等资产定价脚本。 license: MIT metadata: author: ddb-user version: "2.1.0"

ficc_pricing

本 skill 是 DolphinDB FICC 定价的通用中文规范。它服务于三个目标：准确构造 parseInstrument 入参、准确构造 parseMktData 或 builder 入参、准确选择 pricer 并解释结果。平台 API、前端 session、REST endpoint、业务数据库名、页面状态同步等内容不属于本 skill；这些内容应放在平台集成 skill 中。

一、适用范围

使用本 skill 处理以下任务：

• 根据条款构造单只或一组 FICC instrument。
• 根据市场数据构造利率曲线、股息曲线、资产价格曲线、外汇即期、波动率曲面。
• 调用 DolphinDB 专用定价函数，例如 bondPricer、fxForwardPricer、eqEuropeanOptionPricer。
• 调用 instrumentPricer(instrument, pricingDate, marketData) 做批量或自动匹配定价。
• 校验 .dos 示例脚本、定位字段错误、补充可审计输出。

不在本 skill 中硬编码平台函数前缀、平台库表路径、HTTP 路由、会话字段、UI 状态或一次性任务说明。

二、通用工作流

1. 确认条款

先确认资产类型、交易方向、本金、币种、起息日、到期日、行权价、票息、浮动指数、曲线名称、参考日期等真实输入。缺少关键市场数据时，应说明缺口或使用明确给出的替代假设；不要凭空补曲线、票息、波动率、股息率、样本券或即期汇率。

2. 构造 Instrument

统一使用 dict(STRING, ANY)：

instDict = dict(STRING, ANY)
instDict["productType"] = "Cash"
instDict["assetType"] = "Bond"
// ...继续填字段
inst = parseInstrument(instDict)

字段以各资产目录下的 instruments/*/fields.md 为准。字段名要使用 DolphinDB 实际枚举和字段名，例如债券用 start，不是 issueDate；权益期权用 payoffType，不是 callPut；NDF 用 direction，不是 buySell。

3. 构造 MarketData

市场数据也统一使用 dict(STRING, ANY) 后 parseMktData，或使用对应 builder。利率和波动率输入均使用小数，0.02 表示 2%，不能写成 2。

常见对象：

专用 FX pricer（fxForwardPricer / fxSwapPricer / fxEuropeanOptionPricer 等）的 spot 参数要 DOUBLE 标量；若手头是存量 FxSpotRate MKTDATA 对象，取其 value 字段得标量再传，例如 spot = extractMktData(obj)["value"]。FxSpotRate 对象本身只用于 instrumentPricer 自动匹配。

4. 选择定价入口

单资产优先使用专用 pricer；多资产组合、需要自动匹配市场数据时使用 instrumentPricer。已验证环境中 instrumentPricer 签名为三参数：

instrumentPricer(instrument, pricingDate, marketData)

不要给已验证服务器传第四个参数或 platform wrapper 专用参数。

5. 输出可审计结果

示例脚本最后应返回标量、dict 或小表，避免最后一行只是赋值或注释。推荐返回 table(...)，至少包含 pricingDate、核心输入、NPV/price、曲线名称、关键风险指标或状态字段。

6. 执行与验收

使用 execute-dlang/scripts/ddb_runner/execute.py 运行 .dos。当前 runner 已修正：DolphinDB 服务端报错会返回非 0 退出码；脚本成功但最后返回 None 仍视为成功。批量验收时仍建议同时检查退出码和输出中的 [Error]、Code Execution Failed、Server Response，以兼容旧 runner 或 server 模式。

三、资产覆盖矩阵

四、债券工作流示例

债券是本 skill 中最容易出错的资产。不能只看 Bond，必须同时识别 bondType 和 subType。

1. bondType 决定现金流结构

2. subType 决定曲线族和样本券

不要使用过期或自造枚举，例如 LOC_GOV_BOND、CORPORATE_BOND 或中文标签。

subType → 标准 discountCurve 名 映射（信用债无评级时默认 AAA 曲线）

有评级时把 _AAA 换成实际评级后缀（如 _AA+）。instrument 的 discountCurve 字段应据此填写；instrumentPricer 即按该字段自动匹配同名曲线。信用债不得静默套用国债曲线。

3. 债券曲线选择顺序

1. 用户明确提供曲线且币种、日期、风险类别匹配时，直接使用。
2. instrument 的 discountCurve 指向可信标准曲线时，优先按该曲线族取数。
3. 有同 subType、同参考日或可接受参考日的存量曲线时使用。
4. 无存量曲线时，用同 subType 样本券和真实 YTM 报价通过 bondYieldCurveBuilder 构造。
5. 样本券少于两个有效期限或报价不可信时，回退到 instrument 标准曲线或停止并补数据。

信用债、PPN、短融、ABS、商业银行金融债不能因为缺曲线就静默套国债曲线。国债曲线只能用于国债或明确的无风险基准比较。

4. 样本券选择规则

• 样本券必须与目标券同 subType，且 maturity > pricingDate。
• YTM 报价必须是真实市场报价，并转换为小数。
• 按目标期限匹配剩余期限，优先流动性更好的券。
• 对续发、柜台、重复期限或同一月到期的样本做去重。
• Bootstrap 至少需要 2 个有效期限；NS 至少建议 4 个；NSS 至少建议 6 个。

5. 债券结果解释

bondPricer 返回的是给定曲线下的现值/全价含义，不自动拆分净价、全价、应计利息和收益率。需要交易报价口径时使用：

dirtyPrice = bondPricer(bond, pricingDate, discountCurve)
accrued = bondAccrInt(start, maturity, issuePrice, coupon, frequency, dayCountConvention, bondType, pricingDate)
cleanPrice = dirtyPrice - accrued
risk = bondInstrumentCalculator(bond, pricingDate, cleanPrice, "CleanPrice", calcRisk=true)

含权债若按行权路径估值，使用 bondInstrumentCalculator(..., priceType="YTE")；YTM 是到期收益率路径。

五、文件组织