# APY

sMON APY historical data

## Get sMON APY History

> Returns historical APY (Annual Percentage Yield) data for Kintsu's sMON token.\
> \
> APY is calculated daily based on staking ratio changes. Data is sorted newest first.<br>

```json
{"openapi":"3.0.3","info":{"title":"Kintsu Public API","version":"1.0.0"},"tags":[{"name":"APY","description":"sMON APY historical data"}],"servers":[{"url":"https://kintsu.xyz","description":"Production API server"}],"paths":{"/api/public/apy":{"get":{"summary":"Get sMON APY History","description":"Returns historical APY (Annual Percentage Yield) data for Kintsu's sMON token.\n\nAPY is calculated daily based on staking ratio changes. Data is sorted newest first.\n","operationId":"getApyHistory","tags":["APY"],"parameters":[{"name":"days","in":"query","description":"Number of days of historical APY data to return","required":false,"schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date in YYYY-MM-DD format"},"apy":{"type":"number","description":"APY as a decimal (e.g., 0.1254 = 12.54%)"},"apyFormatted":{"type":"string","description":"APY formatted as a percentage string"}}}},"meta":{"type":"object","properties":{"total":{"type":"integer","description":"Number of days of data returned"},"days":{"type":"integer","description":"Number of days requested"},"latestApy":{"type":"string","description":"Most recent APY value (formatted)"},"chainId":{"type":"integer","description":"Chain ID (always 143 - Monad Mainnet)"}}}}}}}},"404":{"description":"Insufficient data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Request limit per window","schema":{"type":"string"}},"X-RateLimit-Window":{"description":"Time window for rate limit","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"message":{"type":"string","description":"Additional error details"}},"required":["error"]}}}}
```