Autres points de terminaison

Tous les points de terminaison se trouvent sous https://calc.dev.emrgex.com/v1.

POST /v1/carry

Portage quotidien (intérêts effectifs) pour un ensemble d'instruments ad hoc et/ou stockés — par lot. Chaque élément carries référence un instrument et fournit une donnée d'entrée et (facultativement) un horizon carry_to (vide = date du prochain coupon).

curl -s https://calc.dev.emrgex.com/v1/carry -H 'content-type: application/json' -d '{
  "carries": [
    { "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.10,
      "settlement_date": "2026-06-09", "carry_to": "2026-09-09" }
  ]
}'

POST /v1/generate_cash_flows

Génère les échéanciers de flux de trésorerie pour un ensemble d'instruments ad hoc et/ou stockés — par lot.

curl -s https://calc.dev.emrgex.com/v1/generate_cash_flows -H 'content-type: application/json' -d '{
  "schedules": [ { "instrument_id": "MH12034" } ]
}'

GET /v1/admin/conventions

Découverte : chaque rate_type et day_count pris en charge par le moteur, chacun accompagné d'une description, ainsi que le format calculation_code. Voir Conventions.

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

GET /v1/admin/instruments

Liste les caractéristiques des instruments stockés (pas de tableaux de flux de trésorerie sauf si with_cashflows=true ; cashflow_count est toujours inclus). Tous les filtres sont facultatifs et combinés par ET (AND).

Paramètre de requête	Correspondance
rate_type, day_count, calculation_code, currency, period_name	exacte
issuer, rate_kind, name	sous-chaîne (insensible à la casse)
q	sous-chaîne sur id / nemo / isin / issuer / name
amortizing, callable	booléen
maturity_from, maturity_to	plage de dates inclusive
coupon_min, coupon_max	plage
sort	id · nemo · issuer · maturity · coupon
order	asc · desc
limit (≤ 1000), offset	pagination ; limit=0 ne renvoie que le total
with_cashflows	inclut l'échéancier stocké de chaque instrument

curl "https://calc.dev.emrgex.com/v1/admin/instruments?callable=true&sort=maturity&limit=10"

PATCH /v1/admin/instruments/{id}

Met à jour sur place le coupon_rate et/ou le coupon_type d'un instrument stocké — par exemple une révision de taux variable ou une repactuação. La modification est une surcharge en mémoire (un rechargement du catalogue restaure la vue du fichier) et invalide le cache afin que le prochain calcul la prenne en compte.

curl -s -X PATCH https://calc.dev.emrgex.com/v1/admin/instruments/MH12034 \
  -H 'content-type: application/json' -d '{ "coupon_rate": 0.12 }'

POST /v1/admin/cache/reload

Recharge le référentiel d'instruments (échange atomique, non fatal).

Sondes de santé

Point de terminaison	Objet
GET /v1/health/livez	vivacité (processus uniquement)
GET /v1/health/readyz	disponibilité (échoue pendant la vidange)
GET /v1/health/startupz	démarrage (chargement à chaud terminé)

curl https://calc.dev.emrgex.com/v1/health/livez   # {"status":"alive"}

Erreurs

Les erreurs utilisent le format RFC 7807 application/problem+json avec type, title, status et detail. Dans un lot, les échecs propres à chaque élément apparaissent dans le champ error de cet élément tandis que les autres réussissent.