Function ATM Rate within with keys returns the At-The-Money rate(s) of the referenced bond(s) as of a given reference date Tˢ
This is the theoretical fixed flat coupon rate that the bond would need to have in order for its calculated to equal a given clean price input.
A discounting yield curve must be provided.
If a clean price is not provided, it is calculated from the given discounting yield curve.
If the settlement date Tˢ is not explicitly given, it will be set to the bond's settlement date as implied by a trade transaction assumed to occur on the T₀ (typically today).
PRECAUTION: This function treats the referenced bond as if it were a fixed rate bond even if this is not the case!
All index-linked cash flows are treated as fixed cash flows that pay the amount forecasted by the corresponding curve.