Saltar al contenido principal

Métricas

Todo resultado exitoso de /v1/quotes incluye un objeto metrics. Todas las tasas son decimales; los precios se expresan por cada 100 de valor nominal.

Precio y devengo

CampoSignificado
dirty_priceprecio sucio (valor presente de los flujos restantes)
clean_priceprecio sucio menos el interés devengado
accrued_interestinterés devengado desde el último cupón (cupón corrido)
accrued_daysdías de devengo a la fecha de liquidación

Rendimiento

CampoSignificado
yieldel rendimiento, sobre la base del rate_type del instrumento
current_yieldcupón anual ÷ precio
tecTEC — la tasa efectiva anual exacta de compra (no es una heurística)
yield_to_worstsolo para instrumentos rescatables (callables) — min(YTM, todos los rendimientos al rescate); presente cuando options.yield_worst y aplica

Riesgo

CampoSignificado
macaulay_durationtiempo promedio ponderado de los flujos (años)
modified_durationsensibilidad del precio al rendimiento (−dP/dy ÷ P)
convexitysensibilidad de segundo orden precio/rendimiento (convexidad)
dv01cambio monetario en el precio por cada movimiento de 1 pb en el rendimiento
sherman_ratiorendimiento por unidad de duración
duration_applicablefalse para PRICE_QUANTITY (las métricas de riesgo no tienen sentido)

Montos monetarios (cuando proporcionas un amount)

Si la cotización incluye amount_kind / amount_value, el resultado agrega un bloque amounts que escala los precios por 100 según el tamaño de la operación:

CampoSignificado
nominalel valor nominal resuelto
clean_amountprecio limpio × nominal / 100
accrued_amountdevengado × nominal / 100
dirty_amountprecio sucio × nominal / 100 (el efectivo de liquidación)
quantitynominal ÷ unit_nominal

Próximo cupón y flujos de caja

Todo resultado incluye un resumen next_coupon (date, interest, amortization, total, present_value). Establece options.with_cashflows: true para recibir además el calendario descontado completo (cada flujo con su fecha, monto, factor de descuento y valor presente).

:::info How yields are solved Cuando cotizas por precio, emrgex invierte precio → rendimiento con un solucionador híbrido de Newton-Raphson + Brent acotado para garantizar la convergencia. Una resolución que no converge devuelve un error 422 tipado, nunca un número incorrecto de forma silenciosa. :::