Метрики
Каждый успешный результат /v1/quotes содержит объект metrics. Все ставки выражены десятичными дробями; цены приводятся
на 100 единиц номинала.
Цена и накопленный доход
| Поле | Значение |
|---|---|
dirty_price | полная (грязная) цена (приведённая стоимость остающихся денежных потоков) |
clean_price | грязная цена за вычетом накопленного купонного дохода |
accrued_interest | проценты, накопленные с момента последнего купона (coupon corrido) |
accrued_days | количество дней накопления на дату расчётов |
Доходность
| Поле | Значение |
|---|---|
yield | доходность, рассчитанная на основе rate_type инструмента |
current_yield | годовой купон ÷ цена |
tec | TEC — точная эффективная годовая ставка покупки (не эвристика) |
yield_to_worst | только для отзывных облигаций — min(YTM, всех доходностей к оферте); присутствует, когда задано options.yield_worst и это применимо |
Риск
| Поле | Значение |
|---|---|
macaulay_duration | средневзвешенное время до денежных потоков (в годах) |
modified_duration | чувствительность цены к доходности (−dP/dy ÷ P) |
convexity | чувствительность цены к доходности второго порядка |
dv01 | денежное изменение цены на 1 б.п. сдвига доходности |
sherman_ratio | доходность на единицу дюрации |
duration_applicable | false для PRICE_QUANTITY (метрики риска не имеют смысла) |
Денежные суммы (когда вы указываете amount)
Если котировка включает amount_kind / amount_value, результат дополняется блоком amounts, который масштабирует
цены на 100 единиц на размер сделки:
| Поле | Значение |
|---|---|
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 инвертирует цена → доходность с помощью гибридного решателя Ньютона-Рафсона + Брента
с гарантированной сходимостью за счёт ограничения интервала. Несошедшийся расчёт возвращает типизированную ошибку 422, а не
молчаливо неверное число.
:::