> For the complete documentation index, see [llms.txt](https://docs.cronos-pos.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cronos-pos.org/cronos-pos-chain-protocol/module_overview/module_tieredrewards.md).

# module\_tieredrewards

#### `tier_rewards` module

#### Introduction

Manages tiered staking positions with bonus APY on top of base staking rewards. Introduced in v7.0.0, CRO holders can lock their stake for a defined exit commitment period (1/2/4 years) in exchange for bonus APY (up to +7%). 

The module also maintains a base reward floor (\~3% APY) by topping up shortfalls from the Tier Rewards Pool.

#### How tiered staking mechanism works

Kindly go [here](/cronos-pos-chain-protocol/tiered-staking.md) for the details.

#### Transactions and Queries

**Transactions:**

| Transaction                 | Description                                            |
| --------------------------- | ------------------------------------------------------ |
| `lock-tier`                 | Lock fresh CRO into a tier and delegate to a validator |
| `commit-delegation-to-tier` | Convert existing delegation into a tier position       |
| `add-to-tier-position`      | Add tokens to an existing position                     |
| `tier-redelegate`           | Move position to a different validator                 |
| `claim-tier-rewards`        | Claim pending base + bonus rewards                     |
| `trigger-exit`              | Start exit commitment countdown                        |
| `clear-position`            | Cancel a triggered exit                                |
| `exit-tier-with-delegation` | Instant exit (no unbonding)                            |
| `tier-undelegate`           | Start standard 28-day unbonding                        |
| `withdraw-from-tier`        | Withdraw tokens after unbonding                        |

**Queries:**

| Query                       | Description                                 |
| --------------------------- | ------------------------------------------- |
| `tiers`                     | All tier definitions                        |
| `params`                    | Module parameters (`TargetBaseRewardsRate`) |
| `position`                  | Single position by ID                       |
| `positions-by-owner`        | All positions for an address                |
| `estimate-position-rewards` | Estimated pending rewards                   |
| `rewards-pool-balance`      | Current rewards pool balance                |
| `voting-power`              | Governance voting power from tier positions |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cronos-pos.org/cronos-pos-chain-protocol/module_overview/module_tieredrewards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.