SMMAmort

Updated 2023-10-11 14:34:45.087000

Syntax

SELECT * FROM [wct].[SMMAmort](
  <@PrinAmt, float,>
 ,<@InterestRate, float,>
 ,<@NumPmts, int,>
 ,<@LastPmtNum, int,>
 ,<@PmtPerYr, int,>
 ,<@LSRatesQuery, nvarchar(max),>
 ,<@CPRRatesQuery, nvarchar(max),>
 ,<@CDRRatesQuery, nvarchar(max),>
 ,<@InterestOnly, bit,>
 ,<@PrinPaymentMultiple, int,>
 ,<@FirstPrinPayNo, int,>
 ,<@PmtPayPct, float,>)

Description

Use the table-valued function SMMAmort to return a cash-flow schedule for a loan with a fixed periodic payment with Conditional Prepayment Rates (CPR) and Constant Default Rates (CDR) applied. SMMAmort potentially reduces the number of scheduled payments through the application of the prepayment and default rates.

Arguments

@InterestRate

the annual rate of interest used to calculate the periodic payment. @InterestRate is an expression of type float or of a type that can be implicitly converted to float.

@CDRRatesQuery

a SELECT statement, as a string, which returns the month and default rate to be used in the calculation of the default amounts. @CDRRatesQuery should return 2 columns, month and rate, where 1% = .01.

@FirstPrinPayNo

the payment number of the first principal payment. @FirstPrinPayNo is an expression of type int or of a type that can be implicitly converted to int.

@PmtPerYr

the number of payments per year. @PmtPerYr is an expression of type int or of a type that can be implicitly converted to int.

@PmtPayPct

a fixed percentage which is applied to the projected principal balance to calculate the projected principal payment. @PmtPayPct is of a type float or of a type that can be implicitly converted to float.

@CPRRatesQuery

a SELECT statement, as a string, which returns the month and prepayment rates to be used in the calculation of the principal prepayments. @CPRratesQuery should return 2 columns, month and rate, where 1% = .01.

@NumPmts

the number of periods to be used in the calculation of the periodic payment. @NumPmts is an expression of type int or of a type that can be implicitly converted to int.

@PrinAmt

the principal amount to be amortized. @PrinAmt is an expression of type float or of a type that can be implicitly converted to float.

@LastPmtNum

the number of the last payment. Use @LastPmtNum for case where the number of payments for the annuity calculation is different than the actual number of payments. For example, an annuity based on 300 monthly payment which will be paid off at the end of 120 months. @LastPmtNum is an expression of type int or of a type that can be implicitly converted to int.

@InterestOnly

a bit value, which when true, identifies that the principal amount is scheduled to be repaid at the end of the loan.

@LSRatesQuery

a SELECT statement, as a string, which returns the month and loss severity rates to be used in the calculation of the loss severity amounts. @LSRatesQuery should return 2 columns, month and rate, where 1% = .01.

@PrinPaymentMultiple

the ratio of the frequency of the interest payments to the frequency of the interest payments. For example, a loan with monthly payments of interest and quarterly payments of principal would have a @PrinPaymentMultiple of 3. @PrinPaymentMultiple is an expression of type int or of a type that can be implicitly converted to int.

Return Type

table

