Learn · 2026-11-05

Cosmos ATOM unbonding period: what happens after 21 days?

If you are asking about the Cosmos ATOM unbonding period and what happens after 21 days, the short answer is that the chain moves your tokens back to your available balance automatically. On the Cosmos Hub, there is normally no separate claim or withdraw step.

If the time has passed and your balance looks wrong, there is usually a checkable reason. This guide shows how to find your exact completion time, confirm what happened on-chain, and work through the common causes.

Cosmos ATOM unbonding period: what happens after 21 days

When you undelegate ATOM, the tokens enter an unbonding state. They stop earning staking rewards, and you cannot transfer them yet.

The Cosmos Hub's unbonding period has long been set at 21 days, but it is a chain parameter that governance can change. You can confirm the current value in the official Cosmos Hub docs or by querying the chain.

When the period ends, this happens:

The release is automatic. The chain completes the unbonding entry at the first block at or after the completion time.
The tokens become available. They appear in the available balance of the same address that delegated them.
You do not pay a claim fee. You will need a small amount of ATOM for gas only when you later send or stake the tokens.
The tokens do not restake themselves. They stay in your wallet, earning no staking rewards, until you decide what to do with them.

This differs from some other chains, such as TRX, where you still need to withdraw after unstaking. Rules vary by chain, so avoid assuming that one chain's steps apply to another.

How to check your ATOM unbonding status

Start with the on-chain record, because wallet screens can lag or label things differently.

Option 1: use a wallet or block explorer

Copy your public address, which starts with cosmos1. Never enter a seed phrase to look it up.
Open your wallet's staking page or a Cosmos Hub block explorer.
Look for a section labelled "unbonding", "undelegating" or similar.
Note the completion time and its time zone. Explorers often show UTC.
Compare the available balance with the staked and unbonding amounts.

If no unbonding entry remains and your available balance has risen, the process has finished.

Option 2: use the command line

If you run the official gaiad client, these read-only queries show the same data:

`` gaiad query staking unbonding-delegations <your-cosmos1-address> gaiad query bank balances <your-cosmos1-address> gaiad query staking delegations <your-cosmos1-address> gaiad query staking params ``

Balances are shown in uatom, and 1 ATOM equals 1,000,000 uatom. The params query shows unbonding_time in seconds, and 21 days equals 1814400s. Command names can change between software versions, so check the current docs if one fails.

Illustration: reading the timeline

These numbers are made up to show how the balance changes. They are not BOTLAB results or real account data.

Suppose a wallet has 120 ATOM staked with one validator, 2.5 ATOM available and 0.4 ATOM in pending rewards.

| Moment | Staked | Unbonding | Available | |---|---|---|---| | Before 3 March, 14:00 UTC | 120 | 0 | 2.50 | | Undelegate 100 ATOM, gas fee 0.01 ATOM | 20 | 100 | 2.89 | | After 24 March, 14:00 UTC | 20 | 0 | 102.89 |

The available balance rises by 0.39 ATOM at the start because the pending rewards of 0.4 ATOM are paid out, less the 0.01 ATOM fee. Undelegating normally pays out pending rewards from that validator. Rewards earned by the remaining 20 ATOM are ignored here to keep the example simple.

The 100 ATOM returns without any further transaction. To check this on your own account, compare the available balance before and after the completion time.

Why your ATOM may not show after 21 days

Normal unbonding is not stuck. If the date has passed and the balance still looks wrong, check these causes in order.

The clock started later than you think

The 21 days begin when the undelegate transaction is included in a block, not when you first thought about unstaking or opened the wallet. Use the completion time shown on-chain rather than counting days yourself.

The undelegate transaction failed

A transaction can be submitted and still fail. Look up its hash in an explorer, or run gaiad query tx <hash>. A result code of 0 means success. If it failed, your tokens are still staked, and you would need to submit the undelegation again.

You redelegated instead of undelegating

Redelegating moves your stake to another validator and keeps it staked, so nothing returns to your available balance. Check the delegations query. If the tokens appear under a different validator, they were moved rather than unbonded.

You started more than one unbonding

Each undelegation has its own completion time. If you undelegated several times, the amounts come back in separate parts. Check every entry in the list, not only the first.

