Aller au contenu principal

Métriques

Chaque résultat /v1/quotes réussi comporte un objet metrics. Tous les taux sont des décimaux ; les prix sont exprimés pour 100 de valeur nominale.

Prix et intérêts courus

ChampSignification
dirty_priceprix plein (valeur actuelle des flux restants)
clean_priceprix plein diminué des intérêts courus
accrued_interestintérêts courus depuis le dernier coupon (coupon corrido)
accrued_daysnombre de jours d'intérêts courus à la date de règlement

Rendement

ChampSignification
yieldle rendement, exprimé sur la base du rate_type de l'instrument
current_yieldcoupon annuel ÷ prix
tecTEC — le taux effectif annuel d'achat exact (et non une heuristique)
yield_to_worstuniquement pour les titres rappelables — min(YTM, tous les rendements au rappel) ; présent lorsque options.yield_worst est activé et applicable

Risque

ChampSignification
macaulay_durationdurée moyenne pondérée jusqu'aux flux (en années)
modified_durationsensibilité du prix au rendement (−dP/dy ÷ P)
convexitysensibilité de second ordre prix/rendement
dv01variation monétaire du prix pour un mouvement de rendement de 1 pb
sherman_ratiorendement par unité de duration
duration_applicablefalse pour PRICE_QUANTITY (les mesures de risque n'ont pas de sens)

Montants monétaires (lorsque vous fournissez un amount)

Si la cotation inclut amount_kind / amount_value, le résultat ajoute un bloc amounts qui met à l'échelle les prix pour 100 en fonction de la taille de la transaction :

ChampSignification
nominalle montant nominal résolu
clean_amountprix pied de coupon × nominal / 100
accrued_amountintérêts courus × nominal / 100
dirty_amountprix plein × nominal / 100 (le montant de règlement)
quantitynominal ÷ unit_nominal

Prochain coupon et flux financiers

Chaque résultat inclut un récapitulatif next_coupon (date, interest, amortization, total, present_value). Définissez options.with_cashflows: true pour recevoir également l'échéancier actualisé complet (chaque flux avec sa date, son montant, son facteur d'actualisation et sa valeur actuelle).

:::info How yields are solved Lorsque vous cotez par le prix, emrgex inverse prix → rendement à l'aide d'un solveur hybride Newton-Raphson + Brent encadré pour garantir la convergence. Une résolution non convergente renvoie une erreur typée 422, jamais un résultat erroné silencieux. :::