# TokenScan Ecosystem

#### Your complete guide to everything TokenScan

Choose a section below to explore the bot’s features and documentation.

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><h4>TokenScan Docs</h4></td><td><a href="/files/e4qPiia1VANHoZbcyF8O">/files/e4qPiia1VANHoZbcyF8O</a></td><td><a href="/pages/QBthrXJaydZyCZsTnHJV">/pages/QBthrXJaydZyCZsTnHJV</a></td></tr><tr><td align="center"><h4>Raidar Docs</h4></td><td><a href="/files/YldCGFVJpM0mKDjbBeCG">/files/YldCGFVJpM0mKDjbBeCG</a></td><td><a href="/pages/joKLFxiBc5YF7qk35Am1">/pages/joKLFxiBc5YF7qk35Am1</a></td></tr><tr><td align="center"><h4>Guardian Docs</h4></td><td><a href="/files/5IgCS9doHdSOsmbfnH3t">/files/5IgCS9doHdSOsmbfnH3t</a></td><td><a href="/pages/MD3uBqgv1SEFCDAzfDvX">/pages/MD3uBqgv1SEFCDAzfDvX</a></td></tr></tbody></table>

***

## [Join the TokenScan Support community on Telegram](https://t.me/TokenScanSupport)


# Token discovery for the trenches

TokenScan is the flagship onchain intelligence platform built for Telegram, letting traders scan tokens, track wallets, and monitor market data without ever leaving their chat.

No dashboards, no noise. Just fast, accurate data where you already trade.

***

<div align="left"><figure><img src="/files/BA0S561nDL8pD2Z0oniw" alt="Graphic detailing TokenScan&#x27;s features and how they compare to competitors." width="563"><figcaption></figcaption></figure></div>

### Why It Exists <a href="#komyfnpattv" id="komyfnpattv"></a>

Meme traders move fast. Traditional dashboards don’t.&#x20;

TokenScan brings speed and simplicity where traders most need it, letting users:

* Pull live token data on demand
* See holder and deployer activity
* Track updates when token info is updated on DexScreener
* Spot trends and connections across tokens instantly
* Set your personal referral links on the quick buy buttons

{% hint style="success" %}
See the /ref command for more detail on setting your referral links!
{% endhint %}

***

### Core Strengths

TokenScan was built with traders in mind, and every feature reflects that.

* Fast data retrieval
* Clean, intuitive design
* No setup, no account or external login needed
* Fully Telegram native

***

### How It Works <a href="#id-6l1szdn4o0nm" id="id-6l1szdn4o0nm"></a>

TokenScan runs entirely inside Telegram, pulling live data from trusted onchain and market sources the moment you need it.

* Paste a CA (Contract Address) to instantly scan a token
* Use an extensive suite of commands to dig deeper into wallets, market data, deployer activity, and more
* Works in both private DMs and Telegram groups

***

### Additional Features

TokenScan also runs several features in the background.

* When a social link is shared (X, TikTok, Instagram, or PolyMarket), TokenScan generates a clean preview.
* Relevant crypto news is dropped directly into the group as it surfaces.
* When a token migrates, the group gets a notification.
* When a token pays for a DexScreener update or a CTO is detected, the group gets an alert.

All of these can be toggled on or off in [**/settings**](/tokenscan/settings).

{% hint style="info" %}
If a tweet previewed in the group gets deleted on X, TokenScan posts a follow-up notification quoting the original message so the group knows it's been removed.
{% endhint %}


# Start TokenScan

Learn how to start using TokenScan

<figure><img src="/files/JUybIICBHjwojjyfdM7b" alt="Sample bit of a tokenscan scan" width="321"><figcaption></figcaption></figure>

### Use TokenScan

In DMs:

* Recommended for anything personal or private. Configurations, preferences, etc.&#x20;

In Groups:

* Search for @TokenScan in Telegram
* Click <img src="/files/UZqHLXY0IZXrNLbAfy7j" alt="Button that reads &#x22;Add to Group or channel&#x22;" data-size="line"> then select your destination
* Use bot commands as in DM

***

### Supported Networks <a href="#pl0mw2lnimks" id="pl0mw2lnimks"></a>

* Ethereum, Base, Solana, BSC (Binance), Abstract, Hyperliquid, Arbitrum (Nova/ETH/One), Tron, Sui, Ton, Matic, Pulse Chain, XRP, Cosmos, Sonic, World Chain, Plasma, Sei, AVAX.

{% hint style="info" %}
Token data may be more limited on certain chains, so scans will not always return the same level of detail across all supported networks.
{% endhint %}

{% hint style="warning" %}
Be sure to look for @TokenScan and only exactly that. As with anything in crypto, always use official links, and beware of copycats.
{% endhint %}


# TokenScan commands list

An Overview of TokenScan Commands. View onchain or market data in real time.

{% hint style="info" %}
All commands typically work the same whether you're in a group or a private DM with the bot, except for a few that are specific to Group only, like **/calls** or DM-only, like **/help**.
{% endhint %}

{% hint style="info" %}
Show all commands by using the **/help** command in a DM with the bot.
{% endhint %}

## Token Commands:

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/s - Scan</mark>

Scan any token by contract address (CA) or ticker to get a full breakdown including price, liquidity, holders, deployer info, and risk levels.&#x20;

