# Troubleshooting

> Common symptoms and how to resolve them — stuck onboarding, stale refreshes, missing tokens, silent alerts.

Most issues with **Wallet Bot** come down to a handful of patterns. Work through the symptoms below in order — each one ends with the single action most likely to fix it.

## My Portfolio Is Stuck on "Computing PnL"

The first time a wallet is added, *cost-basis PnL* is computed from the full trade history. For very active wallets this can take up to a minute. Tap **🔄 Refresh** on the onboarding panel after a minute — if it still is not ready, wait another 30 seconds and try once more.

You can also tap **👁 View without PnL** to open the portfolio immediately; the PnL columns fill in automatically on the next successful refresh.

## Refresh Says "Please Wait"

Each portfolio can be refreshed at most once every **60 seconds**. Between refreshes the bot serves a cached snapshot, which is at most a minute old. Wait out the cooldown shown in the message — the data on screen is already current.

## A Token I Own Is Missing From the List

Several reasons this happens, in order of likelihood:

- **It is below the dust threshold.** Positions worth less than **$0.10** are filtered out by default. Pin the token manually to force it back in — see [Pinning and Hiding Tokens](/docs/wallet/pinning-and-hiding-tokens).
- **You hid it earlier.** Open **🚫 Hidden (n)** from the balance screen and un-hide it.
- **The wallet holds more than 200 tokens.** Only the top 200 by USD value are shown. Pin the tokens you care about.
- **The token is brand new.** Some tokens take a few minutes to appear in the data provider. Refresh again in a couple of minutes.

## PnL Shows `$0` or "No Data Yet"

*Cost-basis PnL* needs a full trade history for the token. For very new tokens, or wallets with unusual transaction patterns, the data provider may not have returned a PnL breakdown yet. The `+$0.00` or blank figure is a placeholder that fills in once the data is available — refresh again after a minute.

If you tap **⊘ Zero PnL** on a token with no data yet, the bot replies with a short *"no PnL data yet"* toast and does not set an anchor. Refresh the portfolio, wait a moment, and try again.

## My Price Alert Did Not Fire

Alerts fire only on a **net move past the threshold** from the *anchor price*. Common reasons an alert seems "missed":

- The price went up and came back down within the same window — there was no net move past the threshold.
- The alert was **📈 Up** only or **📉 Down** only, and the move went in the other direction. Use **↕️ Both** if you want symmetric notifications.
- You hit the per-user alert cap at set-time, and the alert was refused. Open the alerts list and check whether it is actually there.

## A Display Change Did Not Take Effect

Display preferences apply on the **next render** of the balance screen. Tap **Refresh** or close and re-open the balance screen, and the change will appear. If it still does not, wait for the 60-second cooldown to expire and refresh once more.

## The Bot Did Not Respond

- Make sure the input is a command (starts with **`/`**) or a button tap — the bot does not respond to free-text messages outside of its setup flows.
- If the bot was briefly offline, send **`/start`** again once it is back. Your portfolios, alerts, pins, and preferences are all persisted; only the in-progress dialog is reset.

## Something Else Is Wrong

Send **`/start`** to reset the conversation. Nothing you have set up is lost — only the current dialog state resets. If a problem reproduces after that, try removing and re-adding the portfolio; the wallet itself is unaffected on-chain.