Get APY

Returns the USD* Annual Percentage Yield (APY). APY is calculated using the specified end time as the reference point and looking back by the given period duration to compute the annualized return.

GET /api/usdstar/apy

---

Get APY

get

Returns the USD* Annual Percentage Yield (APY).

APY is calculated using the specified end time as the reference point and looking back by the given period duration to compute the annualized return.

Query parameters

periodstring · enumOptional

Calculation window. Default: 7d

Default: 7dExample: 7dPossible values:

timestringOptional

End point for the APY calculation. ISO 8601 timestamp. Defaults to current time.

Example: 2025-10-06T00:00:00Z

Responses

200

Successful response

application/json

400

Invalid parameter

application/json

get

/api/usdstar/apy

HTTPcURLJavaScriptPython

GET /api/usdstar/apy HTTP/1.1
Host: api.perena.org
Accept: */*

{
  "period": "7d",
  "apy": 8.93,
  "timestamp": "2026-03-17T08:14:52.887Z"
}