curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

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

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).

InputTypeDescription
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.

ResultTypeDescription
interestdecimal (string)Interest for the period. Unit: currency.
total_amountdecimal (string)Principal plus interest. Unit: currency.
daysintegerDays counted under the convention (dates only).
year_fractionstringThe exact year fraction t used, as a decimal or a fraction such as 181/365.

Examples

10,000 at 5% for 2 years

Requestcurl
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"
  }'
200 OKResponse
{
  "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

Requestcurl
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"
  }'
200 OKResponse
{
  "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

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.