본문으로 건너뛰기

지표(Metrics)

성공한 모든 /v1/quotes 결과에는 metrics 객체가 포함됩니다. 모든 금리는 소수(decimal)로 표현되며, 가격은 액면 100당 가격으로 표현됩니다.

가격 및 경과이자

FieldMeaning
dirty_price더티 가격(잔여 현금흐름의 현재가치)
clean_price더티 가격에서 경과이자를 차감한 값
accrued_interest직전 쿠폰 이후 발생한 경과이자 (coupon corrido)
accrued_days결제일 기준 경과 일수

수익률(Yield)

FieldMeaning
yield해당 상품의 rate_type 기준 수익률
current_yield연간 쿠폰 ÷ 가격
tecTEC — 정확한 실효 연 매입 금리(휴리스틱 추정값이 아님)
yield_to_worst콜러블 채권 전용 — min(YTM, 모든 콜수익률); options.yield_worst가 설정되고 해당될 때 제공됨

리스크

FieldMeaning
macaulay_duration현금흐름까지의 가중평균 기간(연 단위)
modified_duration수익률 변화에 대한 가격 민감도 (−dP/dy ÷ P)
convexity가격/수익률에 대한 2차 민감도(볼록성)
dv01수익률 1bp 변동당 가격의 화폐 단위 변화
sherman_ratio듀레이션 단위당 수익률
duration_applicablePRICE_QUANTITY의 경우 false(리스크 지표가 의미 없음)

화폐 금액 (amount를 제공한 경우)

호가에 amount_kind / amount_value가 포함되면, 결과에 거래 규모에 따라 액면 100당 가격을 환산한 amounts 블록이 추가됩니다.

FieldMeaning
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 오류를 반환합니다. :::