Passa al contenuto principale

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

FieldMeaning
dirty_priceprezzo tel quel (valore attuale dei flussi di cassa residui)
clean_priceprezzo tel quel meno il rateo di interessi
accrued_interestinteressi maturati dall'ultima cedola (coupon corrido)
accrued_daysgiorni di rateo alla data di regolamento

Rendimento

FieldMeaning
yieldil rendimento, espresso sulla base del rate_type dello strumento
current_yieldcedola annua ÷ prezzo
tecTEC — il tasso effettivo annuo esatto di acquisto (non una stima euristica)
yield_to_worstsolo per i titoli callable — min(YTM, tutti i rendimenti a call); presente quando options.yield_worst è impostato e applicabile

Rischio

FieldMeaning
macaulay_durationdurata media ponderata dei flussi di cassa (anni)
modified_durationsensibilità del prezzo al rendimento (−dP/dy ÷ P)
convexitysensibilità prezzo/rendimento del secondo ordine
dv01variazione monetaria del prezzo per uno spostamento di 1 bp del rendimento
sherman_ratiorendimento per unità di duration
duration_applicablefalse 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:

FieldMeaning
nominalil valore nominale risolto
clean_amountclean price × nominale / 100
accrued_amountrateo × nominale / 100
dirty_amountdirty price × nominale / 100 (il contante di regolamento)
quantitynominale ÷ 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. :::