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
| Campo | Significado |
|---|---|
dirty_price | precio sucio (valor presente de los flujos restantes) |
clean_price | precio sucio menos el interés devengado |
accrued_interest | interés devengado desde el último cupón (cupón corrido) |
accrued_days | días de devengo a la fecha de liquidación |
Rendimiento
| Campo | Significado |
|---|---|
yield | el rendimiento, sobre la base del rate_type del instrumento |
current_yield | cupón anual ÷ precio |
tec | TEC — la tasa efectiva anual exacta de compra (no es una heurística) |
yield_to_worst | solo para instrumentos rescatables (callables) — min(YTM, todos los rendimientos al rescate); presente cuando options.yield_worst y aplica |
Riesgo
| Campo | Significado |
|---|---|
macaulay_duration | tiempo promedio ponderado de los flujos (años) |
modified_duration | sensibilidad del precio al rendimiento (−dP/dy ÷ P) |
convexity | sensibilidad de segundo orden precio/rendimiento (convexidad) |
dv01 | cambio monetario en el precio por cada movimiento de 1 pb en el rendimiento |
sherman_ratio | rendimiento por unidad de duración |
duration_applicable | false 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:
| Campo | Significado |
|---|---|
nominal | el valor nominal resuelto |
clean_amount | precio limpio × nominal / 100 |
accrued_amount | devengado × nominal / 100 |
dirty_amount | precio sucio × nominal / 100 (el efectivo de liquidación) |
quantity | nominal ÷ 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.
:::