Your wallet is showing the wrong view

Check that:

The wallet is on the Cosmos Hub network, not another chain in the Cosmos ecosystem.
You are viewing the same account that delegated, as wallets can hold several accounts.
The screen is not showing old data. Refresh it, or compare with an explorer.

If an explorer shows the correct balance, the funds are in place on-chain and the problem is in the display.

You staked through an exchange or liquid staking service

The on-chain process above applies when you control the address. Exchanges and liquid staking services set their own rules and timing, so you may be waiting on the provider's process rather than the chain's. Their support pages and terms apply. Use only the support links on their official site.

The amount is lower than you expected

There are three usual explanations:

Rewards: they are paid separately, so they may not be part of the amount you are tracking. See why unclaimed ATOM rewards do not arrive automatically.
Slashing: unbonding tokens can be reduced if the validator is penalised for an infraction committed before you started unbonding.
Vesting: tokens under a vesting schedule can follow additional rules on when they can be transferred.

What you can do during the 21 days

You have fewer options while tokens are unbonding, but you are not limited to waiting:

Check the date: the completion time is public and can be checked at any time.
Cancel the unbonding: the Cosmos SDK includes a cancel-unbonding transaction that returns tokens to the same validator. Wallet support varies, so check the current docs first.
Keep some ATOM for gas: you will need a small amount available to send the tokens after release.
Plan around the limit: the chain caps simultaneous unbonding entries for each delegator and validator pair, shown as max_entries in the staking parameters. If you hit the cap, you must wait for an entry to finish.

Stay safe from recovery scams

People searching for "missing" staked tokens are a common scam target. Fake support accounts often reply to public questions on social media and in chat groups.

Nobody legitimate will ask for your seed phrase or private key.
Nobody legitimate needs an upfront fee to "release" or "recover" unbonding ATOM.
Be wary of links sent by direct message, especially "validate your wallet" sites.
Checking your status only requires your public address, and it does not require a wallet connection or a signature.

If someone pressures you to act quickly, stop and check the chain data yourself.

Check the wallet with a read-only tool

If you want one view of what an address holds, Scan a wallet free. StuckScan covers 20 chains. You paste a public address, and it shows what is in the wallet, staked, locked, pending, possibly stuck or ready to claim, with on-chain proof and what to do next.

It needs no wallet connection or signing, and it never asks for a seed phrase. It does not check bridges or most DeFi yet, apart from Aave v3, so treat it as a starting point rather than full coverage.

About BOTLAB

BOTLAB is a research lab that publishes paper-trading results for crypto bots on the platform. Paper results are simulated, using simulated money and real market prices. Crypto trading can lose money, including all capital.

FAQ

Do I need to claim my ATOM after the 21 days?

Normally, no. On the Cosmos Hub, the chain returns the tokens to your available balance automatically when the unbonding entry completes. You can confirm this by checking that the entry has gone and your balance has risen.

Do I earn rewards during the unbonding period?

No. Tokens stop earning staking rewards once unbonding starts. Any tokens you leave staked continue to earn rewards as normal, subject to validator performance and commission.

Can I send ATOM while it is unbonding?

No. Unbonding tokens cannot be transferred until the completion time has passed. After that, you can send them like any other available balance, as long as you have enough ATOM for gas.

Is my ATOM stuck if it is still unbonding?

Not if the completion time is still in the future, because that is the normal process. If the time has passed and no tokens have appeared, check the transaction result, your delegations, the network and the account you are viewing.

Key takeaways

On the Cosmos Hub, ATOM returns to your available balance automatically when unbonding completes.
Use the on-chain completion time rather than your own count of days.
A failed transaction, a redelegation or the wrong wallet view can each explain a missing balance.
Rewards are separate from unbonded principal, and slashing or vesting can affect amounts.
Nobody legitimate asks for a seed phrase or a recovery fee.

General information, not financial advice. Check the official docs before you move funds.

Want these checks run on your own strategy? See the strategy and backtest audit.

More guides

Not sure where your crypto is? Paste a public address and see what is staked, locked, pending or ready to claim on 20 chains. Free and read-only, with no wallet connection.
Scan a wallet free