Risico- en Rendementsmetrieken

Dit document beschrijft de risico- en rendementsmetrieken die de calculator voor vastrentende instrumenten berekent. Elke metriek wordt afgeleid van de cashflows van het instrument en de bijbehorende day_count-conventie.

Overzicht

Wanneer je een instrument waardeert, retourneert de calculator een reeks metrieken naast de prijs. Welke metrieken beschikbaar zijn, hangt af van het rate_type en de calculation_code die in het verzoek zijn opgegeven.

notitie

Alle metrieken worden berekend op de afwikkelingsdatum (settlement date), niet op de handelsdatum (trade date). Zorg ervoor dat je settlement_date correct instelt voordat je de resultaten interpreteert.

Yield to Maturity

De yield to maturity (rendement tot einde looptijd) is de interne rentevoet die de contante waarde van alle toekomstige cashflows gelijkstelt aan de huidige clean_price van het instrument. Hij wordt uitgedrukt als een jaarlijks percentage.

Voor een instrument met rate_type gelijk aan NOMINAL wordt het rendement berekend op nominale basis. Voor EFFECTIVE wordt rekening gehouden met samengestelde rente (compounding) binnen de couponperiode.

Veld	Beschrijving
yield	Het geannualiseerde rendement tot einde looptijd
clean_price	De prijs exclusief opgebouwde rente (accrued interest)
amount_kind	Ofwel PRICE_QUANTITY ofwel een notioneel bedrag

Wanneer je input_kind instelt op yield, draait de calculator de berekening om en leidt hij de prijs af uit het opgegeven rendement.

Duration en Convexity

Duration meet de gevoeligheid van de prijs van het instrument voor veranderingen in het rendement. De calculator rapporteert zowel de Macaulay-duration als de modified duration.

• Macaulay-duration: de gewogen gemiddelde looptijd tot ontvangst van de cashflows, uitgedrukt in jaren.
• Modified duration: de procentuele prijsverandering bij een renteverandering van 1%.

Convexity meet de mate waarin de duration verandert naarmate het rendement verandert. Hogere convexity duidt op een grotere kromming in de prijs-rendementsrelatie.

tip

Gebruik bij het vergelijken van instrumenten met verschillende day_count-conventies (bijvoorbeeld ACT/ACT.ICMA versus BUS/252) altijd de modified duration zodat de getallen onderling vergelijkbaar zijn.

Opgebouwde rente (Accrued Interest)

De opgebouwde rente is de rente die is opgebouwd sinds de laatste coupondatum tot aan de afwikkelingsdatum. Ze wordt berekend met de day_count-conventie van het instrument:

{
  "instrument_id": "BR-NTNB-2035",
  "input_kind": "PRICE_QUANTITY",
  "rate_type": "EFFECTIVE",
  "day_count": "BUS/252",
  "calculation_code": "AT_MATURITY",
  "options": {
    "with_cashflows": true
  }
}

De dirty_price is de som van de clean_price en de opgebouwde rente. Voor instrumenten met de conventie ACT/ACT.DRMH gebruikt de berekening van de opgebouwde rente werkelijke kalenderdagen.

Cashflows opvragen

Stel with_cashflows in op true om het volledige cashflowschema in het antwoord op te nemen. Elke cashflow bevat de datum, het bedrag en het type:

curl -X POST https://api.example.com/v1/calculate \
  -H "Content-Type: application/json" \
  -d '{
    "instrument_id": "MX-CETES-180",
    "input_kind": "PRICE_QUANTITY",
    "rate_type": "NOMINAL",
    "day_count": "ACT/ACT.ICMA",
    "options": { "with_cashflows": true }
  }'

Zie Conventies voor instrumenten voor de volledige lijst met ondersteunde day_count-conventies en hoe ze elke metriek beïnvloeden.

info

Het veld amount_kind bepaalt of cashflowbedragen per eenheid worden uitgedrukt (PRICE_QUANTITY) of als notionele waarden. Controleer dit veld altijd voordat je metrieken tussen instrumenten aggregeert.

Samenvatting

Metriek	Vereist rate_type	Opmerkingen
yield	Eender welke	Omgekeerd af te leiden via input_kind: yield
Macaulay-duration	NOMINAL | EFFECTIVE	Uitgedrukt in jaren
Modified duration	NOMINAL | EFFECTIVE	Geprefereerd voor vergelijkingen
Convexity	EFFECTIVE	Vereist het volledige cashflowschema
Opgebouwde rente	Eender welke	Gebruikt de day_count van het instrument

Raadpleeg voor implementatiedetails de API-referentie.