{"columns": [{"field": "colName", "headerName": "Name", "header": "name"}, {"field": "colDatatype", "headerName": "Type", "header": "type"}, {"field": "colDesc", "headerName": "Description", "header": "description", "minWidth": 1000}], "rows": [{"id": "4197b96c-38a8-4210-8ed4-946866fb98b1", "colName": "num_pmt", "colDatatype": "int", "colDesc": "\t payment number"}, {"id": "912127dc-7d00-435c-81f2-8c68b52cb5f8", "colName": "CPR", "colDatatype": "float", "colDesc": "the Conditional Prepayment Rate"}, {"id": "cef01579-d0b2-4449-a60b-92b8158414bf", "colName": "CDR", "colDatatype": "float", "colDesc": "the Constant Default Rate"}, {"id": "f27c84bb-cae4-41c5-87e8-73857df39afd", "colName": "LS", "colDatatype": "float", "colDesc": "the Loss Severity Rate"}, {"id": "0fe4d7a0-db10-492f-9a72-563060fe618b", "colName": "cont_prin_begin", "colDatatype": "float", "colDesc": "When num_pmt = 1 then @PrinAmt else cont_prin_end from the previous row"}, {"id": "f21aeebc-44c3-4010-aef4-d7d75552a26d", "colName": "cont_pmt", "colDatatype": "float", "colDesc": "the contractual periodic payment"}, {"id": "ad96994e-b347-4727-9249-64dc253ebb4d", "colName": "cont_int_pay", "colDatatype": "float", "colDesc": "the contractual interest payment; @InterestRate / @PmtPerYr * cont_prin_begin"}, {"id": "d43eff51-7c4f-4e87-8174-aaa4f14b733d", "colName": "cont_prin_pay", "colDatatype": "float", "colDesc": "the contractual principal payment"}, {"id": "882c7f75-fe18-4c08-9959-e14c8ae78eb8", "colName": "proj_prin_begin", "colDatatype": "float", "colDesc": "When num_pmt = 1 then @PrinAmt else proj_prin_end from the previous row"}, {"id": "b12806bf-75b0-4613-a846-b57a37e017e0", "colName": "proj_pmt", "colDatatype": "float", "colDesc": "the projected periodic payment. For interest-only payments, the proj_pmt is @InterestRate / @PmtPerYr * proj_prin_begin. For annuity type loans, the proj_pmt is the cont_pmt. For loans with a principal grace period at inception, the proj_pmt is recalculated using the proj_prin_begin at the time of the first amortizing payment."}, {"id": "31fb32e3-a3e9-48c0-aaff-cc196115b1c7", "colName": "proj_int_pay", "colDatatype": "float", "colDesc": "the projected interest payment; @InterestRate / @PmtPerYr * proj_prin_begin"}, {"id": "fc46b49d-58bf-4c7f-a7cb-7e6c39ba2c99", "colName": "proj_prin_pay", "colDatatype": "float", "colDesc": "the projected principal payment; proj_pmt \u2013 proj_int_pay"}, {"id": "42c3b66f-8e38-47a9-8156-03fca9152aa4", "colName": "prin_prepay", "colDatatype": "float", "colDesc": "(1- POWER(1-CPR,1 / @PmtPerYr) * (proj_prin_begin \u2013 proj_prin_pay)"}, {"id": "1fc137a1-a8eb-4fb5-bf13-98c8b7bfa208", "colName": "amt_default", "colDatatype": "float", "colDesc": "(proj_prin_begin \u2013 proj_prin_pay) * (1 - POWER(1 - CDR, 1 / @PmtPerYr))"}, {"id": "d932b78d-d3e4-4821-b019-26f4d4950e37", "colName": "amt_loss_severity", "colDatatype": "float", "colDesc": "amt_default * @LossSeverity"}, {"id": "92b4b80b-723a-40eb-ae02-9bfddc4bda34", "colName": "proj_prin_end", "colDatatype": "float", "colDesc": "the projected principal ending balance; proj_prin_begin \u2013 proj_prin_pay - prin_prepay - amt_default"}, {"id": "eb0fa11f-b89c-4e3a-acef-9ce1047bf156", "colName": "proj_amt_cashflow", "colDatatype": "float", "colDesc": "the projected cash flow amount; proj_pmt + prin_prepay + amt_default - amt_loss_severity"}]}

Remarks

If @FirstPrinPayNo is NULL then @FirstPrinPayNo = 1.

If @PrinAmt is NULL then @PrinAmt = 0.

If @InterestRate is NULL then @InterestRate = 0.

If @NumPmts is NULL then @NumPmts = 0.

If @LastPmtNum is NULL then @LastPmtNum = @NumPmts.

If @InterestOnly is NULL then @InterestOnly = FALSE.

If @PrinPaymentMultiple is NULL then @PrinPaymentMultiple = 1.

If @FirstPrinPayNo is NULL then @FirstPrinPayNo = @PrinPaymentMultiple.

If @NumPmts < 1 then no rows are returned.

If @PrinPaymentMultiple < 1 then no rows are returned.

If @FirstPrinPayNo < 1 then no rows are returned.

@PmtPerYr must be 1, 2, 3, 4, 6 or 12.

If @LSRatesQuery returns NULL or no rows then LS is set to zero.

If @CDRRatesQuery returns NULL or no rows then CDR is set to zero.

If @CPRRatesQuery returns NULL or no rows then CPR is set to zero.

Examples

Use the following CPR rates, which have been inserted into the #cpr table, for all of the examples.

SELECT *

INTO #cpr

FROM

(

    VALUES

        (1, 0.002),

        (25, 0.012),

        (61, 0.02),

        (181, 0.06)

) n (mth, rate);

Use the following CDR rates, which have been inserted into the #cdr table, for all of the examples.

SELECT *

INTO #cdr

FROM

(

    VALUES

        (1, 0.1),

        (61, 0.08),

        (181, 0.05)

) n (mth, rate);

Use the following Loss Severity rates, which have been inserted into the #ls table, for all the examples.

SELECT *

INTO #ls

FROM

(

    VALUES

        (1, 0.15),

        (91, 0.16),

        (181, 0.14),

        (271, 0.17),

        (361, 0.13)

) n (mth, rate);

Example #1

In this example we amortize a 100,000,000 loan with a 5% interest rate over 360 months using the data from the #ls, #cpr, and #cdr tables without modification.

SELECT *

FROM wct.SMMAmort(   100000000,            --@PrinAmt

                     0.05,                 --@InterestRate

                     360,                  --@NumPmts

                     NULL,                 --@LastPmtNum

                     12,                   --@PmtPerYr

                     'SELECT * FROM #ls',  --@LSRatesQuery

                     'SELECT * FROM #cpr', --@CPRRatesQuery

                     'SELECT * FROM #cdr', --@CDRRatesQuery

                     NULL,                 --@InterestOnly

                     NULL,                 --@PrinPaymentMultiple

                     NULL,                 --@FirstPrinPayNo

                     NULL                  --@PmtPayPct

                 );