---
title: "Staking rewards calculator"
method: GET
path: "/api/v1/calculators/staking"
tags: ["Calculators"]
---

# Staking rewards calculator

`GET /api/v1/calculators/staking`

Pure math — staking rewards with optional compounding and a validator
commission. No market data is read.

## Query parameters

- `amount` number, required — Amount staked, in the staked asset's units.
- `period` number, required — Length of the staking period (capped at the 50-year equivalent).
- `period_unit` string, nullable — `years` (default), `months` or `days`.
- `apy` number, required — Advertised APY in %.
- `compound_frequency` string, nullable — `never`, `daily`, `weekly`, `monthly` (default) or `yearly`.
- `commission` number, nullable — Validator commission in %, taken from rewards (default 0).

## Response `200`

- object
  - `data` object
    - `final_balance` number
    - `total_rewards` number
    - `yearly_reward` number
    - `monthly_reward` number
    - `roi` number
    - `risk_level` string

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)
