Source: https://docs.walletmaster.tools/discord-bot

# Overview and command index

How the Wallet Master+ Discord bot works and what each of its 20 commands does: find tokens, find traders, analyze wallets, and look up addresses.

The **Wallet Master+** bot is where wallets and tokens come from. Twenty commands, run in a direct message with the bot, each one answering with a file you can open anywhere or drop straight into Data Import. Included in both plans.

## Before you start

1. Your access is activated with `/verify`. If not, start with [Buy and activate access](https://docs.walletmaster.tools/buy-and-activate).
2. Open a direct message with **Wallet Master+**: click the bot's name anywhere in the Wallet Master server, or search for it in Discord.
3. Type `/` and the command name. Discord shows the command's fields under the message box.

> [!WARNING]
> Commands only work in the direct message with the bot, not in server channels.

## How a command runs

1. ### Send the command
   Fill in the fields Discord shows and send. Commands that take a list of addresses, such as `/pnlplus` or `/toptraders`, reply with a prompt instead: answer it with the addresses, one per line, pasted as a message or uploaded as a .txt file.
2. ### Wait for the bot
   Most commands answer within seconds. A popular token over a long interval, or a list of tens of thousands of wallets, takes longer. You can send another command in the meantime.
3. ### Open the file
   The result comes back as a file in the same direct message:
   - **.txt**: one address per line. Drop it into Data Import or into another command as it is.
   - **.csv**: a table, one row per wallet or token, with the columns listed on the command's page.
   - **.zip**: one file per token you sent, when you sent several.
   A file that reads **There was no data** means nothing matched; widen the interval or check the address.

## Pick the right command

### Find tokens

| Command | What it gives you | You provide |
| --- | --- | --- |
| [/trendingtokens](https://docs.walletmaster.tools/trendingtokens) | The tokens with the most swaps right now, across every supported launchpad and DEX | An interval and whether to look at recent tokens or all |
| [/migratedtokens](https://docs.walletmaster.tools/migratedtokens) | Tokens that just migrated from a launchpad to a DEX | An interval and the launchpad |
| [/mcaptokens](https://docs.walletmaster.tools/mcaptokens) | Tokens that crossed a market cap you set within the last one to three days | A minimum market cap, an interval, and whether to keep tokens that fell back |
| [/athmcap](https://docs.walletmaster.tools/athmcap) | The all-time-high market cap and its date for any tokens | Up to 200 token addresses |

### Find traders

| Command | What it gives you | You provide |
| --- | --- | --- |
| [/toptraders](https://docs.walletmaster.tools/toptraders) | The most profitable wallets on each token | Up to 500 token addresses |
| [/earlybuyers](https://docs.walletmaster.tools/earlybuyers) | The first buyers of each token, with their result on it | Up to 500 token addresses |
| [/alltraders](https://docs.walletmaster.tools/alltraders) | Every wallet that ever swapped a token, with its buys, sells and result | Up to 500 token addresses |
| [/metatraders](https://docs.walletmaster.tools/metatraders) | The wallets that traded several of the tokens on your list, with the count | A list of token addresses |
| [/botwallets](https://docs.walletmaster.tools/botwallets) | Wallets that used a specific trading bot recently | A bot from the list and an interval |
| [/dexwallets](https://docs.walletmaster.tools/dexwallets) | Every wallet active on a DEX or launchpad recently | A DEX or launchpad and an interval |
| [/programstats](https://docs.walletmaster.tools/programstats) | The custom swap programs in use and how busy they are | An interval |
| [/programswaps](https://docs.walletmaster.tools/programswaps) | Every swap that went through a program, or only the wallets | A program address and an interval |
| [/lookuptablestats](https://docs.walletmaster.tools/lookuptablestats) | The lookup tables in use and how busy they are | An interval |
| [/lookuptableswaps](https://docs.walletmaster.tools/lookuptableswaps) | Every swap that used a lookup table, or only the wallets | A lookup table address and an interval |

### Analyze

| Command | What it gives you | You provide |
| --- | --- | --- |
| [/pnlplus](https://docs.walletmaster.tools/pnlplus) | Every metric for every wallet on your list, as a CSV | Up to 100,000 wallet addresses |
| [/mcapanalyze](https://docs.walletmaster.tools/mcapanalyze) | The wallets that first bought a token inside a market cap range, with their result | A token address and a market cap range |
| [/timestampanalyze](https://docs.walletmaster.tools/timestampanalyze) | The wallets that first bought a token inside a time window, with their result | A token address and two timestamps |
| [/buysellfilter](https://docs.walletmaster.tools/buysellfilter) | The wallets that bought or sold a token for an amount of SOL in a range | A token address, buy or sell, and a SOL range |
| [/tokensoverlap](https://docs.walletmaster.tools/tokensoverlap) | The wallets that bought every token on your list, each inside its own time window | Up to 50 lines of token, start, end |

### Utility

| Command | What it gives you | You provide |
| --- | --- | --- |
| [/findaddress](https://docs.walletmaster.tools/findaddress) | The full addresses that match a fragment | At least four characters and where they sit in the address |
| `/verify` | Activates your access | Your country of residence. See [Buy and activate access](https://docs.walletmaster.tools/buy-and-activate) |
| `/api` | Your API key, the IP address saved for it, and your remaining credits | Nothing. See [Authentication and keys](https://docs.walletmaster.tools/rest-authentication) |

## Addresses, limits and timestamps

- Addresses go one per line, nothing else on the line: no commas, no labels, no numbering. A .txt file with the same layout works wherever a pasted list works.
- Limits per run: 100,000 wallets for `/pnlplus`; 500 tokens for `/toptraders`, `/earlybuyers` and `/alltraders`; 200 tokens for `/athmcap`; 50 lines for `/tokensoverlap`.
- Timestamps are Unix seconds. Any converter gives you one; the command pages show where they go.

> [!TIP]
> Chain the commands. `/trendingtokens` gives you tokens, `/toptraders` turns them into wallets, and the wallet file goes into `/pnlplus` or Data Import. The [Quickstart](https://docs.walletmaster.tools/quickstart) walks through it in 15 minutes.

## Run the same commands over the API

Every command except `/metatraders` has an endpoint in the Bot API that returns the same file, for scripts and dashboards. See [Bot API overview](https://docs.walletmaster.tools/bot-api).