GET
/
investment
/
interest-rate
curl --request GET \
  --url https://api.magebank.ai/investment/interest-rate \
  --header 'x-api-key: <x-api-key>'
{
  "interestRate": 4.50,
  "lastUpdated": "2025-05-04T12:00:00Z"
}

Yield Information: Retrieve the current interest rate used for all savings calculations in the platform.

Request Headers

x-api-key
string
required

Your API key for authentication

Response

interestRate
number

Current annual interest rate for investments (percentage)

lastUpdated
string

Timestamp when the interest rate was last updated

{
  "interestRate": 4.50,
  "lastUpdated": "2025-05-04T12:00:00Z"
}

Status Codes

Status CodeDescription
200Interest rate retrieved successfully
401Unauthorized - Invalid or missing API key
500Internal Server Error

Annual Percentage Yield: The interest rate is expressed as an annual percentage yield (APY), which may change over time based on market conditions.

Rate Changes: When new investments are created, the current interest rate at that time is recorded and applied to that investment.