emrgex — 固定收益計算器
emrgex 是一個用於為固定收益（renta fija）工具定價的 API。向它傳入一檔債券及其報價，它便會回傳價格、殖利率、應計利息，以及一整套風險指標——或者傳入價格，它會反解出殖利率。它可處理政府債與公司債、貨幣市場票券、攤還式與可贖回結構，以及指數連結型工具。
功能說明
- 價格 ↔ 殖利率。 以
yield、clean_price、dirty_price或transacted成交金額報價；emrgex 會計算其餘各項。 - 風險指標。 淨價／含息價、應計利息、Macaulay 與修正存續期間、凸性、DV01、當期殖利率、TEC（年化有效買入利率）、Sherman 比率，以及可贖回債券的最差殖利率。
- 現金流與持有損益。 產生債券的現金流時程表，或計算至某一持有期間的每日持有損益。
- 批次處理。 在單一請求中為數以千計的工具定價。
核心理念：具名的全域慣例
emrgex 中的計算並非以不透明、特定於產品的代碼來定義，而是由三個獨立、全球公認的軸向所決定：
| Axis | What it sets | Examples |
|---|---|---|
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 之下。
:::