* **MC**: Market Cap
* **ATH**: All time high
* **USD**: Price in USD
* **LIQ**: Liquidity
* **VOL**: Volume (24h)
* **1H**: Buys and Sells in 1h timeframe
* **HLD**: Holders count
* **P**: Pool address
* **DEV**: Dev address
* **Socials**: Social media links&#x20;
  {% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/6GRinjipZeAoUqQN1NKE" alt="Sample scan showing the metrics laid out to the left of the image"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
You can also trigger a scan by simply pasting a contract address or ticker **directly into the chat**.&#x20;
{% endhint %}

***

{% columns %}
{% column width="58.333333333333336%" %}

#### <mark style="color:green;">/pf - Pump.fun Scan</mark>

Scan any Pump.fun token. Displays an added **Dev Stats** section.

**Deployed** - Total number of tokens the deployer has launched on Pump.fun

**Bonded** - How many of those tokens have bonded
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/IV05d8n2pq48E7TqS47t" alt="Small chunk of additional data presented by this command"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/c - Chart</mark>

View the chart of any token by sending this command followed by a contract address

specific timeframes (1m/5m/15m/30m/1h/4h/1d/1w) and  Indicators (\[wide] \[mc] \[ma] \[sr] \[fchm]) can be used with this command.
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/p3eGeDfPdGb8qUlpjh9s" alt="" width="323"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/tc - Ticker Check</mark>

Enter this command followed by a ticker to view tokens with a similar name. This can be useful for spotting copycats or discovering other projects riding the same narrative.

<br>
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/4Uxp9drvHdBL2SOM4BOK" alt="Sample Ticker check showing numerous tokens with the same ticker" width="294"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

#### <mark style="color:green;">/fix \<ticker> \<CA></mark>

Sets a contract address to be associated with a ticker.

#### <mark style="color:green;">/unfix \<ticker></mark>&#x20;

Removes changes made previously with the /fix command
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/vvv0myXLX7bOIO0xe3bX" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/dp - DexScreener Updates</mark>

View a token's DexScreener update history. An update can signal a few different things: a team actively investing in marketing, a community takeover in progress, or in some cases, an attempt to make a token appear more legitimate than it is.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/AqLbWHry1vfRbvZllcIk" alt="A dexscreener update panel"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="warning" %}
Bad actors sometimes pay for a DexScreener update to make a token look more active, timed alongside wash trading to inflate volume. Traders who see a freshly paid update alongside suspicious volume patterns use it as a red flag.
{% endhint %}

***

{% columns %}
{% column width="58.333333333333336%" %}

#### <mark style="color:green;">/v- Convert Token Value</mark>

Convert any token amount to its current USD value.

**/v \<token amount> \<token ticker or CA>**
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/m0RhoHE7A2AP2Ct9Huhl" alt="illustrates how Tokenscan converts token amounts to dollar value"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/p- Token Market Stats</mark>

Fetches market data for a token. &#x20;

Similar to a scan, but a cleaner view for those who just want a quick look at the stats.
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/lAwoZ8DJPVFvTA0Z5mCq" alt="Sample market data.  "><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/th- Top Holders</mark>

Used to evaluate token distribution.&#x20;

View the top 10 holders of a token, the percentage of the total supply that they hold, and other major holdings they may have.

Includes direct links to their wallets on SolScan for easy analysis.

#### <mark style="color:green;">/tt- Top Traders</mark>

Shows the top traders for a token.

Tracks Bought and Sold figures, along with a Profit calculation.

Includes direct links to their wallets on SolScan for easy analysis.

#### <mark style="color:green;">/tw- Top Wallets</mark>

Similar to Top Holders. Use to view the top wallets holding a token, only for this command, there is a threshold where it will only show wallets that hold more than $50,000 worth of a token.&#x20;
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/dHKW8Fu1m4mxvj2dSIGD" alt="Top holders for $FWOG" width="254"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/nh \<CA> - Notable Holders</mark>&#x20;

Use this command with a contract address to analyze any token to see who's holding, broken down into clean categories based on wallet behavior and trading history. Includes a summary of holder distribution so you can examine a token's holders in detail.

Tap any category to drill into the individual wallets and get a closer look at who is behind the holdings, with details relevant to that category such as PnL, hold time, wallet value, funding source, number of buys, etc.
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/hA5wK9TOhfFku5DLIJOS" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/soc - Socials</mark>

Check the project's official links and social media accounts - Website, X, Telegram, and GitHub if they available

#### <mark style="color:green;">/nar - Token Narrative</mark>

Pulls up images and the lore behind a token&#x20;
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/OwUSBpTkd8n0WLtOi5Mn" alt="Socials for AURA"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Wallet Commands:

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/ws - Wallet Stats</mark>

Used with the format: /ws \<wallet address>

Shows a summary of a particular wallet's activity in the past week/month/year.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/GLh7cbGLPF0AciKHdWGs" alt="Readout of a sample wallet with the statistics given by the wallet stats command" width="375"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" %}

#### <mark style="color:green;">/dev - Deployer check</mark>

Used with the format: /dev \<dev wallet address>

Scan all tokens that launched by a deployer address with accompanying data.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/IkV6mZhiUIG6cq8mUFnq" alt="Dev check readout."><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Market Commands:

#### <mark style="color:green;">/i- market Info</mark>

Show the current state of the entire cryptocurrency market. Top 10 stats, Total volume, BTC dominance, etc.&#x20;

#### <mark style="color:green;">/markets</mark>

View the current open/close status of global markets at a glance.

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/fear - Fear & Greed Index</mark>

Shows the current Fear and Greed sentiment score.

{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/dXlPpGXZxJZvIhpeWSuE" alt="Bullish fear and greed index image."><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/cal - Calendar</mark>&#x20;

Check upcoming events with potential market impact, including economic announcements and key crypto dates.
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/wI3FB9Jaa0poKEmGF7Fk" alt="The calendar command shows upcoming crypto events"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/today - Today's news</mark>

View a summary of crypto / financial news for today

{% endcolumn %}

{% column %}

<figure><img src="/files/mxE8Z3WXJZy09S0lCQqq" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/tren - Launchpad Stats</mark>

Shows the most recent performance data for token launchpads

{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/fWYZuRWDn8hvOgNitJuZ" alt="Sample of perfomance data for launchpads" width="122"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/hmc - category heatmap</mark>

View a heatmap across token categories including Stablecoins, Memes, DEX/CEX, AI, Gaming, Agents, L2s, and more.

#### <mark style="color:green;">/hm - heatmap of the top 20 Cryptocurrencies</mark>

{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/tbKI2wlW8ZRTZBehPSM9" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/ctos - Community Take Overs</mark>

Use this command to view notable and recent CTOs

{% endcolumn %}

{% column %}

<figure><img src="/files/346TelkUvpsizp5uCdoQ" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/poly \<keyword></mark>&#x20;

Search for markets on Polymarket related to your keyword choice
{% endcolumn %}

{% column %}

<figure><img src="/files/reSs7fo5PIxPXPrTD4Wl" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Group Commands:

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/lb - Group Leaderboard</mark>

Ranks group members by their best calls. Highlights the top performers, shows the highest-return tokens, and includes group stats such as total calls, average return, and hit rate. Sparks friendly competition and keeps everyone hunting for the bragging rights that come with the next big win.

{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/Cf6QZm1uC2bD1Q4KADV7" alt="Group leaderboard shows the top callers in your group" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/calls - Most recent calls</mark>

Shows the most recent calls made by group members.

#### <mark style="color:green;">/fc - First caller</mark>

See who called a token first in your group, and at what market cap.
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/lhc2tGixWcbGGQTtrV8u" alt="The most recent calls in your group" width="171"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/importcalls - Import calls from other bots</mark>

* Set your group's Chat History to Visible
* Add [@TokenScanImport](https://t.me/TokenScanImport) or [@TokenScanImport2](https://t.me/TokenScanImport2) to your telegram group
* Run <mark style="color:green;">/importcalls</mark>
* Your calls import automatically&#x20;
  {% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/A35lMZpn8pfyTaFtG9vs" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/EpmXCN6E1dDp7orJMbgo" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column %}

#### <mark style="color:green;">/thesis & /comment</mark>

A new way to share your conviction on any token and see what everyone else thinks.

Drop your take with <mark style="color:green;">/comment</mark>, then pull up every thesis on a token with <mark style="color:green;">/thesis</mark>: the market cap it was called at, likes, and who said what.

All in one place, plus a live 24h feed of the latest and top-liked theses across every group.
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/CPgvMm6SFrDM3trZyL1E" alt="" width="563"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/t - Trending tokens</mark>&#x20;

Shows the tokens generating the most buzz in your group.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/rQw21TdPDSEWiopaz0OY" alt="Sample of Trending tokens"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/stats - User Stats</mark>

Your personal summary. Shows how many calls you made, points you earned, success rate, and some top calls.

* Add a Telegram username after the command to see stats of a particular user, e.g. **/stats @username**&#x20;
  {% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/wGcIYWVwHxren0KPAAZi" alt="Shows your personal calling stats" width="189"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/pnl</mark>

Use with a contract address or ticker to create a PNL card for tokens called in your group

#### <mark style="color:green;">/cpnl</mark>

**Custom PNL Backgrounds**

1. Post an image, GIF, or video in your group
2. Reply to it with the command **/cpnl** and the image will be used as a custom PNL image.

#### <mark style="color:green;">/gpnl</mark>

Call up a PNL card for your group using a chosen timeframe\
e.g. /gpnl <5m/10m/1h/6h/1d/30d>
{% endcolumn %}

{% column %}

<figure><img src="/files/AT51w1KBoZ65e4VjeVV3" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

#### <mark style="color:green;">/qb \<provider1, provider2, ...></mark>

Use this command to choose which Quick Buy buttons your TokenScan scans will have

Available providers: AXI, GM, PDR, TRT, TEL, BLX, PHO, SGM, BSD, MVX, BLO, BNK, MAE, BAN, TRO, STB, MTB

#### <mark style="color:green;">/ref - Referral Link</mark> <a href="#referral-link" id="referral-link"></a>

Use this command with the format: /ref \<provider> \<your ref name>&#x20;

to link a Quick Buy button to your referral

#### <mark style="color:green;">/cleanup - Kick inactive members of your group</mark>

Follow this command with a time threshold expressed as a number of days, e.g.&#x20;

**/cleanup 14** will list people who have been inactive for two weeks.

#### <mark style="color:green;">/settings - Group Settings</mark>&#x20;

For a thorough breakdown of the group settings, visit the [Settings](/tokenscan/settings) page.

***

## Other Commands:

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/x- Recycled X Accounts</mark>

Look for Twitter (X) accounts that have been reclaimed or recycled. Also will show simple name changes.

Can be used with the format:

/x \<x link>    OR

/x \<x name>
{% endcolumn %}

{% column width="41.666666666666664%" valign="middle" %}

<figure><img src="/files/bXqrrATVyN0QJjFFObTj" alt="Pudgy Penguins was not recycled, just had a name change"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}

#### <mark style="color:green;">/do - Domain checks</mark>

Look at the domain creation, expiration, and DNS information for any website.

{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="/files/YHInXiF9oDyOOSOSxMRI" alt="Scan a web domain to see an array of data"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

#### <mark style="color:green;">/tldr - summarize long texts</mark>

Use as a reply to a message to summarize

#### <mark style="color:green;">/gh - GitHub repository analysis</mark>

Get a review of any GitHub repo, to be used with the format: **/gh \<GH repository Link>**

***

#### <mark style="color:green;">/connect</mark>

Leverage this command to connect to the Trojan Terminal, to get a live feed of every token call made in your groups.  For more information, see the [Connect](/tokenscan/connect-to-trojan-terminal) page.&#x20;

***

{% columns %}
{% column valign="middle" %}

#### <mark style="color:green;">/runners</mark>

Find out what's been running. See which tokens crossed 100K market cap in the last 24 hours, with median first scan market cap, median ATH, and a quick look at the last hour's runners.

{% endcolumn %}

{% column %}

<figure><img src="/files/N2vY5Dlfj6ARg3NrGq6T" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}


# Settings

A full breakdown of TokenScan's group settings, including scanner controls, alerts, DexScreener notifications, link previews, and layout options.

Type **/settings** in your group to open the TokenScan settings panel.&#x20;

{% columns %}
{% column %}
**Scanner** : Enables or disables token scanning in the group.

**Admin Only** : Restricts TokenScan commands to admins only.

**Connect** : Enables the [**/connect**](/tokenscan/connect-to-trojan-terminal) command, which links your group to Trojan Terminal.

**Get Support** : Quick access button to the TokenScan support room.

<mark style="color:green;">**Trojan Ranked**</mark>

See [Connect to Trojan Terminal](/tokenscan/connect-to-trojan-terminal) page for details on this feature

<mark style="color:green;">**Alerts**</mark>

Toggle automatic group notifications. **Multiplier PNL** enables PNL card generation via **/pnl**, **Migration** posts when a token migrates, and **News** drops relevant news into the group as it surfaces.

<mark style="color:green;">**DexScreener**</mark>

Toggle DexScreener alerts for your group. **Paid** notifies when a token pays for a DexScreener update, **CTO** alerts when a community takeover is detected, and **Boosts** fires when a token receives a boost.

<mark style="color:green;">**Link Previews**</mark>

Toggle previews for **X**, **TikTok**, **Instagram**, and **PolyMarket** links shared in the group.
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/6FN96hAJXK3RKKmiJOHv" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">**Layout**</mark>

**Banner**, **Icon**, **Buttons**, and **Links** : Show or hide DexScreener and trading platform elements on scans.

🟢 **Compact** enabled shows: MCap, ATH, price in USD, liquidity levels, and volume&#x20;

🔴 **Compact** disabled shows: the previous plus last hour buys/sells amount, holders count, Pool & Deployer addresses, and Audit elements

Switch your scan layout to mirror the style of other popular scanners.
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Type **/help** in DM with @TokenScan at any time to get the full list of commands.
{% endhint %}

***

{% columns %}
{% column %}
Use the **/start** command to view a compact settings list.&#x20;

This can be expanded into the settings panel by toggling the **Advanced Settings** button

* **Free Alerts**: Enables all Alert items at once.
* **Trending:** Opens a curated feed of trending tokens, updated regularly so you're always looking at what's hot. &#x20;

<div align="left"><figure><img src="/files/Hj6ulUkKi0gR4W1GLcOA" alt="" width="188"><figcaption></figcaption></figure></div>
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/Uc3TxgrpFXqrPWCrCXFe" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}


# Connect to Trojan Terminal

Connect TokenScan to Trojan Terminal and get a live feed of every token call made in your groups

<figure><img src="/files/n2jaiCR0Mls3Ba4rzYUm" alt=""><figcaption></figcaption></figure>

### **How to connect**

We've partnered with Trojan to launch a new Telegram and Discord Leaderboard for the Trenches.

Type **/connect** in your Telegram or Discord group.

Click **Connect to Trojan**

That's it!&#x20;

Every call your group makes from that point forward is tracked automatically.

{% columns %}
{% column %}

<figure><img src="/files/eQ2TEkqoTf0I5pVvkISs" alt="Telegram instructions"><figcaption><p>Detailed instructions for Telegram</p></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/mbRBJGUSMy7f2fKwfocx" alt="Discord Instructions"><figcaption><p>Detailed instructions for Discord</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

### Trojan Ranked

Groups, calls and callers ranked by performance.

<figure><img src="/files/ctFQ99WXtfYuR1szVhqW" alt="a slice of the Trojan Ranked screen"><figcaption></figcaption></figure>

{% columns %}
{% column %}
**Group**:  Toggle this to Green (🟢) to have your group appear openly in Trojan Alpha Ranked (look at the list and you will see many groups covered with asterisks.  This is the default before opting in.)&#x20;

**Calls** and **Callers**:  Either shows up fully with the names displayed (🟢)&#x20;

or not at all (🔴)&#x20;
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/M60o0bomqNEMz2UBIoIm" alt="Trojan ranked visibility toggles"><figcaption><p>Access these buttons in your<br>group /settings</p></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
The ranking system dynamically scores all TokenScan groups, showing the top 250 in a global leaderboard. The more calls your group makes that perform well, the higher you rank.

**Note:** There is a daily limit of 40 calls as an anti-spam measure. Without it, groups could farm points by spamming scans and unfairly inflate their rank.
{% endhint %}

## Trojan Integration Commands:

{% columns %}
{% column valign="middle" %}

### <mark style="color:green;">/rank</mark>&#x20;

Shows a group rank in the overall board across multiple timeframes

As well as top 5 ranked groups across multiple timeframes
{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/IUEIHA11bJrE7rv12kH6" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

### <mark style="color:green;">**/xlink**</mark>

Connect your X account to your group using this command so anyone who discovers you on Trojan Ranked can follow you directly from there.&#x20;

{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/Q1DFAENukHus1FkJAs3w" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

### <mark style="color:green;">/tgc \<Ticker/CA></mark>

Shows if an asset has been called by selected groups
{% endcolumn %}

{% column %}

<figure><img src="/files/S72F3mVK1uWQvh1CrQ4q" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

{% hint style="info" %}
Connect every group you're in and the Alpha page becomes your central hub for call tracking across all of them. No more juggling chats.
{% endhint %}


# TokenScan FAQ

Questions about Tokenscan, and Answers!

<details>

<summary>Why isn’t the bot replying?</summary>

Make sure you’re messaging @TokenScan directly or that it’s an admin in your group, keeping in mind
&#x20;some commands require admin permissions.

</details>

<details>

<summary>What networks are supported?</summary>

Ethereum, Base, Solana, BSC, Abstract, Hyperliquid, Arbitrum (Nova/ETH/One), Tron, Sui, Ton, Matic, Pulse Chain, XRP, Cosmos, Sonic, World Chain, Plasma, Sei, AVAX.&#x20;

Additional chains are under active development.

</details>

<details>

<summary>Why do some tokens show limited data?</summary>

Data availability depends on the indexer and liquidity source.
\
Newly launched or illiquid tokens might not yet have complete metrics.

</details>

<details>

<summary>How does the DEX Payments check work?</summary>

/dp scans for verified transactions made to DexScreener for updates or listing fees.
\
It helps confirm if a token has paid to update metadata.

</details>

<details>

<summary>Can I use TokenScan in multiple groups?</summary>

Yes. You can add the bot to as many groups as you want.
\
Each group keeps its own context and leaderboard data.

</details>

<details>

<summary>Is there a limit to how often I can scan?</summary>

No hard limit, but rate control may apply in large groups to keep performance stable.

</details>


# Heartbeat of your community raids

Use Raidar to promote projects on X, powered by the official Twitter API

**Raidar** is **the** market-leading raid bot, part of the **TokenScan ecosystem.** Built to help projects cut through the noise, trend faster, and mobilize audiences directly from Telegram.

Raidar bridges Twitter (X) and Telegram, enabling seamless, real-time interaction across platforms.&#x20;

Your community can **interact with tweets directly from your Telegram group**. Click one button to **like, retweet, comment, or bookmark**, or use **Smash** to trigger all actions in a single click.

<h2 align="center">Raidar Statistics</h2>

{% columns %}
{% column valign="middle" %}

<h2 align="center"><mark style="color:green;"><strong>+103,000</strong></mark></h2>

<p align="center"><strong>Groups trusting Raidar</strong></p>
{% endcolumn %}

{% column %}

<h2 align="center"><mark style="color:green;"><strong>+575,000</strong></mark></h2>

<p align="center"><strong>Total active users</strong></p>
{% endcolumn %}

{% column %}

<h2 align="center"><mark style="color:green;"><strong>+7,400,000</strong></mark></h2>

<p align="center"><strong>Raids achieved</strong></p>
{% endcolumn %}
{% endcolumns %}


# Key Features

Learn about the Key Features of Raidar

Built for crypto communities, Raidar is the **fastest and most intuitive Twitter Raid bot on the market**. Launch coordinated raids in one click, keep engagement going 24/7, and reward whoever's putting in the work. Runs on the official Twitter API, so it's fast, compliant, and won't disappear overnight.

### <mark style="color:green;">Twitter-Telegram Integration</mark>

Concentrate your community’s energy on any tweet with Raidar. **Launch a raid in one click directly from your Telegram group**, and every member instantly sees a ready-to-use interface:

<figure><img src="/files/sjsTMvCtqAQUKcCRTqJT" alt="Bottom part of the screen readout given for a Twitter raid" width="375"><figcaption></figcaption></figure>

**All actions happen directly in Telegram.** No switching apps, no copy-paste.

The Smash button triggers all four actions simultaneously. Ideal for high-volume, synchronized raids where every second counts.

***

### <mark style="color:green;">Live Leaderboard</mark>

Real-time ranking of top raiders, updated live in Telegram. Tracks smashes, raid completions, and engagement quality.

\
Admins can reward top performers with shoutouts, badges, or onchain tokens through [Raid2Earn](/raidar/raid2earn), driving participation and long-term loyalty.

***

### <mark style="color:green;">Smart Tweets Queue</mark>

**Queue up to 10 tweets (Basic) or 20 (Raidar Pro) for upcoming raids.** Raidar manages the queue and triggers the next one automatically once the active raid hits its goals, keeping members engaged without any manual effort.

When the target number of smashes, comments, or engagement goals is hit, the next queued tweet is instantly deployed to the group, creating a self-sustaining raid pipeline.

Ideal for keeping raids live across time zones. Whether your EU team wraps up at midnight or the US crew logs off at dawn, the next wave of raiders always finds a live, structured raid waiting.

***

### <mark style="color:green;">Raid2Earn: Reward your community's efforts</mark>

Reward your community for showing up and raiding.

Raidar verifies every action (like, retweet, comment, bookmark) and delivers rewards automatically and instantly. Admins define the rules and select which token to use for payouts. Only active, genuine raiders get paid.

Abuse-proof by design:

* Real-time action validation
* Minimum activity thresholds set by admin

*(See the* [*Raid2Earn*](/raidar/raid2earn) *section for more details)*

***

### <mark style="color:green;">Raidar Pro: Maximum Capability, Minimum Cost</mark>

The richest Pro plan on the market. Get a fully white-labeled bot with a custom name, profile picture, and full ownership, at a price no competitor can match.

*(See the* [*Raidar Pro*](/raidar/raidar-pro) *section for more details)*

***

### <mark style="color:green;">Powered by the Official X API</mark>

Built on the official X (Twitter) API, not scrapers, no violations. Authentication, rate limits, and updates are all handled automatically. Zero shadowban risk. Your accounts stay safe while engagement scales.


# Raidar commands list

Discover the all-new raiding experience with Raidar Pro — the most feature-packed bot on the market, and yet the most affordable one.

Below the full Raidar commands with a description - You can view this full command list anytime by sending /help in a DM with @raidar.

### <mark style="color:green;">General Commands</mark>

<table><thead><tr><th width="400.08599853515625">Command</th><th width="435">Details</th></tr></thead><tbody><tr><td>/raid + link</td><td>Start a raid on a tweet</td></tr><tr><td>/stop</td><td>Stop the ongoing raid</td></tr><tr><td>/settings or /options</td><td>Open the settings menu</td></tr><tr><td>/reward + @user + Amount + $SYMBOL</td><td>Reward a user with tokens</td></tr><tr><td>/gxp</td><td>Show group’s trending XP</td></tr><tr><td>/trend</td><td><a href="/pages/4f7c6abe13da6687c8c68208ffb1fb28047c2ad4">Boost group on @raidartrending</a></td></tr><tr><td>/pro</td><td><a href="/pages/3489fff059c00ff886a569efcf8db53a8214a7a6">Upgrade to Raidar Pro</a></td></tr></tbody></table>

### <mark style="color:green;">Queue Management</mark>

<table><thead><tr><th width="400.4942626953125">Command</th><th width="435">Details</th></tr></thead><tbody><tr><td>/next + link + targets</td><td>Add tweet to raid queue</td></tr><tr><td>/delnext + #index</td><td>Remove tweet from queue</td></tr><tr><td>/setnext + link + targets</td><td>Set this tweet as the next in your queue. </td></tr><tr><td>/switchnext + index + #index</td><td>Swap two tweets in queue</td></tr><tr><td>/clearnext</td><td>Clear entire queue</td></tr><tr><td>/next</td><td>Show queue list</td></tr></tbody></table>

### <mark style="color:green;">User Leaderboard & XP</mark>

<table><thead><tr><th width="399.833740234375">Command</th><th width="435">Details</th></tr></thead><tbody><tr><td>/disqualify + @user</td><td>Remove user from leaderboard</td></tr><tr><td>/undisqualify + @user</td><td>Reinstate disqualified user</td></tr><tr><td>/disqualified</td><td>List all disqualified users</td></tr><tr><td>/lbreset</td><td>Reset entire leaderboard</td></tr><tr><td>/xp + @user</td><td>Show user’s XP</td></tr><tr><td>/givexp + @user + amount</td><td>Give XP to a user</td></tr><tr><td>/remxp + @user + amount</td><td>Remove XP from a user</td></tr></tbody></table>

### <mark style="color:green;">Non-Admin Commands</mark>

<table><thead><tr><th width="399.79473876953125">Command</th><th width="435">Details</th></tr></thead><tbody><tr><td>/profile</td><td>View your XP, wallet, rank (DM only)</td></tr><tr><td>/connect</td><td>Link wallet for rewards (DM only)</td></tr><tr><td>/login</td><td>Connect X (Twitter) account (DM only)</td></tr><tr><td>/logout</td><td>Unlink X account (DM only)</td></tr><tr><td>/lb or /leaderboard + [1D, 7D, 30D, ALL]</td><td>View group leaderboard</td></tr><tr><td>/help</td><td>Show full help guide (DM only)</td></tr><tr><td>/start</td><td>Initialize bot (DM only)</td></tr></tbody></table>


# Raid2Earn

Raid2Earn is Raidar’s powerful feature that enables Admins to reward community members who actively participate in raids through the platform.

With full flexibility, rewards can be distributed in any token on the supported blockchain networks : **ERC (Ethereum), Base, BSC (BNB Chain), Avalanche, Sui, Solana, Chiliz, Ink, Monad**

***

### <mark style="color:green;">How does it work ?</mark>

Users earn XP (Experience Points) for every interaction during a raid by engaging with Raidar’s button (like, comment, retweet, smash, etc.).

<figure><img src="/files/4vO7uZCxm0PtzA1YF2ag" alt="default XP per Transaction amounts illustrated. " width="563"><figcaption></figcaption></figure>

These points are tracked in real time on the leaderboard  (Enter **/lb** in group) and tokens are automatically distributed to participants based on their earned XP according to your group’s Raid2Earn (R2E) setup.

***

### <mark style="color:green;">Raid2Earn Modes</mark>

There are two R2E modes in Raidar:

&#x20;

{% columns %}
{% column %}

### <mark style="color:green;">Single Raid Mode</mark>

When raid targets are achieved, token rewards are distributed to participants based on their individual XP earned from button interactions during the raid.
{% endcolumn %}

{% column %}

### <mark style="color:green;">Campaign Mode</mark>

Admins define a start and end date/time for the campaign. During this period, users join raids and earn XP from their interactions. At th end of the campaign, Raidar distributes rewards based on a participant's total XP.
{% endcolumn %}
{% endcolumns %}

***

### <mark style="color:green;">Raid2Earn Configuration</mark>

### <sub>Threshold:</sub>

The minimum XP a user (and their raid activity in the group) must reach to qualify for rewards.

{% hint style="info" %}
Example: With a 50 XP threshold, **Raidar only rewards XP earned after the user surpasses 50 XP**.&#x20;

XP below the threshold does not count toward rewards. Only the amount above it qualifies.
{% endhint %}

### <sub>Ratio XP/Token:</sub>

The **ratio** setting defines the distribution rate. It shows how many tokens are awarded per XP earned.

{% hint style="info" %}
Example: A user earns tokens based on their XP. **With a 2 tokens per XP ratio**, since **a "like" awards 5 XP**, the **user receives 10 tokens** for that "like" (2 tokens × 5 XP).
{% endhint %}

*(See the* [*How to enable & set up Raid2Earn*](/raidar/start-raidar/as-group-admin/how-to-enable-and-set-up-raid2earn) *section for more details)*


# Raidar Pro

Discover the all-new raiding experience with Raidar Pro — the most feature-packed bot on the market, and yet the most affordable one.

**Raidar** is already the most complete raid engine on the market but **Raidar Pro elevates it to elite status**, designed for projects aiming for total domination in the crypto raid space.&#x20;

Here's what sets Pro apart with advanced features tailored for high-stakes campaigns

<table><thead><tr><th width="535">Feature</th><th align="center">Raidar (Basic)</th><th align="center">Raidar Pro</th></tr></thead><tbody><tr><td>Simple and user-friendly interface</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Tweet interaction directly from Telegram group</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Media (Image/Video/GIF) Customization </td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>1 Day/ 7 Days / 30 Days / All-time Leaderboard </td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Queue tweets to raid</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Raid2Earn</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Built-in manual reward (tipping) command</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Easy to set (Min. admin roles)</td><td align="center">☑️</td><td align="center">☑️</td></tr><tr><td>Whitelabeled bot (Branded to your project)</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Higher performance</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Multiple raids simultaneously </td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Automatic raids in group when pre-defined accounts tweet</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>AI-Generated comments suggested to raiders, based on Tweet content </td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Raid message text customization</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Custom Media for Raid Start / In-Progress / End (Image/Video/GIF)</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Group boost on Raidar Trending (<a href="https://t.me/raidartrending">@RaidarTrending</a>)</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>XP Customization</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Timeframe customization (e.g. Raid message refresh)</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Dedicated support to your group</td><td align="center">❌</td><td align="center">☑️</td></tr><tr><td>Early-access to new features &#x26; products</td><td align="center">❌</td><td align="center">☑️</td></tr></tbody></table>


# How to set up Auto Raid

Learn how to set up Auto Raid with this interactive tool

{% embed url="<https://app.supademo.com/demo/cmjilkw0002ljyl0i2zi2ldhs?utm_source=link>" %}


# How to set custom text on Raidar

Learn how to set custom text on Raidar with this interactive tool

{% embed url="<https://app.supademo.com/demo/cmjjngcqd001mwl0hpuvmblfy?utm_source=link>" %}


# How to adjust/reward XP

Learn how to adjust XP on RaidarPro with this interactive tool

{% embed url="<https://app.supademo.com/demo/cmjjrta0s004owl0h632px9v5?utm_source=link>" %}


# How to change the XP ratio per action

Learn how to change the XP ratio on Raidar with this interactive tool

{% embed url="<https://app.supademo.com/demo/cmjjr4682003nwl0hdntbc584?utm_source=link>" %}


# How to create your own WL Bot

Learn how to create a custom WL bot on Raidar with this interactive tool

{% embed url="<https://app.supademo.com/demo/cmjju34ss066yyf0ig9ubfpq4?utm_source=link>" %}


# Raidar Trending

The Raidar Trending channel (@raidartrending) is a dynamic, real-time feed showcasing the top-performing raid groups across Telegram.

## Raidar Trending Channel

Powered by Raidar, it highlights organic growth and engagement in crypto raids, campaigns, and community-driven projects.&#x20;

{% columns %}
{% column valign="middle" %}
With over **42K** subscribers, this channel serves as the go-to hub for discovering high-momentum groups, focusing on genuine activity measured by XP scores.
{% endcolumn %}

{% column valign="middle" %}

<div data-with-frame="true"><figure><img src="/files/5v9OsSnHjtThG7ESZh6N" alt="Sample image of what a Raidar output displays.  Actual data not important." width="301"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

### How it works:

* **XP-Driven Ranking**: Groups earn XP through raids with Raidar. When a group hits trending thresholds, it appears in the feed with its rank, name, Telegram link (if set), and current XP.
* **Automated Updates**: The channel posts instant notifications for groups entering the top ranks, linking to the full trending board.

{% hint style="info" %}
Use the command **/gxp** in your group and see your XP total.
{% endhint %}

## Raidar Trending Boosts

**Want more visibility, faster?**&#x20;

Catapult your raid group to the top of **@raidartrending**.&#x20;

Hit **/boost** in DM with Raidar, to access multiple boost tiers and amplify your reach.

You will gain guaranteed **prime placement on the Raidar Trending leaderboard** plus more eyes on your project to **turn visibility into growth**.


# Start Raidar

<table data-view="cards"><thead><tr><th>Title</th><th data-card-target data-type="content-ref">Target</th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Guide for Raiders</strong><br>Everything community members need to use @raidar - connect X, earn XP, smash raids, view leaderboard, and collect rewards.</td><td><a href="/pages/e8e927a4c1815b5d25713cd1aa72c4a82fce008a">/pages/e8e927a4c1815b5d25713cd1aa72c4a82fce008a</a></td><td data-object-fit="contain"><a href="/files/MPMoDikTsfQNtCqExBBG">/files/MPMoDikTsfQNtCqExBBG</a></td></tr><tr><td><strong>Guide for Group Admin</strong><br>Everything group admins need to master @raidar - add bot, launch raids, manage XP/leaderboards, customize, boost trending, and Pro upgrades.</td><td><a href="/pages/b4f55baeb8379300edc109e1ba3544fb7549cb86">/pages/b4f55baeb8379300edc109e1ba3544fb7549cb86</a></td><td data-object-fit="contain"><a href="/files/IInRUkRDE0RXUqrizO9R">/files/IInRUkRDE0RXUqrizO9R</a></td></tr></tbody></table>


# As Group Admin

Learn how to use Raidar as a Group Admin with the following links

1. [Install the bot in your group](/raidar/start-raidar/as-group-admin/install-the-bot-in-your-group)
2. [Customize your raid exprience](/raidar/start-raidar/as-group-admin/customize-your-raid-exprience)
3. [Set your group on Trending](/raidar/start-raidar/as-group-admin/send-your-group-to-raidar-trending)
4. [How to start & stop a raid](/raidar/start-raidar/as-group-admin/how-to-start-and-stop-a-raid)
5. [How to queue tweets](/raidar/start-raidar/as-group-admin/how-to-queue-tweets)
6. [How to show leaderboard](/raidar/start-raidar/as-group-admin/how-to-show-and-reset-leaderboard)
7. [How to enable & set up Raid2Earn](/raidar/start-raidar/as-group-admin/how-to-enable-and-set-up-raid2earn)
8. [FAQ (For Group Admin)](/raidar/start-raidar/as-group-admin/faq-for-group-admin)


# Install the bot in your group

Get Raidar up and running in your Telegram group in less than 1 minute

### <mark style="color:green;">Step-by-Step Guide to add Raidar</mark>&#x20;

{% embed url="<https://app.supademo.com/demo/cmjguwpjm00a0yr0i8uqb5ka7?utm_source=link>" %}

## Text step-by-step guide:

1. **Enable Chat History** or **make group Public**
2. **Add Raidar to your group**, with one of the two options below&#x20;

### **Option 1:** From the bot's bio (Fastest)

1. **Click** [**@Raidar**](https://t.me/raidar)&#x20;
2. Open the bot profile
3. Tap **“Add to Group or Channel”**&#x20;
4. Select your group, and you are set - **Raidar loads with full admin rights automatically.**
5. Test the bot by entering the **/Options** command.

### Option 2: From the member's list

1. From your group's members list: Click on **add member**, then **add @Raidar** to your group
2. Promote @Raidar to **Admin.** Minimal rights to get Raidar operational:&#x20;

* Change Group Info
* Delete Messages
* Pin Messages

3. Test the bot by entering the **/options** command

<h3 align="center"><mark style="color:green;"><strong>Now Raidar is live in your group!</strong></mark> </h3>


# Customize your raid exprience

Learn how to customize your Raidar settings with this interactive demo

Raidar lets you insert your branding in various spots for free. See below how to add media (Image, Video, Gif) to the **raid message** and to the **leaderboard**.

{% embed url="<https://app.supademo.com/demo/cmjh7ouk201fxyg0iz25m1ik6?step=3&utm_source=link>" %}

### <mark style="color:green;">**Add a raid media (image, video, GIF)**</mark>

1. Type **/options** in your group&#x20;

<figure><img src="/files/xKgwK2ZsDoClYdSddI8m" alt="Choose in group, or in DM"><figcaption></figcaption></figure>

2. Tap **In Group** to open the options in the group or **In Private** to open the options in DM
3. Tap **Customization**

<figure><img src="/files/qjsn3MhqfZjVJCs9GzN0" alt="Here is the customization button"><figcaption></figcaption></figure>

4. Select **🖼 Raid Media**

<figure><img src="/files/PYFgjXZ4gTUfB6WUDWfq" alt="Choose &#x22;Raid Media&#x22;"><figcaption></figcaption></figure>

4. **Reply** with your **image, video, or GIF to Raidar's message**&#x20;

<figure><img src="/files/2vNo0UU8bVwbPDZofHSV" alt="Use this to set a custom media for your raids"><figcaption></figcaption></figure>

***

#### **Add a Leaderboard Banner (image, video, GIF)**

1. Type **/options** in your group&#x20;

<figure><img src="/files/xKgwK2ZsDoClYdSddI8m" alt="Choose in group or in DMs"><figcaption></figcaption></figure>

2. Tap **In Group** to open the options in the group or **In Private** to open the options in DM
3. Tap **Leaderboard**

<figure><img src="/files/SEp5nBfEmwgqPFR4vdb9" alt="Leaderboard button"><figcaption></figcaption></figure>

4. Tap **Banner**

<figure><img src="/files/gfWA9NqCovetni8osKId" alt="Banner button"><figcaption></figcaption></figure>

5. **Reply** with your **image, video, or GIF to Raidar's message**&#x20;

<figure><img src="/files/S4gSEj2qlb3oIYEHE5S3" alt="Insert custom media on your leaderboard "><figcaption></figcaption></figure>

<h3 align="center"><mark style="color:green;"><strong>Now Raidar reps your brand!</strong></mark> </h3>

***

**Raidar Customization FAQ :**

<details>

<summary>Can I upload a heavy raid media/banner?</summary>

Yes it is possible, but not recommended since it can increase load times on the user's side.

</details>

<details>

<summary>Can I change my raid media/banner?</summary>

Yes. Simply repeat the **/options** → **🖼 Raid Media** process.&#x20;

</details>

<details>

<summary>I sent a file, but Raidar doesn’t load it?</summary>

Make sure you're **replying** to the message where Raidar says **send your media**
\
Don't send it as a standalone message.

</details>

<details>

<summary>I uploaded media, but it’s not showing in raids?</summary>

**If a raid is** **already running**, use the command **/stop** in your group\
The media will appear on the next raid

</details>


# Send your group to Raidar Trending

Follow these steps to link your group to Raidar Trending board:

1. Open Raidar’s **Options/Settings** (**/options** or **/settings**)

<figure><img src="/files/xKgwK2ZsDoClYdSddI8m" alt="Choose to work with Raidar in DMs or in your group"><figcaption></figcaption></figure>

2. Tap **In Group** or **In Private**

<figure><img src="/files/7A40udDAO1SPBjbtKA1V" alt="Trending button highlighted"><figcaption></figcaption></figure>

2. Tap **Trending**

<figure><img src="/files/akTERn8WMMLHNVGDXhrU" alt="Reply here with your group&#x27;s Telegram name"><figcaption></figcaption></figure>

3. **Reply** to Raidar’s message with your group’s **@username** (e.g., @YourGroup)

<h2 align="center"><mark style="color:green;">Your group now appears on @R<strong>aidarTrending!</strong></mark></h2>


# How to start & stop a raid

Follow these steps to start and stop a raid in Raidar

## <mark style="color:green;">Starting a raid</mark>

### **Option 1: Direct Raid**

Launch a raid instantly with custom targets by entering the **/raid** command in the following format:

\
**/raid \<LINK> Likes, Reposts, Comments, Views, Bookmarks**

> **Example**:&#x20;
>
> /raid <https://x.com/TokenScan/status/182248876040954360> 80,65,40,500,70

***

### **Option 2: Indirect launch (with default targets)**

Start a raid using pre-configured default targets:

1. Enter **/raid \<LINK>** (or simply paste the link in chat, **if** **Link Detection is enabled**)
2. Click the **Raid** button that appears

The raid will automatically begin using your group’s default engagement targets

#### Change Raidar's default Targets&#x20;

* **Open Raidars options** Send the command **/options** in the chat
* Click the **Raids** button This opens the Raids configuration menu
* Click the **Default targets** button

<figure><img src="/files/goNIeccZ2Vcqoz0nLVCd" alt="Default Target button highlighted"><figcaption></figcaption></figure>

These values will be automatically used every time you launch a raid with **/raid \<LINK>**

## How to stop an ongoing Raid

You can stop a raid instantly with by entering the **/stop** command


# How to queue tweets

Managing the Tweet Queue in Raidar: How to Add, Prioritize, Delete, and Reorder Raids

To add tweets link to the queue, use the command: \
**/next \<LINK> Likes, Reposts, Comments, Views, Bookmarks**&#x20;

> **Example**: \
> /next <https://x.com/Raidar/status/1822599876040954360> 80,65,40,500,70

{% hint style="info" %}
You can load up to 10 links to raid! (and 20 with Raidar Pro)
{% endhint %}

{% columns %}
{% column valign="middle" %}
The command **/next**, used alone shows the queued links

{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/sFGkuqZWsBD1K1wTZMx2" alt="Sample tweet queue"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## **Delete a queued link:**

Simply enter **/delnext #**

Where **"#" is tweet's position** **in the queue**&#x20;

> **Example**: /delnext 4 will delete the fourth queued link.

{% hint style="info" %}
To remove the complete queue list, use the command **/clearnext**
{% endhint %}

## **Prioritize a queued raid**:

Use **/setnext + link + targets** to move a raid to the front of the queue. It will run as soon as the current raid finishes.

> **Example**: /setnext <https://x.com/Raidar/status/1875208811901837509?s=46> 50,20,40

## **Swap two raids in the queue:**

Use **/switchnext # #**, replacing each **#** with the positions you want to swap.

> **Example**: /switchnext 8 3: the third tweet will become eighth, and vice versa


# How to show & reset leaderboard

Learn how to view and reset your group's raid leaderboard to track your top raiders.

**What is the leaderboard?** The leaderboard ranks raiders by XP earned through engagement. Default XP values are:

❤️ Like: +5 XP 🔁 Repost: +4 XP 💬 Reply: +3 XP 🔖 Bookmark: +2 XP 👊 Smash: +14 XP

**Smash** is a single action that likes, reposts, bookmarks, and replies all at once via DM.&#x20;

{% hint style="info" %}
XP values can be customized in Raidar Pro.
{% endhint %}

## Show your group leaderboard

Use **/lb** to display your group's current raid leaderboard

{% columns %}
{% column valign="middle" %}
Raidar displays the top 10 raiders.&#x20;

Click **Extend** to show the full leaderboard

Want more detail? Filter the leaderboard by time period:

* **/lb** : All-time leaderboard
* **/lb 1d** : Last 24 hours
* **/lb 7d** : Last 7 days
* **/lb 30d** : Last 30 days

{% endcolumn %}

{% column valign="middle" %}

<div align="left"><figure><img src="/files/czhGtdnSCXJvAvFp9dnh" alt="Sample group leaderboard.  Notice the XP count"><figcaption></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

## Reset the leaderboard:

Use **/lbreset** to reset your group's raid leaderboard.

<div align="left"><figure><img src="/files/KgpbTy61wdqHHQD7Bvs3" alt="Reset your group&#x27;s leaderboard"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Note: this permanently deletes all leaderboard data. Use **/lb** to save a copy first.
{% endhint %}


# How to enable & set up Raid2Earn

Raid2Earn lets you reward your community with tokens for participating in raids.

{% embed url="<https://app.supademo.com/demo/cmjhnd3wi0003wh0ivchaylez?utm_source=link>" %}

## Step-by-step guide:

1. **Open settings** Type **/options** in your group chat to open the Raidar settings menu
2. Tap **Raid2Earn**.

<figure><img src="/files/kmL51c534sYnOhwmtpxI" alt="Raid2Earn button"><figcaption></figcaption></figure>

3. **Fund your group wallet** Raidar will generate a wallet for your group. Fund it with the token you want to use for rewards, plus a small amount of the chain's native token to cover gas fees.

<figure><img src="/files/7JWa6WW7aI6CLZtGdW2y" alt="Generated wallet appears here"><figcaption></figcaption></figure>

4. Tap **Reward Type** to enable Raid2Earn.

<figure><img src="/files/cWZsNBzLcHsQxYTpbCB9" alt="Click this button to choose the type of reward"><figcaption></figcaption></figure>

5. Select either **Single Raid** or **Campaign** mode:

{% columns %}
{% column %}

### <mark style="color:green;">Single Raid Mode</mark>

Rewards are distributed at the end of each raid, once the targets are reached. Each raider receives tokens based on the XP they earned during that raid.
{% endcolumn %}

{% column %}

### <mark style="color:green;">Campaign Mode</mark>

Admins set a start and end date for the campaign. Raiders accumulate XP across all raids during the campaign period, and rewards are distributed at the end based on total XP earned.
{% endcolumn %}
{% endcolumns %}

<figure><img src="/files/Ri3WjclI2djxj8YRwevv" alt="Single raid mode.  Set your threshold"><figcaption></figcaption></figure>

6. **Set your Threshold (Min. XP)** The threshold is the minimum XP a raider must earn before becoming eligible for rewards. XP earned below the threshold does not count.

*Example :*  *with a 50 XP threshold, a raider who earns 80 XP will only be rewarded for the 30 XP above the threshold.*

7. **Set your Ratio (XP/Token)** The ratio defines how many tokens are awarded per XP earned.

*Example : with a ratio of 1 token per XP, a like (worth 5 XP) earns the raider 5 tokens.*

***

### Campaign mode only:&#x20;

**Set an end date** Enter the campaign end date in UTC using this format: DD/MM/YYYY, HH:MM:SS

**Set a maximum budget** To calculate your campaign budget, multiply the following:

A — Number of raids planned&#x20;

B — Number of active raiders in your group&#x20;

C — Maximum XP per raid (14 XP)&#x20;

D — Token ratio (tokens per XP)

**Budget = A x B x C x D**

*Example: 30 raids, 100 raiders, 14 max XP, 10 tokens per XP = 420,000 tokens.*


# How to manually reward (tip) a user

Learn how to manually send a token reward to a specific user in your group

{% embed url="<https://app.supademo.com/demo/cmjia5vbp020wyf0in3guxmdb?utm_source=link>" %}


# FAQ (For Group Admin)


# As Raider


# Connect Your X (Twitter) Account to Raidar

Follow these quick steps to link your X account and start earning XP seamlessly:

{% embed url="<https://app.supademo.com/demo/cmjieaxuf01liyl0i86mpqhyy?utm_source=link>" %}

## Step-by-step guide:

1. Open a DM with [@Raidar](https://t.me/raidar) on Telegram.
2. Send **/login** in the DM chat.
3. Tap the 🔗 **Login** button that appears.

<figure><img src="/files/C3OAFu6YvZRnUTf7KU8R" alt="Connect your twitter account to earn points for raiding"><figcaption></figcaption></figure>

4. Click on **Authorize Raidar**&#x20;

<figure><img src="/files/ip1IGlJXxzqlLScrxZ1X" alt="Authorize the app to connect" width="492"><figcaption></figcaption></figure>

5. **Raidar** will confirm the connection.  You are now connected.&#x20;

<figure><img src="/files/TfCHj5yEkY1bZ1rYolsm" alt="confirmation confirmed!"><figcaption></figcaption></figure>

***

**Raidar connection FAQ :**

<details>

<summary>Is it safe to connect my Twitter (X) account ?</summary>

**Yes, it's totally safe!**

Raidar is built on the **official Twitter (X) API**, ensuring full compliance with X's security standards.

</details>

<details>

<summary>Can Raidar post something without my consent ?</summary>

No. Raidar will never post, tweet, or interact on your behalf without your explicit permission.

</details>

<details>

<summary>How to log out / Can I log out from Raidar at any moment ?</summary>

Yes, simply send **/logout** in your DM with Raidar.

</details>


# Set your wallet address (For R2E)

Follow these quick steps to set your wallet address in Raidar to receive R2E rewards

To receive Raid2Earn rewards, you need to link a wallet to your Raidar profile.

1. **Click** [@Raidar](https://t.me/raidar) to open a DM chat with Raidar.
2. Send **/setwallet** and follow the prompts to enter your address:  either by scanning a QR code or typing it manually.

<figure><img src="/files/zKeDDcrDpYf9QqPItJ0X" alt="Link your wallet to Raidar to earn!"><figcaption></figcaption></figure>

Raidar auto-detects the chain (EVM, Solana, or Sui). No wallet connection or signature required.

<details>

<summary>Can I connect more than one wallet?</summary>

You can set one wallet per chain: one EVM, one Solana, one Sui. Multiple wallets on the same chain are not supported.

</details>

<details>

<summary>Can I change my wallet address?</summary>

Yes, at any time. Send **/profile** in DM with @Raidar, tap **Unlink Wallet**, then run **/setwallet** again.

</details>

<details>

<summary>Is my wallet valid on all groups with Raidar?</summary>

Yes. Your wallet is linked to your Raidar profile and works in every group where Raidar is active.

</details>


# How to raid

Learn how to use Raidar's raid buttons to engage with tweets and earn XP.

{% embed url="<https://app.supademo.com/demo/cmjjozx72002pwl0htrmzcuvi?utm_source=link>" %}

## Step-by-step guide:

### Requirements

* Before raiding, make sure your X (Twitter) account is [connected](/raidar/start-raidar/as-raider/connect-your-x-twitter-account-to-raidar) to Raidar.&#x20;
* Stable internet connection

**Raiding a tweet** When a raid is active in your group, use the buttons under the raid message to engage with the tweet and earn XP:

<table><thead><tr><th width="125.10577392578125">Button</th><th width="426.89556884765625" align="center">How It Works</th><th width="97.0362548828125" align="center">Default XP Value</th></tr></thead><tbody><tr><td>💬 Reply</td><td align="center">Raidar will DM you, type your reply there and send it. Raidar posts it on your behalf.</td><td align="center">3</td></tr><tr><td>🔄 Retweet</td><td align="center">Instantly reposts the tweet on your profile.</td><td align="center">4</td></tr><tr><td>❤️ Like</td><td align="center">Instantly likes the tweet.</td><td align="center">5</td></tr><tr><td>🔖 Bookmark</td><td align="center">Bookmarks the tweet.</td><td align="center">2</td></tr><tr><td>👊 Smash</td><td align="center">Does all of the above in one tap.</td><td align="center">14</td></tr></tbody></table>

<details>

<summary>Will I earn XP if I like and then Smash (since Smash does all actions)?</summary>

No. Duplicate actions don't stack XP. Raidar counts each action once per tweet, so using Smash after already liking won't earn extra.

</details>

<details>

<summary>Can I raid the same tweet multiple times for more XP?</summary>

No. Each tweet gives XP once per user. Raidar tracks unique interactions to keep things fair.

</details>


# Check the leaderboard and XP

Learn how to check your XP and see where you rank on your group's raid leaderboard.

{% embed url="<https://app.supademo.com/demo/cmjjq3yd00640yf0iwtkkkcsl?utm_source=link>" %}


# Protect Your Telegram Group with Guardian

Meet Guardian, the Telegram bot that protects your group from spam, bots, and malicious actors.

Guardian is a Telegram chat management system specifically built to protect crypto communities from spam, bots, and malicious actors.

Using real-time monitoring and intelligent threat detection, Guardian identifies and neutralizes threats before they can disrupt your group. Whether it's scammers sliding into your chat, bot attacks, or unwanted content, Guardian handles it automatically so your admins don't have to.

**What Guardian does:**

**Integrated tools:** Guardian works seamlessly alongside all TokenScan products, giving admins a complete group management suite in one place.

**Advanced security:** Real-time monitoring and smart threat detection identify and mitigate risks as they happen. Overwatch adds an extra layer of protection with advanced anti-FUD capabilities.

**Chat management:** Manage your group directly from the chat interface, without jumping between menus or settings.

**Message control:** Auto-removes unwanted messages and detects flooding to keep your chat clean and on-topic.

The result is a cleaner, safer group where your community can focus on trading and growing together with peace of mind.

{% hint style="warning" %}
Always use [@GuardianApp](https://t.me/guardianapp). Watch out for fake bots!&#x20;
{% endhint %}


# Guardian commands list

A quick rundown of Guardian's commands list.

### Guardian - Telegram command reference

Type **/list** in your group chat to pull up this command list at any time.

#### General settings and modes

<table><thead><tr><th width="249.52911376953125">Command</th><th>Description</th></tr></thead><tbody><tr><td>/settings</td><td>Open the settings menu</td></tr><tr><td>/setup</td><td>Setup the portal</td></tr><tr><td>/delsetup</td><td>Delete the current portal setup</td></tr><tr><td>/service</td><td>Activate/Deactivate service messages</td></tr><tr><td>/antiflood</td><td>Enable/Disable Anti-Flood mode</td></tr><tr><td>/attack</td><td>Activate/Deactivate under attack mode</td></tr><tr><td>/language</td><td>Change the bot language</td></tr><tr><td>/disclaimer</td><td>Disclaimer</td></tr><tr><td>/disable</td><td>Disable the use of certain commands</td></tr><tr><td>/enable</td><td>Re-Enable the use of certain commands</td></tr><tr><td>/export</td><td>Export the current in-chat settings</td></tr><tr><td>/import</td><td>Import an in-chat setting from backup</td></tr><tr><td>/backups</td><td>Backups of all the groups' settings</td></tr></tbody></table>

#### Welcome message

<table><thead><tr><th width="250.171875">Command</th><th>Description</th></tr></thead><tbody><tr><td>/welcome</td><td>Activate/Deactivate the welcome message</td></tr><tr><td>/setwelcome</td><td>Reply to a message to set it as the welcome message</td></tr><tr><td>/delwelcome</td><td>Reset the welcome message</td></tr></tbody></table>

#### Filters & auto-replies

<table><thead><tr><th width="249.9410400390625">Command</th><th>Description</th></tr></thead><tbody><tr><td>/filter</td><td>Create auto-replies</td></tr><tr><td>/remove</td><td>Remove auto-replies</td></tr><tr><td>/filters</td><td>Show the current list of filters</td></tr></tbody></table>

#### Blacklist / Whitelist / Anti-FUD

<table><thead><tr><th width="249.866455078125">Command</th><th>Description</th></tr></thead><tbody><tr><td>/bl</td><td>Show the current blacklist, Add a word/phrase to blacklist</td></tr><tr><td>/unbl</td><td>Remove word/phrase from the blacklist</td></tr><tr><td>/wl</td><td>Show the current whitelist, Add a word/phrase to whitelist</td></tr><tr><td>/unwl</td><td>Remove word/phrase from the whitelist</td></tr><tr><td>/antifud</td><td>Enable/Disable Anti-FUD mode</td></tr></tbody></table>

#### Moderation

<table><thead><tr><th width="249.8948974609375">Command</th><th>Description</th></tr></thead><tbody><tr><td>/ban</td><td>Ban a user by the username or reply to a message</td></tr><tr><td>/unban</td><td>Unban a user by the username</td></tr><tr><td>/mute</td><td>Mute a user by the username or reply to a message</td></tr><tr><td>/unmute</td><td>Unmute user by the username</td></tr><tr><td>/muteall</td><td>Mute the chat</td></tr><tr><td>/purge</td><td>Delete from selected message until last sent</td></tr></tbody></table>

Last updated 1 year ago


# Start Guardian

Guardian protects your Telegram group in two ways: moderation inside the chat, and a portal that screens new members before they can join.

The portal is a dedicated channel where new members land when they try to join your group. It presents a welcome message with an image or video, and a **Verify** button they must tap to gain access. This stops bots and bad actors from entering automatically.

Guardian can function without a portal, but setting one up is recommended for full protection.

**Setting up your portal**

Before you begin, make sure you have created both a Telegram group and a channel.

**Step 1:** Send **/setup** in DM with Guardian.

**Step 2:** Select your group.

**Step 3:** Select your channel.

**Step 4:** Guardian will confirm the connection. Your portal is now active and your group is protected.

{% hint style="info" %}
Once Guardian is set up, type **/settings** in your group to access the full settings console, where you can manage all of Guardian's features in one place.
{% endhint %}


# Add & Edit Portal

Learn how to add and edit a Guardian portal with this interactive Demo

### Add a portal

{% embed url="<https://demo.tokenscan.app/demo/cmjl9pr7u08gtyf0iyb8dzyaz>" %}

### How to edit a portal:

1. **Open the edit menu** On desktop, right-click the portal image. On mobile, tap and hold it. Edit options will appear.
2. **Pin the Verify button** Select the pin option to keep the Verify button pinned at the top of the channel so it's always visible to new members.
3. **Edit text, image, or video** Select Edit to update the portal's text, image, or video.
4. **Confirm your changes** Review the portal to make sure everything looks correct.

{% hint style="info" %}
If you use a video, compress it before uploading so it loads quickly for users on slow connections. mp4compress.com is a good free option.
{% endhint %}


# Settings

## Settings console

The settings console contains most of the in-chat management functions.

With a simple command **/settings** bring out an all-in-one settings console.

The settings console provides an overview of almost all the setups and commands available within Guardian.


# Captcha Type

Learn how to set up Portal Captcha or Join-CAPTCHA in Guardian to screen new members and keep bots out of your Telegram group.

Guardian offers two options for screening new members at the door.

**Portal Captcha (recommended)** New members are directed to your portal channel, where they complete a simple verification before being admitted to the group.

{% columns %}
{% column valign="middle" %}
To enable, type **/settings** in your group chat, choose whether to open settings in private or in group, then tap **Entry Security** > **CAPTCHA** > **Portal**.

{% endcolumn %}

{% column valign="middle" %}

<figure><img src="/files/TH7sSepBQLuEEwFYUUIT" alt="Guardian Settings"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Portal Verification steps for users:

<div align="left"><figure><img src="/files/kQ1vbdW3Xh5FmlXVC1gF" alt="Tap to verify" width="162"><figcaption><p>Tap the button to verify</p></figcaption></figure></div>

<div align="left"><figure><img src="/files/2oOKp3nthQMhexFP0exq" alt="Launch Guardian" width="172"><figcaption><p>Launch Guardian<br>(appears the first time you use)</p></figcaption></figure></div>

<div align="left"><figure><img src="/files/GoZmgKPMgthQJkYXhtOi" alt="Verify" width="188"><figcaption><p>Click Verify in the miniapp that launched<br>and you're in!</p></figcaption></figure></div>

***

**Join-CAPTCHA** Prefer not to use a portal but still want to keep bots out? Join-CAPTCHA lets you keep your group public while muting new members until they complete verification.

To enable, type **/settings** in your group chat, choose whether to open settings in private or in group, then tap **Entry Security** > **CAPTCHA** > **Join-CAPTCHA**.


# Welcome Message

Learn how to set up and customize a welcome message for new members joining your Telegram group with Guardian.

Greet new members with relevant information when they enter, so they can make buying decisions quicker.

{% embed url="<https://demo.tokenscan.app/demo/cmjlr4etu01l2xy0icg0jsb9q?utm_source=link>" %}

Guardian automatically sends a welcome message to every new member who joins your group.

To edit it, type **/settings** in your group chat, choose whether to open settings in private or in group, then tap **Welcome** > **Edit**. Reply with your custom welcome text.

You can use the following placeholders in your message:

{NAME} : the user's display name {MENTION} : a clickable link to the user {GROUPNAME} : your group name


# Filters

Learn how to create automatic replies and manage message filters in your Telegram group using Guardian.

Set message filters in the chat group for auto-replies

{% embed url="<https://app.supademo.com/demo/cmjmjbfvh000xwb0jc4lyncyk?utm_source=link>" %}

**Filters**

Filters let you set up automatic replies to specific keywords or phrases in your group. They're useful for answering frequently asked questions, sharing links, or responding to common requests.

For example, if someone types "website", Guardian can automatically reply with your project's URL.

**/filter** : Create a new filter and auto-reply **/filters** : View all active filters **/remove "filter"** : Remove a filter

To add a button to a filter reply, append the following to the end of the reply text: /\* Button Label \*/

**Disable/enable commands**

If a Guardian command conflicts with another bot, you can disable it with **/disable** and re-enable it with **/enable**.


# Moderation

Learn how to use Guardian's moderation tools to keep your Telegram group clean, including anti-flood, blacklists, whitelists, and Overwatch.

Other than keeping the botters at the door, in-chat moderations are in fact the most important part in making a chat group clean and Guardian makes it easy for you to do so.

{% embed url="<https://app.supademo.com/demo/cmjmkokbt001twb0jbazrkm7y?utm_source=link>" %}

**Moderation**

In-chat moderation is where Guardian really shines. Type **/settings** in your group chat, choose whether to open settings in private or in group, then tap **Moderation** to access all moderation options.

**Anti-Flood** Deters message flooding in the group. The higher the security level, the stricter the rules and the harsher the punishment. Use **/antiflood 1, 2, or 3** to set the level, or choose from **Disabled**, **Standard**, **Moderate**, and **Under Attack** modes.

**Anti-Contract** Removes messages containing 0x contract addresses. Use **/wl** to whitelist contracts you want to allow.

**Anti-Link** Removes messages containing links. Use **/wl** to whitelist approved links.

**Anti-Forward** Removes forwarded messages.

**Anti-Invite** Removes messages containing group invites.

**Overwatch** Combines Guardian's internal algorithms with AI detection to remove harmful or guideline-violating messages. Enabling **Overwatch** automatically enables Anti-Phishing, Anti-Virus, Anti-NSFW, and Anti-FUD, each of which can also be toggled individually.

**Whitelist** Add words, links, or contracts that should be exempt from moderation rules.

To add an entry: use **/wl** in chat, for example **/wl** **TokenScan.app**. Guardian will confirm it has been whitelisted. To remove a single entry: use **/unwl**, for example\
&#x20;**/unwl** **TokenScan.app**. To remove all entries: tap **Clear** in the Whitelist menu.

**Blacklist** Block specific words or links from being sent in your group. Any message containing a blacklisted term will be automatically removed.

To add an entry: use **/bl** in chat, for example **/bl spamlink.com**. Guardian will confirm it has been blacklisted. To remove a single entry: use **/unbl**, for example **/unbl spamlink.com**. To remove all entries: tap **Clear** in the Blacklist menu.


# Guardian Buybot

Learn how Guardian's built-in buybot announces token purchases in your Telegram group, and which chains and protocols are supported.

**Guardian Buybot**

Guardian includes a built-in buybot that announces token purchases directly in your group. It supports multiple chains and can be fully customized to match your community's style.

**Supported protocols:**

ETH, BASE, BNB, ARB, POLY, AVAX, MON : Uniswap (V2, V3), SushiSwap (V2), PancakeSwap (V2) CHZ : FanX (formerly KayenSwap) INK : InkySwap SOL : Jupiter (V6), Raydium (V4, Route, CPMM, ConcentratedLiquidity), [Pump.fun](https://pump.fun/)

### How to add & set Guardian's buybot

{% embed url="<https://demo.tokenscan.app/demo/cmjmxiufp058duo0ir526bkul?utm_source=link>" %}

### How to customize Guardian's buybot in-group messages

{% embed url="<https://demo.tokenscan.app/demo/cmjnbygwa003nxj0i60aep102?utm_source=link>" %}


# Attack Mode

When bots start acting like humans, Guardian's Attack Mode uses AI to detect and permanently blacklist them across every Guardian-protected group.

**Attack Mode**

Portals and captchas are great at keeping bots out, but what about bots that mimic human behavior? That's where Attack Mode comes in.

Type **/attack** in your group to enable it. Guardian's AI will scan for unusual behavior and, upon detection, will immediately remove and blacklist the user across all current and future Guardian-protected groups.

Sometimes when you check the ban history, it's shocking to see how many have been lurking across groups, waiting to strike. Fortunately, they only get one chance.

The Guardian AI has blacklisted more than 5,000 bad actors to date. Every time an admin uses **/attack**, the whole Guardian ecosystem gets a little safer.


# Account Checks

Guardian's Account Checks block bots with suspicious names before they even reach the verification step, keeping your group cleaner from the start.

Guardian can screen new members before they even reach the verification step, blocking common bot patterns at the door.

{% columns %}
{% column valign="middle" %}
Pretty sure you've seen this before...

Bots joining groups with contract addresses in their display names, in effect mass-spamming scrapers scanning for new tokens. It's irritating, and it can affect traders scanning for legitimate tokens.

{% endcolumn %}

{% column %}

<div align="left"><figure><img src="/files/c33921ad14313339304f6d8c7b76b1cc05dad6fb" alt="Bots join groups with Contract addresses in their names to trigger scans"><figcaption><p>Bots joining group</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

Enabling **0x Address Check** will solve the problem.

Enabling this check blocks any account using an Ethereum-style 0x address as their display name from passing verification.

<div align="left"><figure><img src="/files/cc26d95e149fc85a6e1424abdea1952f25c33a0c" alt="This appears when a bot is prevented from joining"><figcaption><p>Restricted due to CA in name</p></figcaption></figure></div>

Similarly, **Link Check** blocks accounts whose display names contain URLs or website-like text.

Both checks can be enabled in your Guardian settings.

<div align="left"><figure><img src="/files/cdaf33746bee47180381929b7482bf70b063162e" alt="Guardian also filters out links in names"><figcaption><p>Restricted due to links in name</p></figcaption></figure></div>


# Managing Backups

Learn how to export, import, and manage Guardian settings backups so you can quickly move your configuration to a new group.

Moving to a new group but don't want to set everything up again?

Guardian saves your group settings automatically. If Guardian is removed and re-added to the same group, your settings are restored without any reconfiguration needed.

**Moving to a new group?** Use **/export** to export your current settings, then **/import** in the new group to apply them.

**Checking your backups** Send **/backups** in DM with Guardian to see all saved backups.

<div align="left"><figure><img src="/files/1f53230d85209f912f61828e02f5a55561db526d" alt="Backup your data!"><figcaption><p>Check backups screenshot</p></figcaption></figure></div>

**Public vs. private backups** By default, backups are private and can only be imported by the person who exported them. If you want another admin to be able to import the settings, you can make the backup public.

<div align="left"><figure><img src="/files/e9320f8d8d14a89f825cff9027c1c7dca42749d9" alt="Choose to make your backup private or public"><figcaption><p>Private vs public screenshot</p></figcaption></figure></div>