Skip to content

Calculating Deposit Interest

Calculates deposit interest accounting for capitalization, top-ups, and partial withdrawals. Lets you calculate deposit yield based on various parameters.

URL

Method: POST

  • Production: https://registry.wallet.kvell.group/reg2/billing/deposit/interest

Request parameters

Name Type Required Description
amount number Yes Deposit amount
rate number Yes Interest rate
days integer No Number of days
months integer No Number of months
startDate date No Deposit start date in YYYY-MM-DD format
endDate date No Deposit end date in YYYY-MM-DD format
topUps array No Top-ups (array of {date, amount})

Example request

{
  "amount": 100000,
  "rate": 2.5,
  "days": 180,
  "months": 12,
  "startDate": "2026-01-01",
  "endDate": "2027-01-01",
  "topUps": [
    {
      "date": "2026-03-01",
      "amount": 1000
    }
  ]
}

Request headers

Name Type Required Description
X-Api-Key string Yes Unique identifier (UUID)

Response

Example response

{
  "simpleInterest": 100,
  "compoundInterest": 100,
  "dailyInterest": 20,
  "topUpInterest": 20,
  "days": 180,
  "months": 12,
  "amount": 100000,
  "rate": 2.5
}

Response parameters

Name Type Description
simpleInterest number Simple interest (without capitalization)
compoundInterest number Compound interest (monthly capitalization)
dailyInterest number Bank variant: daily accrual
topUpInterest number Deposit with top-ups (monthly)
days integer Number of days
months integer Number of months
amount number Deposit amount
rate number Interest rate