Перейти к основному содержимому

Метрики

Каждый успешный результат /v1/quotes содержит объект metrics. Все ставки выражены десятичными дробями; цены приводятся на 100 единиц номинала.

Цена и накопленный доход

ПолеЗначение
dirty_priceполная (грязная) цена (приведённая стоимость остающихся денежных потоков)
clean_priceгрязная цена за вычетом накопленного купонного дохода
accrued_interestпроценты, накопленные с момента последнего купона (coupon corrido)
accrued_daysколичество дней накопления на дату расчётов

Доходность

ПолеЗначение
yieldдоходность, рассчитанная на основе rate_type инструмента
current_yieldгодовой купон ÷ цена
tecTEC — точная эффективная годовая ставка покупки (не эвристика)
yield_to_worstтолько для отзывных облигаций — min(YTM, всех доходностей к оферте); присутствует, когда задано options.yield_worst и это применимо

Риск

ПолеЗначение
macaulay_durationсредневзвешенное время до денежных потоков (в годах)
modified_durationчувствительность цены к доходности (−dP/dy ÷ P)
convexityчувствительность цены к доходности второго порядка
dv01денежное изменение цены на 1 б.п. сдвига доходности
sherman_ratioдоходность на единицу дюрации
duration_applicablefalse для 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, а не молчаливо неверное число. :::