---
title: "Staking Rewards Calculator"
canonical_url: "https://nimiq.dev/nimiq-utils/staking-rewards-calculator"
---
# Staking Rewards Calculator

Calculates potential wealth accumulation through staking with reward decay, compounding, and fees.

## Usage

### Basic calculation

```typescript
import { calculateStakingRewards } from '@nimiq/utils/rewards-calculator'

// Basic calculation
const result = calculateStakingRewards({
  amount: 100000, // 100k NIM
  days: 365, // 1 year
  stakedSupplyRatio: 0.5, // 50% of supply staked
  autoRestake: true // Compound rewards
})
console.log(result.totalReward) // Total rewards earned
console.log(result.finalBalance) // Final balance including rewards
```

### With custom fee

```typescript
// With custom fee
const withFee = calculateStakingRewards({
  amount: 50000,
  days: 180,
  stakedSupplyRatio: 0.6,
  fee: 0.05, // 5% validator fee
  autoRestake: false
})
```

## API

<table>
<thead>
  <tr>
    <th>
      Method
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        calculateStakingRewards(params)
      </code>
    </td>
    
    <td>
      Calculates staking rewards for given parameters
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        StakingParams
      </code>
    </td>
    
    <td>
      Input parameters: amount, days, stakedSupplyRatio, etc.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        StakingResult
      </code>
    </td>
    
    <td>
      Result object with totalReward, finalBalance, etc.
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://nimiq.dev/sitemap.md) for all pages.