# 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](/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](/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](/migratedtokens) | Tokens that just migrated from a launchpad to a DEX | An interval and the launchpad |
| [/mcaptokens](/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](/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](/toptraders) | The most profitable wallets on each token | Up to 500 token addresses |
| [/earlybuyers](/earlybuyers) | The first buyers of each token, with their result on it | Up to 500 token addresses |
| [/alltraders](/alltraders) | Every wallet that ever swapped a token, with its buys, sells and result | Up to 500 token addresses |
| [/metatraders](/metatraders) | The wallets that traded several of the tokens on your list, with the count | A list of token addresses |
| [/botwallets](/botwallets) | Wallets that used a specific trading bot recently | A bot from the list and an interval |
| [/dexwallets](/dexwallets) | Every wallet active on a DEX or launchpad recently | A DEX or launchpad and an interval |
| [/programstats](/programstats) | The custom swap programs in use and how busy they are | An interval |
| [/programswaps](/programswaps) | Every swap that went through a program, or only the wallets | A program address and an interval |
| [/lookuptablestats](/lookuptablestats) | The lookup tables in use and how busy they are | An interval |
| [/lookuptableswaps](/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](/pnlplus) | Every metric for every wallet on your list, as a CSV | Up to 100,000 wallet addresses |
| [/mcapanalyze](/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](/timestampanalyze) | The wallets that first bought a token inside a time window, with their result | A token address and two timestamps |
| [/buysellfilter](/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](/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](/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](/buy-and-activate) |
| `/api` | Your API key, the IP address saved for it, and your remaining credits | Nothing\. See [Authentication and keys](/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](/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](/bot-api)\.