POST /v1/quotes

핵심 엔드포인트입니다. 선택적인 애드혹(ad-hoc) 상품 풀과, 상품을 id로 참조하는 호가(quotes) 목록을 함께 평가합니다(풀에 담긴 애드혹 또는 저장된 상품). 호가별로 하나씩, 각각 고유한 상태를 가진 항목으로 구성된 배치 결과를 반환합니다.

Request body

{
  "instruments": [ /* optional ad-hoc pool; each item needs an id */ ],
  "quotes": [ /* one or more quotes */ ]
}

호가 필드

Field	Required	Description
`instrument_id`	yes	풀에 담긴 애드혹 상품 또는 저장된 상품의 id
`input_kind`	yes	`yield` · `clean_price` · `dirty_price` · `transacted`
`input_value`	yes	수익률(소수) 또는 가격(100 기준), 혹은 체결 대금
`amount_kind`	no	`nominal` 또는 `transacted` (거래 규모)
`amount_value`	no	`amount_kind`가 설정된 경우 필수 (> 0)
`settlement_date`	no	ISO 날짜; 기본값은 당일
`options`	no	아래 참조

`input_kind`

Value	You supply	emrgex returns
`yield`	수익률	가격 + 지표
`clean_price`	클린 가격(clean price)	산출된 수익률 + 지표
`dirty_price`	더티 가격(dirty price)	산출된 수익률 + 지표
`transacted`	더티 대금 금액 (`amount_kind: nominal` 필요)	가격을 도출한 뒤 수익률을 산출

`options`

Option	Type	Description
`round`	int (0–12)	금액/금리 출력값을 소수점 N자리로 반올림
`with_cashflows`	bool	할인된 현금흐름 일정 전체를 포함
`yield_worst`	bool	콜러블(callable) 채권에 대해 최악수익률(yield-to-worst)을 계산
`coupon_type`	`FIXED`/`ACCRUAL`	호가별 쿠폰 메커니즘 재정의(what-if)
`index_ratio`	number	물가연동채권의 공시 지수 명목값(VNA); 모든 금액 출력값에 `index_ratio/100`이 곱해짐

Response — 배치 엔벨로프

{
  "data": [
    {
      "index": 0,
      "id": "MH12034",
      "status": "ok",
      "data": {
        "instrument_id": "MH12034",
        "convention": "NOMINAL · ACT/ACT.DRMH",
        "calculation_code": "ACT/ACT.DRMH|NOMINAL",
        "coupon_type": "ACCRUAL",
        "settlement_date": "2026-06-09T00:00:00Z",
        "metrics": { "yield": 0.1, "dirty_price": 112.547645, "clean_price": 107.853124, "...": "..." },
        "next_coupon": { "date": "...", "interest": 5.75, "total": 5.75, "present_value": 5.7 }
      }
    }
  ],
  "warnings": []
}

각 항목은 data 페이로드를 가진 status: "ok"이거나, RFC 7807 error 객체를 가진 status: "failed"입니다 — 하나의 잘못된 호가가 배치 전체를 실패시키지 않습니다.
가격→수익률 산출이 수렴하지 않으면 해당 항목에 대해 422를 반환합니다.

다섯 가지 입력 시나리오

input_kind × amount_kind 조합이 거래되는 경우의 수를 모두 포괄합니다:

`input_kind`	`amount_kind`	Use
`yield`	`nominal`	수익률 + 액면 → 가격 및 결제 대금
`yield`	`transacted`	수익률 + 대금 → 내재 명목금액
`clean_price`	`nominal`	가격 + 액면 → 수익률 및 대금
`clean_price`	`transacted`	가격 + 대금 → 수익률 및 명목금액
`transacted`	`nominal`	대금 + 액면 → 가격 및 수익률

전체 요청 본문은 **예제**를 참조하십시오.

Request body​

호가 필드​

input_kind​

options​

Response — 배치 엔벨로프​

다섯 가지 입력 시나리오​