emrgex — 固定收益计算器
emrgex 是一个用于为固定收益（renta fija）工具定价的 API。向它发送一只债券和一个报价，它就会返回价格、收益率、应计利息以及一整套风险指标；或者发送一个价格，它会反解出收益率。它支持政府债券和公司债券、货币市场票据、摊还式和可赎回结构，以及指数挂钩工具。
它能做什么
- 价格 ↔ 收益率。 以
yield、clean_price、dirty_price或transacted成交金额进行报价，emrgex 会计算其余部分。 - 风险指标。 净价/全价、应计利息、麦考利久期与修正久期、凸性、DV01、当期收益率、TEC（有效年化买入利率）、Sherman 比率，以及可赎回债券的最差收益率（yield-to-worst）。
- 现金流与持有收益。 生成债券的现金流时间表，或计算到某一期限的每日持有收益（carry）。
- 批量。 在单次请求中为成千上万只工具定价。
核心理念：具名的全局约定
emrgex 中的计算不依赖晦涩、特定于产品的代码，而是由三个相互独立、全球公认的维度来定义：
| 维度 | 它确定了什么 | 示例 |
|---|---|---|
rate_type | 收益率如何复利 | NOMINAL、EFFECTIVE、AT_MATURITY |
day_count | 时间如何计量（FpML / ISDA） | ACT/ACT.ICMA、30E/360、BUS/252 |
coupon_type | 票息金额如何计算 | FIXED、ACCRUAL |
任意 rate_type 都可与任意 day_count 组合；二者的组合即为该工具的 calculation_code（例如 ACT/ACT.ICMA|NOMINAL）。参见 约定。
两种定价方式
- 存储工具 — 通过
id引用目录中已有的债券。 - 临时工具 — 在请求中内联定义债券。
两种方式在每次调用时都会重新计算完整估值。参见 工具。
后续步骤
:::note Base URL
开发环境服务地址为 https://calc.dev.emrgex.com。所有端点均位于 /v1 之下。
:::