> For the complete documentation index, see [llms.txt](https://docs.dozer.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dozer.finance/user-guides/staking-tokens.md).

# Staking Tokens

This guide shows how to stake project tokens on Dozer Tools to earn a share of the project's reward pool.

## What You Need

* A **Hathor wallet** with Reown / WalletConnect support
* A **balance of the token** you want to stake (held in your connected wallet)
* A small amount of **HTR** for transaction fees

## How Staking Works

A project creator allocates a portion of their token supply as **Staking Rewards**, distributed over a fixed pool duration. Anyone holding the token can stake and receive a daily share of those rewards proportional to their stake.

Each pool has:

* A **minimum** and **maximum** stake amount
* A **timelock period** (typically 30 days) — staked tokens cannot be withdrawn until it elapses
* An **APY** that updates as more (or fewer) tokens stake
* A **rewards reserve** that the project can top up to extend the pool's lifetime

## Step 1 — Open the Staking Page

Three ways:

* **Explore → Staking** in the top nav — lists all active pools.
* **Token page → Staking card** — opens the pool for that token.
* **Direct URL** — `/staking/<token-id>`.

<img src="/files/B1gMAIMa04xjGfnRwama" alt="Public staking page with Pool Statistics, Stake, and Unstake forms" width="700">

The page is a 3-column layout.

### Left column — Pool stats + your position

* **Pool Statistics** — APY, Total Staked across all users, Daily Rewards distributed, Rewards Last (days remaining)
* **My Position** — your stake, pending rewards, lock status. Empty until you stake.

### Center column — Stake Tokens

* Amount input with **Min / Max** labels showing the per-pool limits
* Available balance from your wallet
* **Staking Requirements** panel summarises minimum, maximum, timelock, and auto-compounding

### Right column — Unstake Tokens

* Amount input with a **Max** quick-fill
* **Withdrawal Breakdown** — your staked deposits and the maximum you can withdraw right now
* **Important** panel with the unstaking rules

## Step 2 — Stake

1. Connect your wallet.
2. In **Stake Tokens**, enter an amount (within Min/Max).
3. Click **Stake Tokens**, approve in wallet, enter PIN.

After confirmation:

* The **My Position** card updates with your stake.
* Pending rewards start accruing daily.
* Your **30-day timelock countdown** begins.

## Step 3 — Watch Rewards Accrue

Rewards are distributed daily. Your share = `your stake / Total Staked × Daily Rewards`.

The My Position card shows your **pending rewards** in real-time. They are **auto-compounded** — every time you stake more or unstake, accrued rewards are claimed and added to / sent with your transaction.

## Step 4 — Unstake

Once the timelock has elapsed (default 30 days from your latest stake):

1. Enter the amount in **Unstake Tokens** — or click **Max** for a full exit.
2. Click **Unstake Tokens**, approve in wallet.
3. Your principal **plus accrued rewards** lands in your wallet.

> ⚠️ **Partial unstakes restart the timelock** on the remaining balance. To avoid resetting your timer, withdraw the full **Max** amount in one transaction.

## Best Practices

* **Plan around the timelock** — don't stake tokens you'll need within the lock period.
* **Compare APYs** — but factor in the project's risk, not just the rate. A 1000% APY on an inactive token isn't a deal.
* **Watch the Rewards Last counter** — if a pool's reserve drops below 30 days, APY may collapse soon unless the project tops it up.
* **Don't dust-unstake** — pulling 1% to "test" still resets the 30-day clock on the other 99%.

## Troubleshooting

| Symptom                            | Fix                                                                                                            |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Staking page shows "Not Available" | You hold 0 of the token. Buy some via a [token sale](/user-guides/participating-in-token-sale.md) or DEX first |
| Stake button disabled              | Amount is below Min, above Max, or above your wallet balance                                                   |
| Unstake button disabled            | Timelock hasn't elapsed since your last stake                                                                  |
| APY is 0%                          | The pool has no rewards left, or no one has staked yet                                                         |
| Pending rewards stuck at 0         | Wait at least one day after your first stake for the first cycle                                               |

## Related

* [Wallet Setup](/user-guides/wallet-setup.md) — install and connect a Hathor wallet
* [Participating in a Token Sale](/user-guides/participating-in-token-sale.md) — get tokens to stake
* [Claiming Vested Tokens](/user-guides/claiming-vested-tokens.md) — for beneficiaries with vesting allocations


---

# 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:

```
GET https://docs.dozer.finance/user-guides/staking-tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
