Troubleshooting

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.
• 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.