BOTLABPlatformFleetAuditStuckScanLearnLab News

Learn · 2026-11-14

How to Check Locked Tokens in a Wallet Address (Any Chain)

To check locked tokens in a wallet address, open the chain's block explorer, look up the address, and read the balance breakdown: most explorers show "available" separately from "locked", "reserved", "frozen", "staked" or "in escrow". If the explorer only shows a total, you then check the contracts the wallet has interacted with (staking, vesting, escrow) to see what holds the rest and when it unlocks.

This guide walks through that process chain by chain, explains the common lock types, and shows how to tell a normal lock from a genuinely stuck balance. You need nothing but the public address. You never need a seed phrase, a private key or a wallet connection to read a balance.

What "locked tokens" actually means

"Locked" is an umbrella word. On-chain it usually refers to one of these:

The first four leave a trace on the chain. The last one does not, which matters: if a balance is locked inside an exchange, a block explorer will never show it. Our earlier guide on staked vs locked vs stuck crypto goes deeper into the vocabulary.

How to check locked tokens in a wallet address, step by step

Step 1: Confirm which chain the address is on

The same address format can exist on several chains. An address starting with 0x works on Ethereum, Arbitrum, Base, Polygon, BNB Chain and many others, and each chain has its own balance. Check the chain the tokens were sent on. If you are not sure, a multi-chain explorer or a read-only scanner can query several chains at once.

Step 2: Open the official explorer and search the address

Use the explorer linked from the chain's official documentation. Common ones:

Paste the address and open the account page. Bookmark the explorer you use so you are not caught by a look-alike site later.

Step 3: Read the balance breakdown

This is where the lock becomes visible. What to look for differs by chain:

If the explorer shows a Locked or Reserved figure with a named reason and an end date, you have your answer. Note the date and confirm the rule in the chain's official docs, because unbonding periods change with governance votes.

Step 4: Find the contracts holding the rest

On EVM chains and for most DeFi positions, the tokens are not in your address at all. They sit inside a contract that records a claim for you. To find them:

  1. Open the address page and switch to the token transfers or transactions tab.
  2. Look for outgoing transfers to a contract you did not expect, especially ones labelled staking, vesting, escrow, lock, vault or pool.
  3. Click the contract address, then open the "Read Contract" tab on Etherscan-style explorers.
  4. Look for read functions named like locked, lockedBalanceOf, vestingSchedule, releasable, claimable or unlockTime. Paste your address as the input and query.

Vesting platforms such as Sablier or Hedgey, and vote-escrow tokens such as veCRV, all expose these reads. The exact names vary per contract, so if you are unsure, check the project's docs for "how to view my vesting".

Step 5: Separate "locked" from "ready to claim"

Many locks have two phases. First the tokens are locked until a date. Then they become claimable, but they still do not move until you send a claim transaction. Explorers rarely highlight this difference. A finished Polkadot unbonding still needs a withdrawUnbonded call. A finished XRP escrow still needs an EscrowFinish transaction. We covered both in Polkadot unbonding: how to withdraw and XRP escrow past its unlock time.

So when you find a lock, ask two questions: has the unlock date passed, and is there a claim or withdraw step I have not done yet?

A worked example (illustration only)

The numbers below are made up to show the method. They are not BOTLAB results and not from any real wallet.

Suppose a wallet address on Ethereum shows a token balance of 400 PRJ, but the holder bought 1,000 PRJ in a sale. Where are the other 600?

  1. The token transfers tab shows a 350 PRJ transfer to a contract called "PRJ Vesting" six months ago, and a 250 PRJ transfer to "PRJ Staking" three months ago.
  2. Reading the vesting contract with the wallet address as input returns a 12-month linear schedule: 350 total, 175 already released, 175 still locked. Of the 175 released, 150 are "releasable" because the holder claimed only 25 so far.
  3. Reading the staking contract shows 250 PRJ staked with a 7-day cooldown after unstaking. The holder has not unstaked, so nothing is pending.

The picture is now clear:

WhereAmountStatus
Wallet400Free
Vesting contract150Released, claim needed
Vesting contract175Locked until schedule ends
Staking contract250Staked, 7-day cooldown if unstaked

Nothing here is stuck. The only action available right now is a claim of 150 PRJ from the vesting contract. All numbers above are illustrative.

When a locked balance might actually be stuck

Normal staking, unbonding, vesting and escrow are not stuck. A balance deserves a closer look when:

Even in these cases, the tokens are usually still visible on-chain and the path forward is a direct contract call or a support ticket with the project. Avoid anyone who says they can recover the tokens for a fee or who asks for your seed phrase. Reading and claiming never requires that, and legitimate projects do not charge to release your own funds.

A quick way to do steps 1 to 5 across chains at once is a read-only scanner. Scan a wallet free with StuckScan: 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, across 20 chains, with no wallet connection and no sign-up. It does not yet check bridges, most DeFi except Aave v3, or Solana stake accounts on the web page, so for those positions use the explorer steps above.

Common mistakes when checking locked tokens

If you want a broader map of where staked assets can hide, see how to find where my staked crypto is.

BOTLAB also publishes paper-trading results of crypto bots on /platform. Those results are simulated and are unrelated to wallet checks. Crypto trading can lose money, including all capital.

FAQ

Can I check locked tokens without connecting my wallet?

Yes. Every step above uses only the public address and a block explorer. Reading balances, lock reasons and vesting schedules never needs a signature, a private key or a seed phrase.

Why does the explorer show fewer tokens than I own?

Most likely some tokens are held by a contract (staking, vesting, escrow, liquidity pool) rather than by your address. Check the token transfer history for outgoing transfers to contracts and read those contracts with your address as input.

The unlock date has passed. Why are the tokens still not in my wallet?

Many locks need a separate claim or withdraw transaction after the date passes. Look for a claim, release, withdraw or finish function on the contract or in the project's app, and confirm the exact step in the official docs.

Does "locked" mean the tokens are lost?

No. Locked means a rule is holding them for a period or until an action. If the lock has ended and a claim still fails, contact the project through its official channels. Never pay a third party who promises recovery, and never share a seed phrase.

Key takeaways

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