> For the complete documentation index, see [llms.txt](https://tg-token-gates.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tg-token-gates.gitbook.io/docs/wallets/wallet-overview.md).

# Wallet Overview

Manage your verified wallets and see your portfolio in one place. Use \*\*\`/wallets\`\*\* in a \*\*private message\*\* to the bot (not in a group).

#### Accessing Wallet Settings <a href="#accessing-wallet-settings" id="accessing-wallet-settings"></a>

1. Open a **private chat** with the bot.
2. Send **`/wallets`**.

You’ll see a **reply keyboard** with four options:

<figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FjDA8VFCMu318sQDVE1mG%2Fimage.png?alt=media&amp;token=951f3fe6-8221-455a-b8ee-ee2e83b4eb78" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th>Button</th><th width="374">What it does</th></tr></thead><tbody><tr><td><strong>Wallet Portfolio</strong></td><td>Same list with <strong>View Details</strong> for each wallet (expand/collapse full holdings).</td></tr><tr><td><strong>Verify Wallet</strong></td><td>Add a new wallet by verifying ownership (you send a small amount to yourself).</td></tr><tr><td><strong>Remove Wallet</strong></td><td>Remove a verified wallet from your account.</td></tr><tr><td><strong>Exit</strong></td><td>Leave wallet settings and remove the keyboard.</td></tr></tbody></table>

***

#### 👀 /Wallets <a href="#my-wallets" id="my-wallets"></a>

**/Wallets** shows a summary of all your verified wallets.

* **Net Worth** — Total USD value across all your verified wallets (Solana + EVM).
* **Per wallet** — Each wallet is listed by chain (e.g. Solana, EVM). You see:
  * Truncated address (e.g. `abc123...xyz9`)
  * A short summary: **$X,XXX.XX • N tokens** (or “Wallet verified” if portfolio data is still loading).

Wallets are grouped by chain (EVM chains like Base, Ethereum, BNB are grouped under “EVM”). Portfolio data is cached and may refresh in the background; if you see “Wallet verified” with no numbers yet, the bot may update it shortly.

***

#### 📊 Wallet Portfolio <a href="#wallet-portfolio" id="wallet-portfolio"></a>

**Wallet Portfolio** shows the same net worth and wallet list, but with **inline buttons** so you can drill into each wallet.

* At the top: **Net Worth** (total USD).
* Under that: each wallet with a **View Details (abc...xyz)** button.
* Tap **View Details** to **expand** that wallet and see its full holdings (tokens, amounts, USD value per chain or token).
* When expanded, tap **Collapse** (or the equivalent) to return to the summary list.
* Use **← Back to Wallets** to return to the main wallet panel message.

Use **Wallet Portfolio** when you want to see exactly what’s in a single wallet (e.g. which tokens, balances, and values).

***

#### ✅ Verify Wallet <a href="#verify-wallet" id="verify-wallet"></a>

Adding a new wallet is done by **verifying** that you control it. We never ask you to “connect wallet” in a browser. Instead, you **tell us your wallet address** and then **send a specific amount to yourself** (to that same address). That proves you own the wallet—and the funds never leave your control. Safer and more secure.

**How it works**

1. Tap **Verify Wallet**.
2. Choose the **blockchain** (Solana, Base, Ethereum, or BNB).
3. **Enter your wallet address.**
4. The bot tells you the **exact amount** to send to yourself(e.g. a small amount of SOL, ETH, or BNB)
5. Open your wallet app and send that amount **from your wallet to the same address** (a self-transfer).
6. Once we detect the transaction on-chain, we mark the wallet as **verified**. No refund is involved: the money stayed in your wallet the whole time.

Verified wallets are then used to check your balances for token gates and net worth gates. You can verify wallets on **Solana** and **EVM** chains (e.g. Base, Ethereum, BNB). Each wallet only needs to be verified once.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FLm3LLIw10PpVHwC0WOyo%2Fimage.png?alt=media&amp;token=c6973202-072b-4c21-80fc-a6887f406bca" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2F5NsLvLTQs1hH5vdrI7nG%2Fimage.png?alt=media&amp;token=f26e707d-4655-4e27-aae3-2ee7b13514e2" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2F9Fwrdr335TchBYnGoy3m%2Fimage.png?alt=media&amp;token=f333b382-5129-4872-8b63-38f667b53d2c" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FbcaJ768D0KdeAhrds3lm%2Fimage.png?alt=media&amp;token=dcb1c207-6791-478d-a037-40ce1465d0ab" alt=""><figcaption></figcaption></figure></div>

***

#### 🚫 Remove Wallet <a href="#remove-wallet" id="remove-wallet"></a>

If you no longer want a wallet linked to your account, you can remove it.

1. Tap **Remove Wallet**.
2. Choose the wallet to remove from the list (e.g. by tapping the wallet’s button).
3. Confirm removal. The wallet is unlinked from your Telegram account.

**Important:** Your verified wallets are used to decide whether you still meet gate requirements. If you remove a wallet, your **combined balance or net worth** may drop, and you might **no longer meet** a chat’s gate—which can lead to you being **purged** from that chat at the next check. Only remove wallets you’re sure you don’t need for access.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FxhZ5cR8esSvJkfYHLjZb%2Fimage.png?alt=media&amp;token=1c2014c2-88a9-4a97-9cc4-0e5187ac57e7" alt=""><figcaption></figcaption></figure></div>

***

#### Exit <a href="#exit" id="exit"></a>

Tap **Exit** to leave wallet settings. The bot clears the reply keyboard and may send a short confirmation. You can run **`/wallets`** again anytime to come back.

***

#### Quick reference <a href="#quick-reference" id="quick-reference"></a>

| Goal                             | Action                                                                     |
| -------------------------------- | -------------------------------------------------------------------------- |
| See net worth and wallet list    | **My Wallets**                                                             |
| See full holdings for one wallet | **Wallet Portfolio** → **View Details** on that wallet                     |
| Add a new wallet                 | **Verify Wallet** → choose chain → enter address → send amount to yourself |
| Unlink a wallet                  | **Remove Wallet** → choose wallet → confirm                                |
| Leave wallet settings            | **Exit**                                                                   |

***

Next: Gate Types for how token, payment, and net worth gates use your wallets, or The Purge for how verified wallets affect purge.