# User Commands

### 📡 $snipe — eBay Deal Sniper

Watches eBay 24/7 and pings you inside your thread when a new listing matches your filters.

> **Must be used inside a thread channel.** Run `$snipe list` anywhere to check your active snipes.

***

#### ➕ Add a Snipe

```
$snipe add <search term> [search:exact] [profit:N] [min:N] [max:N] [neg:word1,word2]
```

| Option            | Description                                                                                                                                                                                                                            |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search:exact`    | Every keyword in your search term must appear in the listing title (any order). Useful for specific card codes like `004/019`.                                                                                                         |
| `profit:N`        | Alert only if the eBay price is at least **N%** below the TCGPlayer market price *and* the net profit is > $5. Requires TCGPlayer data.                                                                                                |
| `min:N`           | Alert only if the eBay price is **≥ $N**.                                                                                                                                                                                              |
| `max:N`           | Alert only if the eBay price is **≤ $N**.                                                                                                                                                                                              |
| `neg:word1,word2` | Exclude listings containing any of these words (comma-separated). Words shorter than 4 characters match as whole words only; longer words match anywhere in the title. Punctuation and special characters are ignored during matching. |

> Options can be placed anywhere in the command and are case-insensitive (`Search:Exact`, `search : exact`, etc. all work).

**Limits:** Up to **5 active snipes** per user. Up to **50 snipe users** per server.

***

#### ➖ Remove a Snipe

```
$snipe remove <search term>
```

Removes the snipe for the given search term. The search term must match exactly what you added.

***

#### 📋 List Your Snipes

```
$snipe list
```

Shows all your active snipes with their configured options.

***

#### Examples

```
$snipe add jirachi 004/019 search:exact max:80
```

> Alerts on listings whose title contains both **jirachi** and **004/019**, priced ≤ $80.

```
$snipe add psa 9 charizard profit:20 max:300
```

> Alerts when a PSA 9 Charizard listing is 20%+ below TCG market price and ≤ $300.

```
$snipe add pokemon booster box min:40 max:120
```

> Alerts on any Pokemon booster box listed between $40–$120.

```
$snipe remove jirachi 004/019
```

> Removes the jirachi 004/019 snipe.

***

#### How It Works

* eBay is scanned continuously across all active search terms.
* **New listings only** — you won't be re-alerted on the same listing.
* When `search:exact` is set, the monitor checks that **every individual keyword** from your search term appears somewhere in the listing title. Order doesn't matter, but all must be present.