지표(Metrics)
성공한 모든 /v1/quotes 결과에는 metrics 객체가 포함됩니다. 모든 금리는 소수(decimal)로 표현되며,
가격은 액면 100당 가격으로 표현됩니다.
가격 및 경과이자
| Field | Meaning |
|---|---|
dirty_price | 더티 가격(잔여 현금흐름의 현재가치) |
clean_price | 더티 가격에서 경과이자를 차감한 값 |
accrued_interest | 직전 쿠폰 이후 발생한 경과이자 (coupon corrido) |
accrued_days | 결제일 기준 경과 일수 |
수익률(Yield)
| Field | Meaning |
|---|---|
yield | 해당 상품의 rate_type 기준 수익률 |
current_yield | 연간 쿠폰 ÷ 가격 |
tec | TEC — 정확한 실효 연 매입 금리(휴리스틱 추정값이 아님) |
yield_to_worst | 콜러블 채권 전용 — min(YTM, 모든 콜수익률); options.yield_worst가 설정되고 해당될 때 제공됨 |
리스크
| Field | Meaning |
|---|---|
macaulay_duration | 현금흐름까지의 가중평균 기간(연 단위) |
modified_duration | 수익률 변화에 대한 가격 민감도 (−dP/dy ÷ P) |
convexity | 가격/수익률에 대한 2차 민감도(볼록성) |
dv01 | 수익률 1bp 변동당 가격의 화폐 단위 변화 |
sherman_ratio | 듀레이션 단위당 수익률 |
duration_applicable | PRICE_QUANTITY의 경우 false(리스크 지표가 의미 없음) |
화폐 금액 (amount를 제공한 경우)
호가에 amount_kind / amount_value가 포함되면, 결과에 거래 규모에 따라 액면 100당 가격을 환산한
amounts 블록이 추가됩니다.
| Field | Meaning |
|---|---|
nominal | 산출된 액면 금액 |
clean_amount | 클린 가격 × 액면 / 100 |
accrued_amount | 경과이자 × 액면 / 100 |
dirty_amount | 더티 가격 × 액면 / 100(결제 대금) |
quantity | 액면 ÷ unit_nominal |
다음 쿠폰 및 현금흐름
모든 결과에는 next_coupon 요약(date, interest, amortization, total,
present_value)이 포함됩니다. options.with_cashflows: true를 설정하면 할인된 전체 일정도 함께 받을 수 있습니다
(각 현금흐름의 날짜, 금액, 할인계수, 현재가치 포함).
:::info How yields are solved
가격으로 호가를 조회하면, emrgex는 수렴을 보장하기 위해 구간을 설정한 Newton-Raphson + Brent 하이브리드 솔버로
가격 → 수익률을 역산합니다. 수렴하지 않는 계산은 조용히 잘못된 값을 반환하는 대신 타입이 지정된 422 오류를
반환합니다.
:::