# Welcome to Solmate!

Solmate is your all-in-one Solana toolkit — available as a Discord bot, Telegram bot, and web dashboard. Track wallets, verify holders, monitor collections, and much more.

## What is Solmate?

Solmate brings the Solana blockchain to your community. Whether you run a Discord server, a Telegram group, or just want a powerful dashboard — Solmate has you covered.

### Available on

* **Discord Bot** — Full-featured bot for your Discord server
* **Telegram Bot** — Real-time wallet tracking right in Telegram
* **Web Dashboard** — Manage everything from [solmatebot.com](https://solmatebot.com)

***

## Core Features

### Wallet Tracker

Track any Solana wallet and get instant notifications for swaps, transfers, token creation, burns, and more. Supports nametags, labels, and PNL tracking.

{% content-ref url="/pages/NDqFMwRlPsGvrv8kS3oM" %}
[Wallet Tracker](/discord-bot-features/wallet-tracker)
{% endcontent-ref %}

### Holder Verification

Let your community members verify their wallets and automatically receive roles based on NFT or token holdings.

{% content-ref url="/pages/RGN17f5bhRIcdlreRROX" %}
[Holder Verification](/discord-bot-features/holder-verification)
{% endcontent-ref %}

### Server Stats (Counters)

Display live data in voice channels — SOL price, collection floors, token prices, wallet balances, and more.

{% content-ref url="/pages/72PYPpEZlUybSDilpQIh" %}
[Server Stats (Counters)](/discord-bot-features/server-stats)
{% endcontent-ref %}

### Collection Tracker

Get notified when NFTs in a collection are listed, sold, or delisted on Magic Eden.

{% content-ref url="/pages/nXxQYkUB3AI5Ke0kP01T" %}
[Collection Tracker](/discord-bot-features/collection-tracker)
{% endcontent-ref %}

### Snapshots

Take a snapshot of any NFT collection or token's holders. Export the data as JSON, TXT, or CSV.

{% content-ref url="/pages/lnVZXElfiy1CY75tLRxE" %}
[Snapshots](/discord-bot-features/snapshots)
{% endcontent-ref %}

### Lookup Commands

Quickly get info on any token, collection, wallet, or the Solana blockchain itself — directly in Discord.

***

## Quick Links

| Resource           | Link                                                   |
| ------------------ | ------------------------------------------------------ |
| Invite Discord Bot | [solmatebot.com/invite](https://solmatebot.com/invite) |
| Web Dashboard      | [solmatebot.com/manage](https://solmatebot.com/manage) |
| Telegram Bot       | [@SolmateTelegramBot](https://t.me/SolmateTelegramBot) |
| Support Server     | [discord.gg/solmate](https://discord.gg/solmate)       |

***

## Image Gallery

<figure><img src="/files/o0nprdOqnNolFyPwdj5l" alt=""><figcaption><p>Wallet tracker in action</p></figcaption></figure>

<figure><img src="/files/eaMCnOqBAWXiMNSOrK4k" alt=""><figcaption><p>Holder verification panel</p></figcaption></figure>

<figure><img src="/files/IB4T6RkWWhbyyW6ixVBB" alt=""><figcaption><p>Collection info lookup</p></figcaption></figure>

<figure><img src="/files/Vg8zSkPBzXbY9ypV8pas" alt=""><figcaption><p>Server stats counters</p></figcaption></figure>

<figure><img src="/files/63qFdq69EueoobCHMlVh" alt=""><figcaption><p>Web dashboard</p></figcaption></figure>


# Changelog

Recent updates and improvements

## v1.6.0

* Telegram bot launch with real-time wallet tracking
* Full web dashboard redesign with new management features
* Bulk tracker operations (add, pause, resume, delete multiple)
* Drag-and-drop file import for adding trackers
* Labels system for organizing tracked wallets
* Live event feed on dashboard (coming soon)
* BNB/EVM chain support for wallet verification
* Verification analytics and history

## v1.5.1

* Renamed various commands for clarity

## v1.5.0

* Pinksale support
* Unlimited plan option
* Stability and speed improvements
* Show total % owned after buy
* [Web dashboard](https://solmatebot.com/) makeover
* Customizable tracker buttons
* PNL stats (counter, command, leaderboard)
* Burn and token creation transaction tracking
* Support for .sol domain names
* Transaction source button
* Visual bug fixes
* Token security information


# Invite the Bot

Get Solmate up and running in your Discord server in under a minute.

{% hint style="info" %}
**Free forever:** Solmate's core features are completely free. Premium plans are available to unlock higher limits and support development.
{% endhint %}

## Step 1: Open the invite link

Click the link below to invite Solmate to your server:

**Invite Solmate** — [solmatebot.com/invite](https://solmatebot.com/invite)

## Step 2: Select your server

1. Make sure you're logged in to Discord
2. Select the server you want to add Solmate to from the dropdown

<figure><img src="https://solmatebot.com/docs/placeholder-invite-select-server.png" alt=""><figcaption><p>Select your server from the dropdown</p></figcaption></figure>

3. Click **"Authorize"**

{% hint style="info" %}
**Permissions:** Solmate requests several permissions to function properly. Not all are strictly required, but permissions like **Manage Roles** are needed for holder verification and ticker roles, and **Manage Channels** is needed for stat counters.
{% endhint %}

## Step 3: Set up features

Once Solmate is in your server, you can start setting up features:

{% content-ref url="/pages/NDqFMwRlPsGvrv8kS3oM" %}
[Wallet Tracker](/discord-bot-features/wallet-tracker)
{% endcontent-ref %}

{% content-ref url="/pages/RGN17f5bhRIcdlreRROX" %}
[Holder Verification](/discord-bot-features/holder-verification)
{% endcontent-ref %}

{% content-ref url="/pages/72PYPpEZlUybSDilpQIh" %}
[Server Stats (Counters)](/discord-bot-features/server-stats)
{% endcontent-ref %}

{% content-ref url="/pages/nXxQYkUB3AI5Ke0kP01T" %}
[Collection Tracker](/discord-bot-features/collection-tracker)
{% endcontent-ref %}

Or manage everything from the web dashboard at [solmatebot.com/manage](https://solmatebot.com/manage).


# Using Slash Commands

New to Discord bots? Here's how commands work.

## What are slash commands?

Solmate uses Discord's built-in **slash commands**. This means you type `/` followed by the command name to interact with the bot.

## How to use them

### Step 1: Type `/`

Start by typing a forward slash (`/`) in any text channel. A menu will appear showing all available commands from bots in the server.

<figure><img src="https://solmatebot.com/docs/placeholder-slash-menu.png" alt=""><figcaption><p>The slash command menu appears when you type /</p></figcaption></figure>

### Step 2: Find the command

You can scroll through the list or start typing the command name to filter results. Look for commands with the Solmate icon.

<figure><img src="https://solmatebot.com/docs/placeholder-slash-typing.png" alt=""><figcaption><p>Type the command name to filter</p></figcaption></figure>

### Step 3: Fill in the options

Some commands have **required** and **optional** arguments. Required arguments are marked and must be filled in before you can run the command. Optional arguments can be left blank.

<figure><img src="https://solmatebot.com/docs/placeholder-slash-options.png" alt=""><figcaption><p>Fill in the command options</p></figcaption></figure>

### Step 4: Press Enter

Hit **Enter** to run the command. The bot will respond in the same channel.

## Tips

* You can use **Tab** to move between arguments
* Type the command name after `/` to quickly find it (e.g., `/tracker`)
* Some commands have **subcommands** — for example, `/tracker add`, `/tracker list`, `/tracker remove`
* If you don't see Solmate's commands, make sure the bot has permission to use slash commands in that channel


# Premium Plans

Unlock higher limits and support Solmate's development with a premium plan.

Solmate is free to use with generous limits. Premium plans increase those limits for power users and larger communities.

## Plans & Pricing

| Feature             | Free | Plus    | Pro     | Community |
| ------------------- | ---- | ------- | ------- | --------- |
| **Price (monthly)** | $0   | $15/mo  | $30/mo  | $50/mo    |
| **Price (yearly)**  | $0   | $150/yr | $300/yr | $500/yr   |
| Wallet Trackers     | 5    | 50      | 150     | 300       |
| Collection Trackers | 2    | 20      | 20      | 20        |
| Verification Roles  | 2    | 20      | 20      | 30        |
| Voice Counters      | 2    | 20      | 20      | 30        |
| Static Variables    | 1    | 10      | 10      | 10        |
| Snapshots           | 0    | 5       | 10      | 50        |

{% hint style="info" %}
**Custom plans** are available for large communities. Create a support ticket in the [Solmate Discord](https://discord.gg/solmate) to discuss your needs.
{% endhint %}

## How to Subscribe

1. Go to the web dashboard: [solmatebot.com/manage](https://solmatebot.com/manage)
2. Log in with Discord
3. Select the server you want premium for
4. Click the **Plans** tab
5. Choose between **Monthly** or **Yearly** billing
6. Click **Upgrade** on the plan you want
7. Complete the payment through Stripe

<figure><img src="https://solmatebot.com/docs/placeholder-premium-plans-page.png" alt=""><figcaption><p>The Plans tab on the web dashboard</p></figcaption></figure>

## Managing Your Subscription

* View your current plan and expiry date on the **Plans** tab
* Click **Manage Subscription** to open the Stripe billing portal
* You can update your payment method, switch plans, or cancel from there
* When you cancel, your premium features remain active until the end of the billing period

{% hint style="warning" %}
Premium is **per server**. If you want premium on multiple servers, you need a separate subscription for each.
{% endhint %}


# Wallet Tracker

Track Solana wallets in real-time and get notifications for every transaction.

The wallet tracker is Solmate's most powerful feature. Track any Solana wallet and get instant Discord notifications for swaps, transfers, token creation, burns, limit orders, and more.

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-notification.png" alt=""><figcaption><p>A swap notification from the wallet tracker</p></figcaption></figure>

## Adding a Tracker

### Via Discord

1. Type `/tracker add` in any channel
2. Enter the **wallet address** (or a `.sol` domain)
3. Select the **channel** where notifications should be sent
4. Optionally add a **nametag** (a friendly name for the wallet)
5. Optionally add **labels** (comma-separated tags to organize wallets)
6. Press Enter

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-add-command.png" alt=""><figcaption><p>Adding a wallet tracker with /tracker add</p></figcaption></figure>

### Via Web Dashboard

You can also add trackers from the dashboard — including bulk adding multiple wallets at once. See [Managing Trackers](/web-dashboard/managing-trackers).

{% hint style="info" %}
**Activation time:** New trackers may take up to 10 minutes to start receiving transactions.
{% endhint %}

## What Gets Tracked

Each notification includes details about the transaction, along with quick-action buttons to view it on explorers and trading tools.

| Transaction Type   | Description                                   |
| ------------------ | --------------------------------------------- |
| **Swaps**          | Token buys and sells (Jupiter, Raydium, etc.) |
| **Transfers**      | SOL and token transfers between wallets       |
| **Token Creation** | When the wallet creates a new token           |
| **Burns**          | When tokens are burned                        |
| **Limit Orders**   | Creation, execution, and cancellation         |
| **Fee Claims**     | Pump.fun fee claims                           |

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-swap.png" alt=""><figcaption><p>Swap notification with token details and action buttons</p></figcaption></figure>

## Managing Trackers

### List all trackers

* **Discord:** `/tracker list` — shows all tracked wallets with pagination
* **Dashboard:** Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server > **Trackers** tab

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-list.png" alt=""><figcaption><p>Tracker list on the web dashboard</p></figcaption></figure>

### Pause & Resume

You can temporarily pause trackers without deleting them:

* **Discord:** `/tracker pause` and `/tracker resume` — pause/resume all or a specific tracker by index
* **Dashboard:** Use the pause/resume buttons next to each tracker, or select multiple and use bulk actions

### Remove a tracker

* **Discord:** `/tracker remove` and enter the wallet address
* **Dashboard:** Click the delete button next to the tracker, or select multiple and bulk delete

## Minimum Transaction Value

Filter out spam and dust transactions by setting a minimum USD value. Only transactions above this amount will trigger notifications.

Set this on the dashboard under **Settings** > **Wallet Tracker Settings** > **Minimum USD Value**.

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-min-value.png" alt=""><figcaption><p>Setting a minimum transaction value</p></figcaption></figure>

## Notification Buttons

Each tracker notification includes quick-action buttons. You can customize which buttons appear and their order on the dashboard under **Settings** > **Button Configuration**.

Available buttons include links to:

* **Explorers:** Solscan, Solana.fm, Solana Explorer
* **Trading bots:** Trojan, Bonkbot, BananaGun, BullX, and more
* **Token viewers:** Birdeye, DexScreener, Photon, GMGN, Axiom
* **Utilities:** RugCheck, PumpFun, Jupiter

<figure><img src="https://solmatebot.com/docs/placeholder-tracker-buttons.png" alt=""><figcaption><p>Customizable notification buttons</p></figcaption></figure>

## Display Options

On the dashboard under **Settings**, you can toggle:

* **Show contract address** — display the token's contract in notifications
* **Show transaction summary** — include a summary line
* **Anonymize addresses** — hide full addresses in notifications
* **Show market cap** — display token market cap
* **Show memo field** — show transaction memos

## Tracker Limits

| Plan      | Wallet Trackers |
| --------- | --------------- |
| Free      | 5               |
| Plus      | 50              |
| Pro       | 150             |
| Community | 300             |

{% hint style="info" %}
Need more? Check out [Premium Plans](/getting-started/premium-plans) or request a custom plan.
{% endhint %}


# Holder Verification

Verify your members' wallets and assign roles based on NFT and token holdings.

With holder verification, your community members can connect their Solana (or BNB) wallet and automatically receive Discord roles based on what they hold.

<figure><img src="https://solmatebot.com/docs/placeholder-verification-panel.png" alt=""><figcaption><p>A verification panel in Discord</p></figcaption></figure>

## Creating a Verification Panel

A verification panel is an embed message with a "Verify" button that members click to start the verification process.

1. Type `/verification create` in the channel where you want the panel
2. Optionally customize the embed:
   * **title** — panel title
   * **description** — custom message
   * **color** — hex color code (e.g., `#FF5733`)
   * **footer\_text** — text at the bottom
   * **footer\_url** — link in footer
   * **thumbnail** — small image
   * **image** — large image
3. Press Enter — your panel is created

<figure><img src="https://solmatebot.com/docs/placeholder-verification-create.png" alt=""><figcaption><p>Creating a verification panel with custom options</p></figcaption></figure>

<figure><img src="https://solmatebot.com/docs/placeholder-verification-result.png" alt=""><figcaption><p>The resulting verification panel with a Verify button</p></figcaption></figure>

## Adding Holder Roles

Once your panel is created, you need to set up **actions** — rules that assign roles based on holdings.

{% tabs %}
{% tab title="NFT Collections" %}

1. Type `/verification actions addcollection`
2. Select the **role** to assign
3. Enter the **collection** name or symbol
4. Optionally set:
   * **amount** — minimum number of NFTs required
   * **traitname** and **traitvalue** — require a specific trait (e.g., "Background" = "Gold")
5. Press Enter

<figure><img src="https://solmatebot.com/docs/placeholder-verification-add-collection.png" alt=""><figcaption><p>Adding a collection-based holder role</p></figcaption></figure>

{% hint style="info" %}
**Finding the collection symbol:** On Magic Eden, the symbol is in the URL. For example: `https://magiceden.io/marketplace/iconic_ape_club` — the symbol is `iconic_ape_club`.
{% endhint %}
{% endtab %}

{% tab title="Tokens" %}

1. Type `/verification actions addtoken`
2. Select the **role** to assign
3. Enter the **token** name or contract address
4. Optionally set the **amount** — minimum tokens required
5. Press Enter

<figure><img src="https://solmatebot.com/docs/placeholder-verification-add-token.png" alt=""><figcaption><p>Adding a token-based holder role</p></figcaption></figure>
{% endtab %}
{% endtabs %}

## Managing Roles

### List all actions

* **Discord:** `/verification actions list` — shows all configured roles and their requirements
* **Dashboard:** Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server > **Verification** tab

### Remove an action

* **Discord:** `/verification actions remove` — select the role of the action to remove. If the role is tied to a specific collection, enter the collection name too.
* **Dashboard:** Click the delete button next to the role on the **Verification** tab

### Remove a user's verification

`/verification removeuser` — manually unverify a specific user

### Export verified users

`/verification exportuser` — export a user's verification data as JSON (Discord ID, wallets, holdings)

## Re-verification

Solmate periodically re-checks holdings to ensure members still qualify for their roles. If a member sells their NFTs or tokens, their roles will be automatically removed.

You can also manually trigger a re-check from the dashboard:

* **Refresh one user:** Verification tab > Refresh User
* **Refresh all users:** Verification tab > Refresh All

## Verification Limits

| Plan      | Verification Roles |
| --------- | ------------------ |
| Free      | 2                  |
| Plus      | 20                 |
| Pro       | 20                 |
| Community | 30                 |

{% hint style="info" %}
Both Solana and BNB Chain verification are supported. You can configure chain-specific roles on the web dashboard.
{% endhint %}


# Server Stats (Counters)

Display live Solana data in voice channels — prices, floors, volumes, and more.

Counters are voice channels that automatically update with live data. Use them to display the SOL price, collection floors, token prices, wallet balances, and more.

<figure><img src="https://solmatebot.com/docs/placeholder-stats-example.png" alt=""><figcaption><p>Voice channel counters showing live data</p></figcaption></figure>

## Creating a Counter

1. Type `/stats add`
2. Select the **counter type** from the list
3. Fill in the required options (see table below)
4. Optionally select a **category** to place the channel under
5. Press Enter

The voice channel will be created automatically and update within \~10 seconds.

{% hint style="info" %}
**Tip:** You can change the channel type from voice to text if you prefer.
{% endhint %}

## Counter Types

| Counter Type                       | Requires Collection | Requires Token | Requires Wallet | Requires Price |
| ---------------------------------- | :-----------------: | :------------: | :-------------: | :------------: |
| Solana price (USD)                 |                     |                |                 |                |
| Solana price change (%)            |                     |                |                 |                |
| Solana TPS                         |                     |                |                 |                |
| Collection floor price (SOL)       |          x          |                |                 |                |
| Collection floor price (USD)       |          x          |                |                 |                |
| NFTs listed below price X          |          x          |                |                 |        x       |
| Total collection volume (SOL)      |          x          |                |                 |                |
| Collection volume 24h (SOL)        |          x          |                |                 |                |
| Average price 24h                  |          x          |                |                 |                |
| Amount listed                      |          x          |                |                 |                |
| Listed total value (SOL)           |          x          |                |                 |                |
| SPL token price (USD)              |                     |        x       |                 |                |
| SPL token price (in another token) |                     |     x + x2     |                 |                |
| SPL token supply                   |                     |        x       |                 |                |
| SPL token market cap               |                     |        x       |                 |                |
| Token holder count                 |                     |        x       |                 |                |
| Wallet balance (SOL)               |                     |                |        x        |                |
| Wallet balance (SPL token)         |                     |        x       |        x        |                |
| Total wallet net worth             |                     |                |        x        |                |
| Wallet PNL (7 day)                 |                     |                |        x        |                |
| Wallet PNL (30 day)                |                     |                |        x        |                |

{% hint style="info" %}
**Collection field:** You can enter the Magic Eden link, collection name, or symbol.
{% endhint %}

## Customizing the Channel Name

You can add a prefix to the counter's channel name. For example, if the channel shows `◎8.79`, you can rename it to `FP: ◎8.79` or `Floor: ◎8.79`.

{% hint style="warning" %}
The prefix must come **before** the data symbol (◎, $, or arrows). Text added after the data will be removed on the next update.
{% endhint %}

## Managing Counters

### List counters

`/stats list` — shows all active counters with their index numbers

<figure><img src="https://solmatebot.com/docs/placeholder-stats-list.png" alt=""><figcaption><p>Counter list showing all active counters</p></figcaption></figure>

### Force update a counter

`/stats update` — manually trigger an update for a specific counter

### Delete a counter

`/stats remove` — select the counter by index and press Enter. The voice channel will be deleted automatically.

## Counter Limits

| Plan      | Voice Counters |
| --------- | -------------- |
| Free      | 2              |
| Plus      | 20             |
| Pro       | 20             |
| Community | 30             |

{% hint style="info" %}
If a counter is not updating, make sure Solmate has **Manage Channels** and **Connect** permissions in the category where the channel is located.
{% endhint %}


# Collection Tracker

Get real-time notifications when NFTs in a collection are sold, listed, or delisted.

Monitor Magic Eden activity for any NFT collection. Get notifications in a Discord channel whenever NFTs are listed or sold.

<figure><img src="https://solmatebot.com/docs/placeholder-collection-tracker-notification.png" alt=""><figcaption><p>A collection sale notification</p></figcaption></figure>

## Setting It Up

1. Type `/collectiontracker add`
2. Enter the **collection** name or symbol
3. Select the **channel** for notifications
4. Choose what to track:
   * **listings** — new listings and delistings
   * **sales** — completed sales
5. Press Enter

<figure><img src="https://solmatebot.com/docs/placeholder-collection-tracker-add.png" alt=""><figcaption><p>Adding a collection tracker</p></figcaption></figure>

{% hint style="info" %}
**Collection field:** You can enter the Magic Eden link, collection name, or symbol. For example: `iconic_ape_club` or `https://magiceden.io/marketplace/iconic_ape_club`.
{% endhint %}

## Managing Collection Trackers

### List all trackers

`/collectiontracker list` — shows all active collection trackers

<figure><img src="https://solmatebot.com/docs/placeholder-collection-tracker-list.png" alt=""><figcaption><p>List of active collection trackers</p></figcaption></figure>

### Remove a tracker

1. Type `/collectiontracker remove`
2. Enter the **collection** name or symbol
3. Select the **channel** it was set up in
4. Press Enter

## Collection Tracker Limits

| Plan      | Collection Trackers |
| --------- | ------------------- |
| Free      | 2                   |
| Plus      | 20                  |
| Pro       | 20                  |
| Community | 20                  |


# Static Messages

Create auto-updating embed messages with custom data.

Static messages are custom embed messages posted by Solmate that can display dynamic data like wallet balances, token prices, and more. They stay pinned in a channel and update automatically.

<figure><img src="https://solmatebot.com/docs/placeholder-static-example.png" alt=""><figcaption><p>A static message displaying wallet information</p></figcaption></figure>

## Adding a Static Message

1. Type `/static add`
2. Select the **channel** where the message should be posted
3. Customize the embed fields:
   * Title, description, color
   * Image, thumbnail
   * Footer text
4. Use **variables** in your text to display dynamic data
5. Press Enter

<figure><img src="https://solmatebot.com/docs/placeholder-static-add.png" alt=""><figcaption><p>Creating a static message with /static add</p></figcaption></figure>

## Viewing Static Messages

`/static list` — shows all configured static messages with their index numbers

<figure><img src="https://solmatebot.com/docs/placeholder-static-list.png" alt=""><figcaption><p>List of static messages</p></figcaption></figure>

## Removing a Static Message

1. Type `/static remove`
2. Select the index of the message to remove (check `/static list` for the index)
3. Press Enter

## Static Variable Limits

| Plan      | Static Variables |
| --------- | ---------------- |
| Free      | 1                |
| Plus      | 10               |
| Pro       | 10               |
| Community | 10               |


# Snapshots

Take a snapshot of all holders of an NFT collection or token.

Snapshots let you capture a list of all current holders of an NFT collection or SPL token. This is useful for airdrops, raffles, or analytics.

{% hint style="warning" %}
**Premium required:** Snapshots are a premium feature. Free plans have 0 snapshots available. See [Premium Plans](/getting-started/premium-plans).
{% endhint %}

## NFT Collection Snapshot

### Via Discord

1. Find the **verified creator address** of the collection (you can find this on Magic Eden or an explorer)
2. Type `/snapshot`
3. Select the output **file type** (JSON, TXT, or CSV)
4. Enter the verified creator address
5. Press Enter and wait a few seconds

<figure><img src="https://solmatebot.com/docs/placeholder-snapshot-creator.png" alt=""><figcaption><p>Where to find the verified creator address</p></figcaption></figure>

<figure><img src="https://solmatebot.com/docs/placeholder-snapshot-result.png" alt=""><figcaption><p>Snapshot result with downloadable file</p></figcaption></figure>

### Via Web Dashboard

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server
2. Click the **Snapshots** tab
3. Select "Collection snapshot"
4. Enter the address/symbol
5. Choose the file format
6. Click Create

## Token Snapshot

Capture all holders of an SPL token.

### Via Discord

Type `/tokensnapshot` and enter the token address.

<figure><img src="https://solmatebot.com/docs/placeholder-tokensnapshot.png" alt=""><figcaption><p>Token snapshot command</p></figcaption></figure>

### Via Web Dashboard

Same steps as above, but select "Token snapshot" instead.

## Managing Snapshots

On the web dashboard, you can:

* View all previously created snapshots
* Download snapshot files
* Delete old snapshots

## Snapshot Limits

| Plan      | Snapshots |
| --------- | --------- |
| Free      | 0         |
| Plus      | 5         |
| Pro       | 10        |
| Community | 50        |


# PNL Tracking & Leaderboard

Track profit and loss for your watched wallets over 7 and 30 days.

Solmate tracks the realized profit and loss (PNL) for all your tracked wallets, giving you insight into which wallets are performing best.

## Viewing Wallet PNL

When you look up a wallet with `/address`, the response includes the **7-day PNL** alongside the wallet balance and holdings.

<figure><img src="https://solmatebot.com/docs/placeholder-pnl-address.png" alt=""><figcaption><p>Wallet info showing 7-day PNL</p></figcaption></figure>

## PNL Leaderboard

Compare the performance of all your tracked wallets with the leaderboard command.

1. Type `/tracker leaderboard`
2. Select the **type**: 7-day PNL or 30-day PNL
3. Select the **sort order**:
   * Highest % first
   * Lowest % first
   * Highest $ first
   * Lowest $ first
4. Press Enter

The leaderboard shows your top 10 tracked wallets ranked by performance.

<figure><img src="https://solmatebot.com/docs/placeholder-pnl-leaderboard.png" alt=""><figcaption><p>PNL leaderboard showing top performing wallets</p></figcaption></figure>

## PNL Voice Counters

You can display a wallet's PNL as a live voice channel counter:

* **Wallet PNL (7 day)** — shows the 7-day PNL of a wallet
* **Wallet PNL (30 day)** — shows the 30-day PNL of a wallet

See [Server Stats](/discord-bot-features/server-stats) for how to set up counters.


# Nametags & Labels

Organize your tracked wallets with custom names and tags.

When tracking multiple wallets, it helps to give them human-readable names and organize them into groups. Solmate offers two features for this: **nametags** and **labels**.

## Nametags

A nametag is a custom name you assign to a wallet address. Instead of seeing a long address like `7xKX...9pR4` in notifications, you'll see the nametag (e.g., "Team Wallet" or "Treasury").

### Adding nametags

**When adding a tracker:** Use the `nametag` option in `/tracker add` to set a name right away.

**On the dashboard:**

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server
2. Click the **Trackers** tab
3. Switch to the **Name Tags** sub-tab
4. Click **Add** and enter the wallet address and name

<figure><img src="https://solmatebot.com/docs/placeholder-nametags-dashboard.png" alt=""><figcaption><p>Managing nametags on the dashboard</p></figcaption></figure>

### Editing and removing nametags

On the dashboard, you can edit or delete nametags at any time from the Name Tags sub-tab.

### Where nametags appear

* Wallet tracker notifications
* Tracker list
* Address lookups
* PNL leaderboards

## Labels

Labels are tags you can attach to tracked wallets for grouping and organization. For example, you might label wallets as "Team", "Influencer", or "Whale".

### Adding labels

**When adding a tracker:** Use the `labels` option in `/tracker add`. You can enter multiple labels separated by commas (e.g., `whale, influencer`).

**On the dashboard:**

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server
2. Click the **Trackers** tab
3. Switch to the **Labels** sub-tab
4. Create a new label and assign wallet addresses to it

<figure><img src="https://solmatebot.com/docs/placeholder-labels-dashboard.png" alt=""><figcaption><p>Managing labels on the dashboard</p></figcaption></figure>

### Managing labels

On the dashboard, you can:

* Create new labels
* Edit label names
* Add or remove wallets from labels
* Delete labels entirely


# Bot Settings

Customize Solmate's behavior in your server.

Solmate has several server-wide settings you can configure via Discord commands or the web dashboard.

## Bot Nickname (Price Ticker)

Make Solmate's Discord nickname display the live Solana price. The nickname updates automatically and shows the current price with a trend indicator.

**Format:** `$XX.XX ▲X.X%` or `$XX.XX ▼X.X%`

<figure><img src="https://solmatebot.com/docs/placeholder-nickname-price.png" alt=""><figcaption><p>Bot nickname showing live SOL price</p></figcaption></figure>

{% hint style="info" %}
Solmate needs the **Change Nickname** permission for this to work.
{% endhint %}

## Ticker Roles

Ticker roles automatically change color based on whether the Solana price is going up or down over the last 24 hours:

* **ticker\_green** — assigned when price is up
* **ticker\_red** — assigned when price is down

These roles are created automatically. You can use them to make the bot's name appear green or red in the member list and chat.

{% hint style="info" %}
Solmate needs the **Manage Roles** permission, and the ticker roles must be **below** Solmate's role in the role hierarchy.
{% endhint %}

## Explorer Selection

Choose which blockchain explorer is used in links throughout Solmate's responses:

* **Solscan** (default)
* **Solana FM**
* **Solana Explorer**

## Token Viewer Selection

Choose which token viewer is linked in token-related notifications:

* **Axiom** (default)
* Birdeye, DexScreener, Photon, GMGN, and more

## Configuring Settings

Most settings can be managed from the web dashboard:

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage)
2. Select your server
3. Click the **Settings** tab

<figure><img src="https://solmatebot.com/docs/placeholder-settings-page.png" alt=""><figcaption><p>The Settings page on the dashboard</p></figcaption></figure>

See [Tracker Settings](/web-dashboard/tracker-settings) for detailed tracker-specific settings.


# /address

Look up any Solana wallet to see its balance, holdings, and PNL.

Get detailed information about a Solana wallet address.

## Usage

`/address <address>`

| Option    | Required | Description                              |
| --------- | :------: | ---------------------------------------- |
| `address` |     x    | The Solana wallet address or .sol domain |

## What it shows

* SOL balance
* Total wallet value (USD)
* 7-day PNL (profit and loss)
* Top 10 token holdings with values
* .sol domains owned by the wallet
* Nametag (if one is set for this server)

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-address.png" alt=""><figcaption><p>/address command result</p></figcaption></figure>

{% hint style="info" %}
You can give wallets a custom name using nametags. This will display the name instead of the address. Learn more in [Nametags & Labels](/discord-bot-features/nametags-and-labels).
{% endhint %}

The response also includes a link to manage trackers for this wallet on the dashboard.


# /token

Look up any SPL token to see its price, supply, market cap, and security info.

Get detailed information about an SPL token, including a security analysis.

## Usage

`/token <token>`

| Option  | Required | Description                    |
| ------- | :------: | ------------------------------ |
| `token` |     x    | Token name or contract address |

## What it shows

* Token name and contract address
* Current price (USD)
* Decimals and total supply
* Market cap
* **Security analysis:**
  * Top 10 holder concentration (warns if >30%)
  * Liquidity status and USD value
  * Mint authority status (renounced or not)
  * Freeze authority status (renounced or not)

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-token.png" alt=""><figcaption><p>/token command showing token info with security details</p></figcaption></figure>

The response includes a button to view the token on your configured token viewer (Axiom by default).


# /collection

Look up any NFT collection to see floor price, volume, and more.

Get detailed information about an NFT collection from Magic Eden.

## Usage

`/collection <name>`

| Option | Required | Description                                 |
| ------ | :------: | ------------------------------------------- |
| `name` |     x    | Collection name, symbol, or Magic Eden link |

## What it shows

* Collection name and image
* Floor price (SOL and USD)
* 24-hour volume and average price
* Total volume
* Number of listed NFTs
* Creation date
* Social media links
* Categories

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-collection.png" alt=""><figcaption><p>/collection command result</p></figcaption></figure>

{% hint style="info" %}
You can enter the full Magic Eden URL, the collection name, or the symbol (found in the URL). For example: `iconic_ape_club`.
{% endhint %}


# /price

Get the current price of Solana or any SPL token.

Get live price information for Solana or a specific SPL token.

## Usage

`/price [spltoken]`

| Option     | Required | Description                                       |
| ---------- | :------: | ------------------------------------------------- |
| `spltoken` |          | Token name or address. Leave blank for SOL price. |

## What it shows

* Current price (USD)
* 24-hour price change (%)
* All-time high (ATH)
* Trading volume
* Price changes over 7d, 14d, 30d, 60d, 200d, and 1 year

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-price.png" alt=""><figcaption><p>/price command showing SOL price data</p></figcaption></figure>

{% hint style="info" %}
If no token is specified, the command returns the current Solana (SOL) price.
{% endhint %}

The response includes a "Buy on Jup.ag" button to quickly swap to the token on Jupiter.


# /floor

Get the floor price of an NFT collection with a visual preview.

Get the current floor price of an NFT collection, with an image preview of the cheapest listed NFTs.

## Usage

`/floor <collection> [data] [size]`

| Option       | Required | Description                                      |
| ------------ | :------: | ------------------------------------------------ |
| `collection` |     x    | Collection name, symbol, or Magic Eden link      |
| `data`       |          | `normal` or `all` — how much data to show        |
| `size`       |          | `small` or `big` — size of the NFT preview image |

## What it shows

* Floor price in SOL
* Number of listed NFTs
* Preview image of the floor NFT
* NFT details: price, ID, owner, mint address
* Interactive left/right buttons to browse floor listings

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-floor.png" alt=""><figcaption><p>/floor command with NFT preview and browse buttons</p></figcaption></figure>

{% hint style="info" %}
Use the arrow buttons to scroll through floor listings and see the next cheapest NFTs.
{% endhint %}


# /calculate

Convert between tokens and currencies.

Calculate the value of one token in another token or USD.

## Usage

`/calculate <value> <from> <to>`

| Option  | Required | Description                                     |
| ------- | :------: | ----------------------------------------------- |
| `value` |     x    | The amount to convert                           |
| `from`  |     x    | Source currency (token name, address, or "USD") |
| `to`    |     x    | Target currency (token name, address, or "USD") |

## Example

`/calculate 100 SOL USD` — converts 100 SOL to its USD value

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-calculate.png" alt=""><figcaption><p>/calculate command converting between tokens</p></figcaption></figure>

The response includes a "Buy on Jup.ag" button for quick access to swap on Jupiter.


# /solanainfo

Get general Solana blockchain statistics.

Display global Solana blockchain information at a glance.

## Usage

`/solanainfo`

No options required.

## What it shows

* Total supply, circulating supply, and non-circulating supply
* Current inflation rate
* Staking APY
* Total transaction count
* Daily active users
* Daily fees and rewards

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-solanainfo.png" alt=""><figcaption><p>/solanainfo command result</p></figcaption></figure>


# /flex

Show off a random NFT from your wallet.

Randomly display an NFT from your verified wallet for a collection that has holder verification set up in the server.

## Usage

`/flex`

No options required.

## How it works

1. Your wallet must be verified in the server (see [How to Verify Your Wallet](/for-members/how-to-verify-your-wallet))
2. The server must have at least one collection-based verification role set up
3. The bot picks a random NFT you own from one of those collections
4. It displays the NFT image with a link to view it on Magic Eden

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-flex.png" alt=""><figcaption><p>/flex showing a random NFT from your collection</p></figcaption></figure>

{% hint style="info" %}
This command only works for collections that have verification roles configured in the current server.
{% endhint %}


# /help

Get help with Solmate's commands.

Display a list of all commands or get detailed info about a specific command.

## Usage

`/help [command]`

| Option    | Required | Description                        |
| --------- | :------: | ---------------------------------- |
| `command` |          | A specific command to get help for |

## What it shows

**Without a command:** A list of all available commands grouped by category.

**With a command:** The command's description, usage, examples, and required permissions.

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-help.png" alt=""><figcaption><p>/help command showing all available commands</p></figcaption></figure>

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-help-detail.png" alt=""><figcaption><p>/help showing details for a specific command</p></figcaption></figure>


# /export

Export a list of verified holders with their Discord and wallet info.

Export the verification data for your server — a list of all verified users, their Discord IDs, and connected wallet addresses.

{% hint style="warning" %}
**Premium required:** This command requires a premium plan.
{% endhint %}

## Usage

`/export`

No options required.

## What it shows

A downloadable file containing all verified users and their linked wallets.

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-export.png" alt=""><figcaption><p>/export command result with downloadable file</p></figcaption></figure>

You can also export verification data from the web dashboard under the **Verification** tab.


# /verifysignature

Verify wallet ownership by providing a signed message.

Verify that you own a wallet by submitting a signature, message, and public key. This is an alternative verification method for users who prefer not to connect their wallet through the website.

## Usage

`/verifysignature`

No options — a popup form will appear.

## How it works

1. Type `/verifysignature` and press Enter
2. A popup will appear with three fields:
   * **Signature** — the signed message
   * **Message** — the original message that was signed
   * **Public Key** — your wallet address
3. Fill in the fields and submit

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-verifysignature-popup.png" alt=""><figcaption><p>The verification signature popup</p></figcaption></figure>

If the signature is valid, you'll see a confirmation message.

<figure><img src="https://solmatebot.com/docs/placeholder-cmd-verifysignature-success.png" alt=""><figcaption><p>Successful signature verification</p></figcaption></figure>


# Dashboard Overview

Manage your servers, trackers, verification, and more from the web.

The Solmate web dashboard at [solmatebot.com](https://solmatebot.com) gives you full control over all of Solmate's features without needing to type Discord commands.

## Logging In

1. Go to [solmatebot.com](https://solmatebot.com)
2. Click **Login** in the top navigation
3. Authorize with your Discord account

## Selecting a Server

After logging in, go to [solmatebot.com/manage](https://solmatebot.com/manage) to see all your servers.

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-servers.png" alt=""><figcaption><p>Server selection page</p></figcaption></figure>

You'll see two sections:

* **Managed servers** — servers where Solmate is already installed. Click to manage.
* **Unmanaged servers** — servers you own but haven't added Solmate to. Click to invite the bot.

## Server Management

After selecting a server, you'll see the management dashboard with these tabs:

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-sidebar.png" alt=""><figcaption><p>Dashboard sidebar with navigation tabs</p></figcaption></figure>

| Tab              | What you can do                                                        |
| ---------------- | ---------------------------------------------------------------------- |
| **General**      | View server info and quick links to other tabs                         |
| **Settings**     | Configure tracker behavior, verification settings, and display options |
| **Plans**        | View current plan, compare plans, upgrade or manage subscription       |
| **Trackers**     | Add, remove, pause, resume, and bulk-manage wallet trackers            |
| **Verification** | Set up holder roles, refresh verifications, export data                |
| **Snapshots**    | Create and download holder snapshots for collections and tokens        |

{% hint style="info" %}
The dashboard is fully responsive and works on mobile. On smaller screens, use the menu button to access the sidebar.
{% endhint %}

## Quick Links

* **Dashboard home:** [solmatebot.com/manage](https://solmatebot.com/manage)
* **Account & wallets:** [solmatebot.com/account](https://solmatebot.com/account)


# Account & Wallets

Manage your personal account and connected wallets.

Your account page at [solmatebot.com/account](https://solmatebot.com/account) lets you manage your personal wallets and account information.

## Account Information

After logging in, you'll see:

* Your Discord username
* Your Discord ID (with a copy button)

## Managing Wallets

Your connected wallets are used for holder verification across all servers that use Solmate.

<figure><img src="https://solmatebot.com/docs/placeholder-account-wallets.png" alt=""><figcaption><p>Account page showing connected wallets</p></figcaption></figure>

### Adding a wallet

1. Click **Add new wallet**
2. Choose the wallet type:
   * **Solana Wallet** — for SOL, SPL tokens, and NFTs
   * **EVM Wallet** — for ETH, BNB, ERC-20, and BEP-20 tokens

<figure><img src="https://solmatebot.com/docs/placeholder-account-add-wallet.png" alt=""><figcaption><p>Choosing wallet type to add</p></figcaption></figure>

3. You'll be redirected to the verification page to prove wallet ownership

### Verifying a wallet

After adding a wallet, you need to verify it. You have two options:

{% tabs %}
{% tab title="Sign a Message" %}

1. Connect your wallet (Phantom, Solflare, MetaMask, Trust Wallet, Coinbase Wallet, and 300+ more supported)
2. Sign a message when prompted
3. This does **NOT** trigger a blockchain transaction and costs nothing

<figure><img src="https://solmatebot.com/docs/placeholder-account-sign-message.png" alt=""><figcaption><p>Signing a verification message</p></figcaption></figure>
{% endtab %}

{% tab title="Send a Transaction" %}

1. Send a small amount of SOL (or BNB for EVM) to the displayed address
2. Enter the transaction ID/hash on the verification page
3. Your wallet is verified once the transaction is confirmed

This method works if you can't connect your wallet directly (e.g., hardware wallets).
{% endtab %}
{% endtabs %}

### Wallet cards

Each connected wallet shows:

* Shortened wallet address (linked to block explorer)
* Network badge (Solana or EVM)
* Verification status and date
* SOL balance (for Solana wallets)
* **Verify** button (if not yet verified)
* **Remove** button

### Removing a wallet

Click the **Remove** button on the wallet card to disconnect it from your account.

{% hint style="danger" %}
**Safety reminder:** The verification page will only be on `solmatebot.com` or `spruijtstudios.com`. If the domain is different, it's fake — contact Solmate staff immediately.
{% endhint %}


# Managing Trackers

Add, manage, and bulk-operate on wallet trackers from the web dashboard.

The **Trackers** tab on the dashboard provides powerful tools for managing all your wallet trackers, including bulk operations and file imports.

## Opening the Trackers Tab

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage)
2. Select your server
3. Click the **Trackers** tab

The tab has three sub-sections: **Trackers**, **Labels**, and **Name Tags**.

## Adding Trackers

Click **Add Trackers** to open the add popup.

### Manual entry

Type or paste wallet addresses in the text area, one per line. Use this format:

```
address channel nametag
```

For example:

```
7xKXtg2CW87...9pR4 7415794142837616252 Team Wallet
9yMNzp3EQ12...4kL8 7415794142837616252 Whale 1
```

### Paste from clipboard

Click the **Paste** button to paste addresses from your clipboard.

### File import

Drag and drop a `.txt` file into the popup, or click to browse. The file should contain wallet addresses in the same format (one per line).

<figure><img src="https://solmatebot.com/docs/placeholder-trackers-add-popup.png" alt=""><figcaption><p>Adding multiple trackers at once</p></figcaption></figure>

### Preview and submit

Before submitting, you'll see a preview table showing:

* Parsed wallet address
* Channel assignment
* Nametag
* Any errors (e.g., invalid address format)

You can edit entries inline or remove individual rows before submitting.

## Tracker List

All configured trackers are shown as cards with:

* Wallet address and nametag
* Notification channel
* Status badge (active, inactive, or disabled)
* Pause/resume button
* Delete button

<figure><img src="https://solmatebot.com/docs/placeholder-trackers-list.png" alt=""><figcaption><p>Tracker list on the dashboard</p></figcaption></figure>

### Usage indicator

A progress bar at the top shows how many trackers you're using out of your plan's limit.

## Bulk Operations

Select multiple trackers using the checkboxes, then use the bulk action buttons:

* **Pause selected** — pause all selected trackers
* **Resume selected** — resume all selected trackers
* **Delete selected** — remove all selected trackers

Use the **Select all** checkbox to quickly select everything.

<figure><img src="https://solmatebot.com/docs/placeholder-trackers-bulk.png" alt=""><figcaption><p>Bulk operations with multiple trackers selected</p></figcaption></figure>

## Name Tags Sub-tab

Manage custom names for wallet addresses. See [Nametags & Labels](/discord-bot-features/nametags-and-labels) for details.

## Labels Sub-tab

Organize wallets into groups with labels. See [Nametags & Labels](/discord-bot-features/nametags-and-labels) for details.


# Verification Setup

Set up and manage holder verification roles from the web dashboard.

The **Verification** tab on the dashboard lets you configure holder roles, refresh verifications, and export user data.

## Opening the Verification Tab

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage)
2. Select your server
3. Click the **Verification** tab

## Adding Verification Roles

1. Click **Add Role**
2. Choose how to identify the asset:
   * **By Token ID** — enter a Solana or BNB contract address
   * **By Collection Symbol** — enter a Solana NFT collection symbol
3. If using Token ID, select the **chain** (Solana or BNB)
4. The dashboard will auto-fetch the token/collection info for confirmation
5. Select the **Discord role** to assign
6. Configure requirements:
   * **Wallet required** — user must have a verified wallet (always on)
   * **Exempt from removal** — keep the role even if holdings change
   * **Need all requirements** — user must meet all role requirements (for multi-requirement roles)
7. Click **Save**

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-verification-add.png" alt=""><figcaption><p>Adding a verification role on the dashboard</p></figcaption></figure>

### Address format

* **Solana:** Base58 format (32-44 characters)
* **BNB/EVM:** `0x` prefix + 40 hex characters

## Managing Roles

Each configured role shows:

* Role name with Discord role color
* Token/collection name and symbol
* Chain indicator (Solana or BNB)
* **Edit** and **Delete** buttons

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-verification-list.png" alt=""><figcaption><p>Verification roles list</p></figcaption></figure>

A progress bar shows how many roles you're using out of your plan's limit.

## Refreshing Verifications

Sometimes you may need to re-check all users' holdings:

* **Refresh one user:** Enter a Discord user to re-verify just that person
* **Refresh all users:** Re-verify everyone in the server

This is useful after changing role requirements or if roles seem out of sync.

## Exporting Data

Export all verification data as a downloadable file:

* **JSON** — structured data with all user details
* **TXT** — plain text list

The export includes Discord IDs, usernames, verified wallets, and role assignments.


# Tracker Settings

Configure how wallet tracker notifications look and behave.

The **Settings** tab on the dashboard lets you fine-tune your wallet tracker notifications and other server settings.

## Opening Settings

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage)
2. Select your server
3. Click the **Settings** tab

The settings page has multiple sub-sections.

## Wallet Tracker Settings

### Ignored Tokens

Add token addresses to exclude from tracker notifications. Useful for filtering out spam tokens or tokens you don't care about.

* Enter the token contract address
* Click **Add**
* Remove tokens from the list with the **X** button

### Ignored Addresses

Add wallet addresses to exclude from notifications. Transactions involving these addresses won't trigger notifications.

### Minimum USD Value

Set a threshold so only transactions above a certain USD value trigger notifications. This filters out dust and micro-transactions.

<figure><img src="https://solmatebot.com/docs/placeholder-settings-filters.png" alt=""><figcaption><p>Filtering options for wallet trackers</p></figcaption></figure>

### Display Toggles

| Setting                  | Description                                           |
| ------------------------ | ----------------------------------------------------- |
| Show contract address    | Display the token's contract address in notifications |
| Show transaction summary | Include a summary line in each notification           |
| Anonymize addresses      | Hide full wallet addresses                            |
| Show market cap          | Display token market cap in swap notifications        |
| Show memo field          | Show transaction memo if present                      |

### Button Configuration

Customize which buttons appear on tracker notifications and in what order.

* **Drag and drop** buttons to reorder them
* **Remove** buttons you don't need
* Available buttons include explorers (Solscan, SolanaFM), trading bots (Trojan, Bonkbot, BullX), token viewers (Birdeye, DexScreener, Photon, GMGN, Axiom), and utilities (RugCheck, PumpFun, Jupiter)

<figure><img src="https://solmatebot.com/docs/placeholder-settings-buttons.png" alt=""><figcaption><p>Drag and drop to reorder notification buttons</p></figcaption></figure>

## General Settings

* **Tips toggle** — enable or disable helpful tips in bot responses
* **Nick/ticker role settings** — configure the bot nickname price display and ticker roles

## Saving Changes

After making changes, a **Save** button will appear. Click it to apply your settings. Changes take effect immediately for new notifications.


# Snapshots

Create and manage holder snapshots from the web dashboard.

The **Snapshots** tab on the dashboard lets you create, view, and download snapshots of NFT collection or token holders.

{% hint style="warning" %}
**Premium required:** Snapshots are a premium feature. Free plans have 0 snapshots available.
{% endhint %}

## Creating a Snapshot

1. Go to [solmatebot.com/manage](https://solmatebot.com/manage) > select your server
2. Click the **Snapshots** tab
3. Click **Create Snapshot**
4. Choose the type:
   * **Collection snapshot** — all holders of an NFT collection
   * **Token snapshot** — all holders of an SPL token
5. Enter the address or symbol
6. Select the file format: **JSON**, **TXT**, or **CSV**
7. Click **Create**

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-snapshots-create.png" alt=""><figcaption><p>Creating a snapshot on the dashboard</p></figcaption></figure>

The snapshot will be generated and automatically downloaded.

## Viewing Snapshots

All previously created snapshots are listed on the tab. You can filter between collection and token snapshots using the sub-tabs.

Each snapshot shows:

* Creation date and time
* Address/ID used
* Type indicator (collection or token)
* **Download** button
* **Delete** button

<figure><img src="https://solmatebot.com/docs/placeholder-dashboard-snapshots-list.png" alt=""><figcaption><p>Snapshot list with download options</p></figcaption></figure>

## Snapshot Limits

| Plan      | Snapshots |
| --------- | --------- |
| Free      | 0         |
| Plus      | 5         |
| Pro       | 10        |
| Community | 50        |

The create button is disabled when you've reached your plan's limit.


# Getting Started

Get started with Solmate on Telegram for real-time Solana wallet tracking.

The Solmate Telegram bot brings real-time Solana wallet tracking directly to your Telegram chats.

## Starting the Bot

1. Open Telegram and search for **@SolmateTelegramBot** or click [this link](https://t.me/SolmateTelegramBot)
2. Tap **Start** or type `/start`
3. The bot will show a welcome message with the current SOL price and your tracker status

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-start.png" alt=""><figcaption><p>The Telegram bot start menu</p></figcaption></figure>

## Main Menu

After starting, you'll see buttons for the main features:

| Button       | Description                                    |
| ------------ | ---------------------------------------------- |
| **Trackers** | View and manage all your tracked wallets       |
| **Nametags** | Add custom names to wallet addresses           |
| **Premium**  | View subscription status and upgrade           |
| **Settings** | Configure explorer, buttons, and notifications |
| **Help**     | Get help and links to the support server       |

## Available Commands

| Command   | Description                                             |
| --------- | ------------------------------------------------------- |
| `/start`  | Open the main menu                                      |
| `/help`   | Show all commands and support links                     |
| `/add`    | Add new wallet trackers                                 |
| `/remove` | Remove tracked wallets                                  |
| `/stop`   | Pause all active trackers                               |
| `/resume` | Resume all paused trackers                              |
| `/export` | Export all tracked wallets as a .txt file               |
| `/reset`  | Reset all trackers and nametags (requires confirmation) |
| `/token`  | Look up a token's info and security                     |
| `/switch` | Switch bot instance (premium only)                      |

## Group Support

The Telegram bot also works in groups and supergroups, so you can set up tracking for your community.

{% hint style="info" %}
**Free tier:** You can track up to 2 wallets for free. Upgrade to premium for up to 50.
{% endhint %}


# Tracking Wallets

Track Solana wallets on Telegram and get instant transaction notifications.

## Adding a Tracker

1. Type `/add` or tap the **Trackers** button from the main menu, then tap **Add**
2. Send the wallet address (or `.sol` domain), one per line
3. Optionally include a nametag after the address:

   ```
   7xKXtg2CW87d9pR4 Team Wallet
   9yMNzp3EQ124kL8 Whale
   ```
4. The bot validates each address and confirms the addition

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-add-tracker.png" alt=""><figcaption><p>Adding a wallet tracker on Telegram</p></figcaption></figure>

{% hint style="info" %}
**Free users:** Wallets must have a minimum balance of 0.001 SOL and must be your own wallet. Premium users can track any wallet, even empty ones.
{% endhint %}

## Transaction Notifications

Once a tracker is active, you'll receive instant notifications for:

| Event              | Description                                               |
| ------------------ | --------------------------------------------------------- |
| **Swaps**          | Buy/sell transactions with token details and market cap   |
| **Transfers**      | SOL and token transfers between wallets                   |
| **Token creation** | When the wallet creates a new token                       |
| **Burns**          | Token burn transactions                                   |
| **Limit orders**   | Jupiter limit order creation, execution, and cancellation |
| **Fee claims**     | Pump.fun fee claims                                       |

### Notification format

Each notification includes:

* Direction indicator (green for buy, red for sell, blue for multi-token swap)
* Wallet name/address
* Exchange used (Jupiter, Raydium, etc.)
* Token amounts and prices
* Market cap information
* Quick-action buttons (customizable in Settings)

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-swap-notification.png" alt=""><figcaption><p>A swap notification on Telegram</p></figcaption></figure>

## Managing Trackers

### View all trackers

Tap **Trackers** from the main menu to see all tracked wallets with pagination (10 per page). Each entry shows:

* Active/inactive status
* Wallet address with nametag
* Tracked event types

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-tracker-list.png" alt=""><figcaption><p>Tracker list with pagination</p></figcaption></figure>

### Remove a tracker

Type `/remove` or tap **Remove** in the Trackers menu, then follow the prompts to select which wallet to stop tracking.

### Pause & resume

* `/stop` — pauses **all** active trackers
* `/resume` — resumes **all** paused trackers

### Export trackers

`/export` — downloads a `.txt` file with all your tracked wallet addresses and nametags.

### Reset everything

`/reset` — removes all trackers and nametags. You'll need to type `yes` to confirm.

## Nametags

Give your tracked wallets human-readable names:

1. Tap **Nametags** from the main menu
2. Tap **Add** and follow the prompts
3. Enter the wallet address and desired name

Nametags appear in all notifications instead of the raw address.

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-nametags.png" alt=""><figcaption><p>Managing nametags on Telegram</p></figcaption></figure>

## Token Lookup

Use `/token <name or address>` to look up any token. Shows:

* Token name, price, and contract address
* Market cap, decimals, and supply
* Security info (top holder concentration, liquidity, mint/freeze authority)

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-token.png" alt=""><figcaption><p>/token command showing security analysis</p></figcaption></figure>

## Tracker Limits

| Plan    | Wallet Trackers |
| ------- | --------------- |
| Free    | 2               |
| Premium | 50              |


# Settings & Customization

Customize your Telegram bot experience — explorers, buttons, and filters.

Tap **Settings** from the main menu to configure your Telegram bot preferences.

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-settings.png" alt=""><figcaption><p>The Telegram settings menu</p></figcaption></figure>

## Explorer Selection

Choose which blockchain explorer is used in notification links:

* **Solscan** (default)
* **SolanaFM**
* **Solana Explorer**

Tap the explorer name to select it. A checkmark indicates the active selection.

## Trading Tool Selection

Choose which token viewer is linked in notifications:

* **Birdeye** (default)
* **DexScreener**
* **Photon**
* **GMGN**
* **Axiom**

## Custom Buttons

You can configure up to **5 custom buttons** that appear on each transaction notification. Each button can be set to any of these:

### Explorers

* Solscan (Transactions or Tokens)
* SolanaFM (Transactions or Tokens)
* Solana Explorer (Transactions or Tokens)

### Trading Bots

* Trojan Bot, BonkBot, BananaGun, Shuriken, SolTradingBot, BullX, Plonk, GMGN TG, TradeWiz, Axiom, Bloom

### Token Viewers

* Birdeye (Tokens or Wallet), DexScreener, Photon, GMGN (Tokens or Wallet), Jupiter, RugCheck, PumpFun

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-custom-buttons.png" alt=""><figcaption><p>Configuring custom notification buttons</p></figcaption></figure>

## Notification Filters

### Minimum transaction value

Set a minimum USD value for notifications. Transactions below this amount are silently ignored.

* Tap **Set min tx value**
* Enter the amount (minimum $0.01)
* Useful for filtering out spam and dust transactions

### Hide unknown tokens

Toggle this to hide notifications for tokens that don't have price data. Keeps your notifications clean from obscure or spam tokens.

### Show transfers

Toggle SOL and token transfer notifications on or off. When disabled, you'll only see swap and trading activity.

### Show source button

Toggle whether a "Jupiter" or "Raydium" source button appears on swap notifications.


# Telegram Premium

Unlock more trackers and better performance with Telegram premium.

## Free vs Premium

| Feature                | Free          | Premium |
| ---------------------- | ------------- | ------- |
| Wallet trackers        | 2             | 50      |
| Track any wallet       | No (own only) | Yes     |
| Empty wallet tracking  | No            | Yes     |
| Priority notifications | No            | Yes     |
| Bot instance switching | No            | Yes     |

## Pricing

* **Monthly:** EUR 9.99/month
* **Yearly:** EUR 99.99/year (save \~17%)

## How to Subscribe

1. Type `/start` and tap the **Premium** button
2. Tap **Buy Premium**
3. Complete the payment through Stripe (card payment)
4. Your premium features activate immediately

<figure><img src="https://solmatebot.com/docs/placeholder-telegram-premium.png" alt=""><figcaption><p>Telegram premium subscription options</p></figcaption></figure>

## Managing Your Subscription

* Tap **Premium** from the main menu to see your subscription status and expiry date
* Tap **Manage** to open the Stripe billing portal where you can:
  * Update payment method
  * Cancel subscription
  * View invoices

## Bot Instance Switching

Premium users can switch between different bot instances for better performance:

* **@SolmateTelegramBot** — default instance
* **@SolmatePremiumBot** — premium instance 1
* **@SolmatePremiumTwoBot** — premium instance 2

Use `/switch` to change instances. Your trackers and settings carry over.

{% hint style="info" %}
Switching instances can help if you're experiencing delays due to high traffic on the default bot.
{% endhint %}


# How to Verify Your Wallet

Step-by-step guide for community members to verify their wallet and get holder roles.

If a Discord server uses Solmate for holder verification, you'll need to connect and verify your wallet to receive roles based on your NFT or token holdings.

## Step 1: Click the Verify button

Find the verification panel in the Discord server (usually in a dedicated channel) and click the **Verify** button.

<figure><img src="https://solmatebot.com/docs/placeholder-member-verify-panel.png" alt=""><figcaption><p>Click the Verify button on the panel</p></figcaption></figure>

You'll be redirected to the Solmate website to complete verification.

## Step 2: Add your wallet

If this is your first time, you'll be on the wallet verification page. You have two ways to verify:

{% tabs %}
{% tab title="Option 1: Sign a Message (Recommended)" %}

1. Click **Connect Wallet**
2. Select your wallet provider (Phantom, Solflare, MetaMask, Trust Wallet, Coinbase Wallet, and 300+ more)
3. Approve the connection in your wallet
4. Click **Verify** — you'll be asked to sign a message
5. Approve the signature in your wallet

<figure><img src="https://solmatebot.com/docs/placeholder-member-sign-message.png" alt=""><figcaption><p>Signing a verification message — this costs nothing</p></figcaption></figure>

{% hint style="info" %}
**This is free and safe.** Signing a message does NOT trigger a blockchain transaction, does NOT cost any gas, and does NOT give anyone access to your funds.
{% endhint %}
{% endtab %}

{% tab title="Option 2: Send a Transaction" %}
If you can't connect your wallet directly (e.g., you're using a hardware wallet):

1. Send a small amount of SOL (or BNB) to the address shown on the verification page
2. Copy the transaction ID/signature
3. Paste it into the input field
4. Click **Submit**

Your wallet is verified once the transaction is confirmed.
{% endtab %}
{% endtabs %}

## Step 3: Get your roles

Once verified, the bot will automatically check your holdings and assign the appropriate roles. This happens within a few seconds.

If the server has roles for:

* **NFT Collections** — you get the role if you hold an NFT from that collection
* **Tokens** — you get the role if you hold the required amount of a token
* **Traits** — you get the role if you hold an NFT with a specific trait (e.g., "Background: Gold")

## Managing Your Wallets

You can manage all your connected wallets at [solmatebot.com/account](https://solmatebot.com/account):

* View all connected wallets
* Verify wallets you haven't verified yet
* Remove wallets you no longer want connected
* Add additional wallets (both Solana and EVM)

<figure><img src="https://solmatebot.com/docs/placeholder-member-account-page.png" alt=""><figcaption><p>Your account page with connected wallets</p></figcaption></figure>

## Supported Wallets

Solmate supports 300+ wallets through WalletConnect, including:

* **Phantom**
* **Solflare**
* **MetaMask** (for BNB/EVM)
* **Trust Wallet**
* **Coinbase Wallet**
* And many more

## Chain Support

Depending on the server's configuration, you may be able to verify with:

* **Solana** wallets (SOL, SPL tokens, NFTs)
* **BNB/EVM** wallets (BNB, ERC-20, BEP-20 tokens)

{% hint style="danger" %}
**Stay safe:** The verification page will only be on `solmatebot.com` or `spruijtstudios.com`. If you're redirected to any other domain, it's a scam. Do NOT connect your wallet and contact Solmate staff immediately.
{% endhint %}

## Re-verification

Solmate periodically re-checks your holdings. If you sell your NFTs or tokens, the associated roles may be removed automatically. If you acquire new holdings, verify again or wait for the next automatic check.

## FAQ

**Q: Will verifying cost me anything?**\
A: No. Signing a message is completely free and doesn't interact with the blockchain.

**Q: Can the bot access my funds?**\
A: No. The verification only proves you own the wallet. Solmate never has access to your private keys or funds.

**Q: I verified but didn't get my role?**\
A: Make sure you hold the required NFT/token in the wallet you verified. If the issue persists, contact the server's admins or Solmate support.

**Q: Can I verify multiple wallets?**\
A: Yes. Add and verify multiple wallets at [solmatebot.com/account](https://solmatebot.com/account). Holdings across all verified wallets are combined.


# Privacy and Safety

How Solmate keeps you and your server safe and secure.

## Privacy

{% hint style="danger" %}
**Important:** Solmate will **never** ask for your wallet's private key, seed phrase, or passphrase. If anyone claims to be Solmate staff and asks for these, it is a scam. Contact our staff immediately in the support server.
{% endhint %}

### What data we store

We only store the data necessary for Solmate to function:

* Discord user ID and username (for linking your account)
* Wallet addresses you voluntarily connect (for verification and tracking)
* Server configuration settings (for bot features)

We do **not** collect or store:

* Private keys or seed phrases
* Transaction history beyond what's needed for active features
* Personal information beyond your Discord profile

### Data visibility

All data stored for a user is visible to the user themselves. For example, you can see all your connected wallets and notification settings on the [account page](https://solmatebot.com/account).

### Data deletion

If you remove your data (disconnect a wallet, delete a tracker, etc.), it is permanently deleted from our systems.

## Safety

### Bot access

Only the developer (@spruijt) has access to the bot's systems and infrastructure. No third parties have access.

### Database security

* The database is encrypted and only accessible by the bot service and the developer
* We only store what's needed for the bot to work
* Database backups are created regularly
* Deleted data is permanently removed

### Verification safety

* Wallet verification only requires a **signature** — no transaction or funds transfer
* The verification page is only hosted on `solmatebot.com` and `spruijtstudios.com`
* If you see any other domain, it is fake — do NOT connect your wallet

### Permissions

Solmate requests Discord permissions for specific features:

| Permission      | Used for                                         |
| --------------- | ------------------------------------------------ |
| Manage Roles    | Assigning holder roles and ticker roles          |
| Manage Channels | Creating and updating stat counter channels      |
| Send Messages   | Responding to commands and sending notifications |
| Embed Links     | Displaying rich embed messages                   |
| Attach Files    | Sending export and snapshot files                |

Not all permissions are required for the bot to function, but some features won't work without their respective permissions.


# Privacy Policy

Privacy Policy for Solmate Discord Bot

Last updated: May 19, 2023

1. Introduction

Thank you for using Solmate, a Discord bot with Solana-related features ("the Bot"). This Privacy Policy outlines how we collect, use, and protect your personal information when you interact with the Bot. We are committed to maintaining the privacy and security of your information and ensuring compliance with applicable data protection laws.

2. Information We Collect

2.1 Personal Information

When you use the Bot, we may collect certain personal information that you voluntarily provide to us. This may include your Discord username, user ID, and any additional information you choose to provide while using the Bot.

2.2 Usage Data

The Bot may also collect non-personal information about your usage of its features. This data includes, but is not limited to, your commands, messages, and interactions with the Bot. We may use this information to improve the functionality and performance of the Bot.

3. Use of Information

3.1 Provision of Services

We collect and use the information we gather to provide you with the Bot's services and to improve your user experience. This includes responding to your inquiries, fulfilling your requests, and personalizing your interactions with the Bot.

3.2 Communication

We may use your contact information, such as your Discord username or user ID, to communicate with you regarding updates, announcements, and information related to the Bot's services.

3.3 Aggregated Data

We may aggregate non-personal information collected from the Bot's usage to analyze trends, monitor the Bot's performance, and improve our services. Aggregated data does not personally identify you and cannot be used to trace back to individual users.

4. Data Sharing and Disclosure

4.1 Service Providers

We may engage third-party service providers to perform certain functions on our behalf, such as hosting, data analysis, and customer support. These service providers will have access to your personal information only to the extent necessary to perform their functions and are obligated to maintain the confidentiality and security of your data.

4.2 Legal Compliance

We may disclose your personal information if required to do so by law or in response to valid legal requests, such as subpoenas or court orders.

4.3 Protection of Rights

We may disclose your personal information to protect our rights, privacy, safety, or property, as well as those of our users or the public when we have a good faith belief that such disclosure is necessary.

5. Data Security

We take reasonable measures to protect the personal information collected through the Bot from unauthorized access, disclosure, alteration, or destruction. However, please note that no method of transmission or storage is completely secure, and we cannot guarantee absolute security.

6. Data Retention

We will retain your personal information for as long as necessary to fulfil the purposes outlined in this Privacy Policy unless a longer retention period is required or permitted by law.

7. Children's Privacy

The Bot is not intended for use by individuals under the age of 13. We do not knowingly collect personal information from children. If you believe that we have inadvertently collected personal information from a child, please contact us immediately, and we will take steps to remove that information.

8. Changes to this Privacy Policy

We may update this Privacy Policy from time to time. The most recent version will be indicated by the "Last updated" date at the beginning of this Policy. We encourage you to review this Policy periodically for any changes. Your continued use of the Bot after any modifications will signify your acceptance of the updated Privacy Policy.

9. Contact Us

If you have any questions or concerns regarding this Privacy Policy or our privacy practices, please contact us at <privacy@spruijtstudios.com>.

Thank you for using Solmate Discord Bot!