Simple interest API
Simple interest for a number of years or between two dates, with standard day-count conventions (Actual/365, Actual/360, Actual/Actual, 30/360, 30E/360).
POST https://api.curatedapi.com/v1/calc/finance/simple-interest
- Version 1
- MCP tool
calc_finance_simple_interest - Try it in the browser
Interest that is not compounded: I = P × r × t. Give the time either as a number of years or as a start and end date. With dates, the year fraction t follows a day-count convention from the ISDA 2006 Definitions; the exact fraction used is returned so you can check it.
Formula
I = P × r × t; total = P + I
- Amounts are plain numbers in any single currency; no currency conversion is done.
- The start date is included and the end date is excluded.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
principal required |
decimal (string) | Amount the interest is charged on. Allowed: >= 0 and <= 1000000000000000. Unit: currency. |
annual_rate_percent required |
decimal (string) | Annual interest rate in percent. Allowed: >= 0 and <= 1000. Unit: percent. |
years |
decimal (string) | Time in years (for example 0.5). Use this or the two dates. Allowed: >= 0 and <= 1000. Unit: years. |
start_date |
date (YYYY-MM-DD) | First day of the interest period (YYYY-MM-DD). |
end_date |
date (YYYY-MM-DD) | Day the interest period ends (YYYY-MM-DD); interest accrues up to but not including this day. |
day_count |
actual/365 | actual/360 | actual/actual | 30/360 | 30e/360 default actual/365 |
Day-count convention used with dates. Options: actual/365: Actual/365 Fixed: actual days ÷ 365.; actual/360: Actual/360: actual days ÷ 360.; actual/actual: Actual/Actual (ISDA): days in each calendar year ÷ that year's length (365 or 366), summed.; 30/360: 30/360 Bond Basis: months of 30 days, years of 360; D1=31→30, and D2=31→30 when D1 is 30 or 31.; 30e/360: 30E/360 Eurobond Basis: months of 30 days, years of 360; any 31st becomes the 30th. |
options.rounding |
half_even | half_up | half_down | up | down | ceiling | floor | Rounding mode applied once to each result. Default half_even. |
options.decimals |
integer | Round results to this many digits after the decimal point. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
interest | decimal (string) | Interest for the period. Unit: currency. |
total_amount | decimal (string) | Principal plus interest. Unit: currency. |
days | integer | Days counted under the convention (dates only). |
year_fraction | string | The exact year fraction t used, as a decimal or a fraction such as 181/365. |
Examples
10,000 at 5% for 2 years
curl https://api.curatedapi.com/v1/calc/finance/simple-interest \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"principal": "10000",
"annual_rate_percent": "5",
"years": "2"
}'
{
"calculator": "finance/simple-interest@1",
"result": {
"interest": "1000.00",
"total_amount": "11000.00",
"year_fraction": "2"
},
"exactness": {
"interest": "exact",
"total_amount": "exact"
},
"precision": {
"rounding": "half_even",
"decimals": 2
},
"inputs": {
"principal": "10000",
"annual_rate_percent": "5",
"years": "2",
"day_count": "actual/365"
},
"formula": "I = P × r × t; total = P + I",
"references": [
{
"title": "2006 ISDA Definitions, Section 4.16: Day Count Fraction (ISDA blackline)",
"url": "https://www.isda.org/a/smMDE/Blackline-2000-v-2006-ISDA-Definitions.pdf"
},
{
"title": "OpenGamma Strata day count documentation (worked 30/360 examples)",
"url": "https://strata.opengamma.io/apidocs/com/opengamma/strata/basics/date/DayCounts.html"
}
],
"warnings": []
}
1,000,000 at 4% Actual/360 for a quarter
curl https://api.curatedapi.com/v1/calc/finance/simple-interest \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"principal": "1000000",
"annual_rate_percent": "4",
"start_date": "2026-01-01",
"end_date": "2026-04-01",
"day_count": "actual/360"
}'
{
"calculator": "finance/simple-interest@1",
"result": {
"interest": "10000.00",
"total_amount": "1010000.00",
"days": 90,
"year_fraction": "0.25"
},
"exactness": {
"interest": "exact",
"total_amount": "exact"
},
"precision": {
"rounding": "half_even",
"decimals": 2
},
"inputs": {
"principal": "1000000",
"annual_rate_percent": "4",
"start_date": "2026-01-01",
"end_date": "2026-04-01",
"day_count": "actual/360"
},
"formula": "I = P × r × t; total = P + I",
"references": [
{
"title": "2006 ISDA Definitions, Section 4.16: Day Count Fraction (ISDA blackline)",
"url": "https://www.isda.org/a/smMDE/Blackline-2000-v-2006-ISDA-Definitions.pdf"
},
{
"title": "OpenGamma Strata day count documentation (worked 30/360 examples)",
"url": "https://strata.opengamma.io/apidocs/com/opengamma/strata/basics/date/DayCounts.html"
}
],
"warnings": []
}
References
- 2006 ISDA Definitions, Section 4.16: Day Count Fraction (ISDA blackline)
- OpenGamma Strata day count documentation (worked 30/360 examples)
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.