Metriche
Ogni risultato /v1/quotes andato a buon fine contiene un oggetto metrics. Tutti i tassi sono in
forma decimale; i prezzi sono espressi per 100 di valore nominale.
Prezzo e rateo
| Field | Meaning |
|---|---|
dirty_price | prezzo tel quel (valore attuale dei flussi di cassa residui) |
clean_price | prezzo tel quel meno il rateo di interessi |
accrued_interest | interessi maturati dall'ultima cedola (coupon corrido) |
accrued_days | giorni di rateo alla data di regolamento |
Rendimento
| Field | Meaning |
|---|---|
yield | il rendimento, espresso sulla base del rate_type dello strumento |
current_yield | cedola annua ÷ prezzo |
tec | TEC — il tasso effettivo annuo esatto di acquisto (non una stima euristica) |
yield_to_worst | solo per i titoli callable — min(YTM, tutti i rendimenti a call); presente quando options.yield_worst è impostato e applicabile |
Rischio
| Field | Meaning |
|---|---|
macaulay_duration | durata media ponderata dei flussi di cassa (anni) |
modified_duration | sensibilità del prezzo al rendimento (−dP/dy ÷ P) |
convexity | sensibilità prezzo/rendimento del secondo ordine |
dv01 | variazione monetaria del prezzo per uno spostamento di 1 bp del rendimento |
sherman_ratio | rendimento per unità di duration |
duration_applicable | false per PRICE_QUANTITY (le metriche di rischio non sono significative) |
Importi monetari (quando si fornisce un amount)
Se la quotazione include amount_kind / amount_value, il risultato aggiunge un blocco amounts che
scala i prezzi per 100 in base alla dimensione dell'operazione:
| Field | Meaning |
|---|---|
nominal | il valore nominale risolto |
clean_amount | clean price × nominale / 100 |
accrued_amount | rateo × nominale / 100 |
dirty_amount | dirty price × nominale / 100 (il contante di regolamento) |
quantity | nominale ÷ unit_nominal |
Prossima cedola e flussi di cassa
Ogni risultato include un riepilogo next_coupon (date, interest, amortization, total,
present_value). Imposta options.with_cashflows: true per ricevere anche il piano completo
attualizzato (ciascun flusso con la propria data, importo, fattore di sconto e valore attuale).
:::info How yields are solved
Quando quoti per prezzo, emrgex inverte prezzo → rendimento con un solver ibrido Newton-Raphson + Brent
delimitato per garantire la convergenza. Una risoluzione non convergente restituisce un errore tipizzato
422, mai un valore errato in modo silenzioso.
:::