Conventions

Un calcul dans emrgex est défini par trois axes indépendants, mondialement reconnus — il n'existe aucun code propriétaire. Vous choisissez la capitalisation, la base de décompte des jours et la formule de coupon de façon indépendante, chacune à partir d'un nom que n'importe quel intervenant du marché peut identifier.

1. rate_type — base de capitalisation / de cotation

La façon dont le taux de rendement se capitalise lors de l'actualisation.

rate_type	Signification	Actualisation
NOMINAL	taux nominal capitalisé frequency×/an (YTM de marché)	(1 + y/f)^(-f·t)
EFFECTIVE	taux effectif annuel	(1 + y)^(-t)
AT_MATURITY	escompte simple de marché monétaire (bons du Trésor / Letras)	1 / (1 + y·t)
PRICE_QUANTITY	restitution de la VL d'action / de fonds : valeur = prix × quantité (pas d'actualisation ; pas de day_count)	—

2. day_count — convention de fraction d'année (FpML / ISDA)

La façon dont le temps est mesuré, nommée selon la taxonomie FpML / ISDA 2006 §4.16.

Nom	Notes
ACT/ACT.ISDA	ISDA §4.16(b), scindée à la frontière de l'année
ACT/ACT.ICMA	ISDA §4.16(c) / ICMA Règle 251 ; une période régulière se réduit à 1/f
ACT/ACT.ISMA	alias d'ICMA
ACT/ACT.AFB	AFB 1994
ACT/360	marché monétaire
ACT/365.FIXED
ACT/365L	dénominateur tenant compte des années bissextiles
ACT/364
30/360	base US / Bond Basis
30E/360	Eurobond
30E/360.ISDA	+ règle d'échéance de février
30/360.GERMAN	alias de 30E/360.ISDA
1/1	dégénérée, pour la complétude FpML
BUS/252	Brésil B3 / ANBIMA : jours ouvrés / 252, en utilisant le calendrier de jours fériés ANBIMA intégré. Exact au bit près par rapport au Tesouro Direto LTN / NTN-F
ACT/ACT.DRMH	base de l'État dominicain (Ministerio de Hacienda) : jours réels / jours réels dans la fenêtre de 12 mois se terminant à la date de paiement. Vérifiée par rapport aux bases publiées par l'émetteur

3. coupon_type — la façon dont le montant du coupon est calculé

coupon_type	Coupon par période	Utilisé pour
FIXED (par défaut)	coupon_rate / frequency × outstanding	obligations conventionnelles à taux fixe (emprunts d'État, obligations d'entreprise, Eurobonds)
ACCRUAL	coupon_rate × yearFraction(day_count) × outstanding	obligations de marché monétaire et de marché local dont le coupon suit la longueur de la période

Les deux coïncident sous ACT/ACT.ICMA et 30E/360 (une période régulière vaut exactement 1/f) et divergent sous les décomptes en jours réels (ACT/365, ACT/360, ACT/ACT.ISDA). Un options.coupon_type par cotation remplace le paramètre de l'instrument pour les analyses de simulation.

calculation_code — l'identifiant global

Chaque instrument expose un calculation_code : la concaténation de ses deux axes principaux, <day_count>|<rate_type>. Il est dérivé de la convention, jamais une entrée qui la remplace.

ACT/ACT.ISDA|NOMINAL      ACT/360|AT_MATURITY      30E/360|EFFECTIVE      PRICE_QUANTITY

PRICE_QUANTITY n'a pas de décompte de jours, donc son code est simplement PRICE_QUANTITY.

Matrice de combinaison

Les axes sont orthogonaux — tout rate_type se combine avec tout day_count :

rate_type	day_count	calculation_code
NOMINAL	ACT/ACT.ICMA	ACT/ACT.ICMA|NOMINAL
NOMINAL	30E/360	30E/360|NOMINAL
EFFECTIVE	ACT/365.FIXED	ACT/365.FIXED|EFFECTIVE
AT_MATURITY	ACT/360	ACT/360|AT_MATURITY

Règles de validité : NOMINAL / EFFECTIVE requièrent une frequency positive ; AT_MATURITY et PRICE_QUANTITY forcent la frequency à 1 ; PRICE_QUANTITY ne prend pas de day_count ; toute autre combinaison requiert un day_count valide.

Décomptes de jours découplés (avancé)

day_count pilote normalement trois choses à la fois. Lorsqu'un instrument a besoin de bases différentes par axe, remplacez-les individuellement — chacune est optionnelle et revient par défaut à day_count :

Champ	Axe qu'il contrôle
accrual_day_count	intérêts courus (coupon corrido)
coupon_day_count	le montant du coupon ACCRUAL
discount_day_count	l'exposant de temps d'actualisation t (valeur présente)

Par exemple, les obligations d'État dominicaines ACT/ACT courent sur la base 365/366 de l'émetteur mais s'actualisent sur des périodes de marché/ICMA — modélisées par day_count: ACT/ACT.DRMH avec discount_day_count: ACT/ACT.ICMA.

Découvrir ce qui est pris en charge

curl https://calc.dev.emrgex.com/v1/admin/conventions

Renvoie chaque rate_type et day_count avec une description, ainsi que le format de calculation_code.