# Welcome to Odin Tools

<div align="center"><figure><img src="/files/4kOwzdA7fFg4PXrKHxgD" alt="" width="563"><figcaption></figcaption></figure></div>

Odin Tools is a suite of professional Telegram bots built on the Solana network. Our infrastructure has been operating reliably for over one year, supporting projects and communities across the ecosystem.

Our focus is to deliver secure, efficient, and easy-to-use utilities that support teams, traders, and Web3 builders in their daily operations - providing the tools required to manage, protect, and operate with confidence while creating long-term value.

***

## Ecosystem

Odin Tools is powered by the $ODIN ecosystem. We are committed to sustainable growth, continuous development, and long-term alignment with our community.

Our revenue share model supports ongoing innovation while ensuring that the ecosystem grows stronger over time.

***

### Odin Tools Utilities

Odin Tools offers powerful utilities such as:

* [**Protection bot - Heimdall**](/tools/heimdall-protection-bot)
* [Trading bot - Thor](https://t.me/ThorSolana_bot?start=r-gitbook)
* [Raid Bot - Freya ](https://t.me/Freya_raid_bot)


# Thor - Telegram Bot

Official Telegram Tag: @ThorSolana\_bot

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

### Meet Thor — The Ultimate Solana Trading Bot

Thor is your all-in-one trading bot for the Solana blockchain, built for speed, simplicity, and performance. Designed to help both beginners and experienced traders execute fast trades in a fast-moving market.

***

### Key Features

| Feature                | Description                                     |
| ---------------------- | ----------------------------------------------- |
| **Auto Buy / Sell**    | Automate entries and exits without manual input |
| **Pro Trader Mode**    | Advanced controls for power users               |
| **Copy Trading**       | Mirror top-performing wallets automatically     |
| **Trailing Stop-Loss** | Lock in profits with dynamic stop management    |
| **Nuke All**           | Close all positions instantly in one click      |

***

### Links

* **Telegram Bot:** [Thor Trading Bot](https://t.me/ThorSolana_bot)
* **Website:** [odin.tools](https://odin.tools)
* **Twitter/X:** [@odincoinsol](https://twitter.com/odincoinsol)

***

### Disclaimer

Trading cryptocurrencies and tokens involves significant risk. Always conduct your own research and carefully evaluate potential risks before making financial decisions.

Thor is a software tool designed to facilitate trading. It does not provide financial advice. The team assumes no responsibility for losses, damages, or issues resulting from the use of the platform.

***


# Activation

### **Step 1: Launch the Bot**

Open Thor @ThorSolana\_bot Bot via the official link or through Telegram. Click on or type in `/start` to run Thor.

<div align="left"><figure><img src="/files/jG4bPtn4wWoQ94P9obKg" alt="" width="375"><figcaption></figcaption></figure></div>

### **Step 2: Fund Your Wallet**

**Once you start Thor, it will display your wallet address. To start using it:**

* **Send SOL** to this address.
* As soon as the deposit is confirmed on-chain, you'll be ready to trade.\
  You can view your balance anytime within the bot.

<div align="left"><figure><img src="/files/Wqs0xOCzaKl5yf41psR0" alt="" width="395"><figcaption></figcaption></figure></div>

***

### **How to Find a Token with Thor**

Thor supports multiple ways to look up a token:

**1. Paste a Contract Address**&#x20;

**2. Forward a Buy Bot Message**&#x20;

**3. Share a PumpFun or DexScreener Link**&#x20;

**4. Type the Token Symbol**&#x20;


# Keyboard Layout

Customize your quick buy buttons and UI preferences for the Buy & Sell menu.

***

### Buy Layout

Customize your quick buy buttons and UI preferences for the Buy menu.

**Quick Buy Buttons**

Each button can be set to a fixed SOL amount, a percentage of your balance, or a dollar value.

* `%` — percentage of your available SOL balance
* `SOL` — fixed SOL amount
* `$` — fixed dollar amount

Example: `25%` buys with 25% of your balance. `0.5 SOL` buys exactly 0.5 SOL. `$10` buys exactly $10 worth.

Tap any button to edit its value.

**UI Customization**

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| **Slippage Selection** | Show or hide slippage buttons                     |
| **Show Holdings**      | Show or hide your current position                |
| **Detailed Holdings**  | Toggle between full position details or PNL only  |
| **Show Swap Info**     | Show or hide swap details (amounts, price impact) |

***

## Sell Layout

Customize your quick sell buttons and UI preferences for the Sell menu.

**Quick Sell Buttons**

Each button represents a percentage of your current token balance.

Example: `25%` sells 25% of your tokens.

Tap any button to edit its value. Tap `+ Add` to add a new button (max 5). Type `0`, `-`, or `remove` when editing to delete a button (min 3).

**UI Customization**

| Option                 | Description                                       |
| ---------------------- | ------------------------------------------------- |
| **Slippage Selection** | Show or hide slippage buttons                     |
| **Show Holdings**      | Show or hide your current position                |
| **Detailed Holdings**  | Toggle between full position details or PNL only  |
| **Show Swap Info**     | Show or hide swap details (amounts, price impact) |

***

### How to Customize Your Buy & Sell Layout

1. Open Thor and go to **Settings**

<div align="left"><figure><img src="/files/WwG6Po3TlKRGmyWfQXU4" alt="" width="402"><figcaption></figcaption></figure></div>

2. Select **Buy/Sell Layout**

<div align="left"><figure><img src="/files/ATNZdPN05T5AZavkEkXZ" alt="" width="402"><figcaption></figcaption></figure></div>

3. Tap any button to edit its value

<div align="left"><figure><img src="/files/54fohq8RgGIiYoBDyIid" alt="" width="404"><figcaption></figcaption></figure></div>

4. For Sell Layout, tap **+ Add** to add a new button or type `0` to remove one

<div align="left"><figure><img src="/files/hRdFjISw2TNXCWOpdYJA" alt="" width="401"><figcaption></figcaption></figure></div>

5. Toggle UI elements on or off under **UI Customization**

<div align="left"><figure><img src="/files/YMkukdmKhqWOwvD1Eyim" alt="" width="404"><figcaption></figcaption></figure></div>


# Priority Fee Setup

To stay competitive in fast-moving markets, Thor allows you to set a **priority fee** for your transactions.

***

### **What is a Priority Fee?**

A priority fee is an additional fee paid to validators that helps your transaction get processed faster. This can be important during periods of high network activity.

With a priority fee, your transaction is more likely to:

* Be confirmed more quickly
* Be processed before competing transactions

***

### **How to Set a Priority Fee**

1. Open **Settings**

<div align="left"><figure><img src="/files/9uHeTTFEznNuwl6KbSLS" alt="" width="395"><figcaption></figcaption></figure></div>

2. Choose whether you want to adjust the **Buy Priority Fee** or **Sell Priority Fee**

<div align="left"><figure><img src="/files/h6CBt1kEINFeTIWhKX1Y" alt="" width="392"><figcaption></figcaption></figure></div>

3. Select one of the preset options or enter a **custom fee value**

<div align="left"><figure><img src="/files/1eokoRw24qWq5hvnuCYG" alt="" width="360"><figcaption></figcaption></figure></div>

Once set, Thor will automatically include the priority fee with your transactions to help ensure faster execution.


# Wallet Management

Thor allows you to operate multiple wallets effortlessly, making it ideal for multi-strategy trading, asset segregation, and efficient portfolio management, while maintaining full control and flexibility over each wallet.

***

### **Maximum Wallets**

You can generate **up to 10 wallets** within the bot. Each wallet functions independently and can be:

* Funded separately
* Used to execute trades
* Switched between instantly

***

### **Switching Wallets**

To switch wallets:

1. Use the `/wallet` command or tap the wallet menu.
2. Select the wallet you want to activate.

<div align="left"><figure><img src="/files/N1LVDBvPCMP43ORKPgqX" alt="" width="396"><figcaption></figcaption></figure></div>

***

### **Export & Withdraw Anytime**

You're in full control. You can:

* **Export** your private keys
* **Withdraw funds** to any external wallet
* Manage your assets without restriction

Thor is non-custodial — **you always own your keys.**


# Pro Trader Mode

Pro Trader is a combined Buy + Sell interface designed for fast, one-tap trading — everything you need in a single view.

***

### Why Use Pro Trader?

Speed is everything in memecoin trading. Pro Trader removes every unnecessary step between you and execution — no confirmation popups, no wasted seconds. Whether you're scaling in, taking partials, or cutting a loss, everything happens in one tap from one screen.

***

### What You Get

| Feature           | Details                                                  |
| ----------------- | -------------------------------------------------------- |
| Unified interface | Buy and Sell in one screen                               |
| One-tap execution | No confirmation step — trades fire instantly             |
| Shared slippage   | One setting applies to both Buy and Sell                 |
| Limit orders      | Set buy and sell limits from the same screen             |
| Trailing stops    | Available directly in the Sell section                   |
| Wallet management | Switch wallets or deposit SOL without leaving the screen |

***

### How to Enable

1. Open Thor Trading Bot

<div align="left"><figure><img src="/files/nZ6uiAnuhSztaJBsUhFW" alt="" width="404"><figcaption></figcaption></figure></div>

2. Go to **Settings → Trading Settings**

<div align="left"><figure><img src="/files/TgY8g4lhYAtckO8mwj5F" alt="" width="394"><figcaption></figcaption></figure></div>

3. Toggle **Pro Trader** on

<div align="left"><figure><img src="/files/aPsAHKsRGO0YcyZaD2dN" alt="" width="402"><figcaption></figcaption></figure></div>

Once enabled, the Pro Trader view loads automatically whenever you navigate to a token.

***

### How to Trade

**Buying** Tap any preset amount — **0.1 SOL, 0.2 SOL, 1 SOL, 2 SOL, 1.25 SOL** — or use **Custom** to enter your own. (Note: Entering a custom amount will trigger the buy instantly — no additional confirmation needed).

**Selling** Tap a sell percentage — **15%, 50%, 100%** — or use **x%** to enter a custom amount.

**Limit & Trailing** Switch between **Swap**, **Limit**, and **Trail** at the top of the interface to access advanced order types.

<div align="left"><figure><img src="/files/4xmaUe4P9z5wTDgEDSBm" alt="" width="356"><figcaption></figcaption></figure></div>

***

### Wallet Management

Tap **Wallets** at the top of the screen to:

* Switch between your connected wallets instantly
* Deposit SOL directly without navigating away

Your current wallet balance and holdings are always visible at the top of the Pro Trader view.


# Auto-Buy

AutoBuy instantly purchases a token using your predefined wallet, amount, and fee settings — no confirmation required.

***

### **How it works**

Once enabled, AutoBuy will:

* Automatically execute a purchase when a contract address is sent or forwarded, including any link or message containing a contract address. Buybot messages are also supported.
* Bypass the confirmation step to ensure the transaction is processed immediately.
* Utilize your default wallet, pre-configured purchase amount, and selected priority fee settings.

***

### **Setup Instructions**

1. Go to **Settings**.

<div align="left"><figure><img src="/files/iE4scamJNqsc5DxFnHTV" alt="" width="395"><figcaption></figcaption></figure></div>

2. Open **Trading Settings**.

<div align="left"><figure><img src="/files/A3Nu1nlokJ5IbtHj6sNh" alt="" width="402"><figcaption></figcaption></figure></div>

3. Enable **AutoBuy** by toggling it on.

<div align="left"><figure><img src="/files/AymahCeI2RqVnMJaNjxY" alt="" width="394"><figcaption></figcaption></figure></div>

4. Configure your default wallet, purchase amount, and priority fee settings.

<div align="left"><figure><img src="/files/cTTK4Znvaf9IhM6PHBps" alt="" width="398"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Note: Only use AutoBuy if you are certain about the contract address and have sufficient wallet balance.
{% endhint %}

***


# Auto-Sell

## Auto Sell — (Take Profit & Stop Loss)

Auto Sell watches your position and sells automatically — no need to monitor the chart manually.

Set one or multiple TP and SL levels and Thor handles the rest. You can also choose between three sell modes to control exactly how your tokens are sold across multiple buys.

**Take Profit (TP)** — Triggers when the price hits your target gain. Example: +50% sells when the token is up 50% from your entry.

**Stop Loss (SL)** — Triggers when the price drops to your set threshold. Example: -30% sells if the token falls 30% from your entry.

***

### **Three Target Types**

Take Profit – Sells when price goes up by your set percentage. +100% = sells when it doubles.

Stop Loss – Sells when price drops by your set percentage. -30% = sells if it drops 30%.

Trailing Stop – A stop loss that moves up with the price but never back down. Rides the pump, sells on the pullback. Instead of cashing out at 2x with a fixed TP, a trailing stop could catch 4x, 10x, or more.

***

### **Two Sell Modes**

**Full Balance** – Treats your whole bag as one position. If you buy more, the sell amount adjusts automatically. Simple: "sell X% of everything I hold."

**Per Position** – Each buy lives on its own. Buy #1 and Buy #2 get separate sell orders that don't affect each other. More control, especially if you get tokens from airdrops or other sources.

**DCA Mode**

When you buy the same token multiple times, DCA merges everything into one averaged position. Your targets recalculate based on the new average entry – so you can profit at a lower price instead of waiting for a full recovery.\
\
Learn more here -> [Auto-Sell](https://odin.tools/blog/autosell-vs-limit-orders-solana-guide-2026)

***

### **Setup**&#x20;

1. Go to **Settings**.

<div align="left"><figure><img src="/files/zW72O72vU0OroaVok2tl" alt="" width="395"><figcaption></figcaption></figure></div>

2. Click on **Trading Settings**.

<div align="left"><figure><img src="/files/uDxOF5FBETbYglTYqT4B" alt="" width="402"><figcaption></figcaption></figure></div>

3. Enable **Auto Sell** by toggling it on.

<div align="left"><figure><img src="/files/JWkHdqbm6nrYsx74Jx9L" alt="" width="395"><figcaption></figcaption></figure></div>

4. Configure your sell mode, Take Profit & Stop Loss and slippage — then enable Auto Sell.

<div align="left"><figure><img src="/files/anYQPXNyo8tQYfmix86C" alt="" width="401"><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Note:** Auto Sell rules only apply to new trades opened after enabling the feature — not to existing positions.
{% endhint %}


# Limit Orders

Limit orders lets you automatically buy when your target price hits — perfect for catching dips without watching charts all day.

***

### How to Set It Up

1. **Open Thor Bot** on Telegram.
2. Enter the **token contract address (forward or drop the ticker)**
3. When the trade panel appears, select **BUY WHEN**.

<div align="left"><figure><img src="/files/cEfEMpWszHCz5wKllOVS" alt="" width="398"><figcaption></figcaption></figure></div>

* Choose how much **SOL** to spend or enter a custom amount.
* Set your **target price** by pressing **Set Trigger Pric**

<div align="left"><figure><img src="/files/soamPdRqX61Fg25A8EVW" alt="" width="400"><figcaption></figcaption></figure></div>

### Setting Your Trigger Price

When creating a **Limit Buy** order, you can tell Thor **when** to buy using any of these formats:

**Options:**

**Percentage change:**

`-5%` → buy if price drops 5%

`5%` → buy if price rises 5%

**Exact price:**

`0.0045` → buy when price hits 0.0045

**Market cap target:**

`5.5M mc` → buy when market cap hits 5.5 million

`10k mcap` → buy at 10,000 market cap

**Supported suffixes:**

`k` = thousand

`m` = million

`b` = billion

**Examples:** `1%`, `10%`, `5.5M mc`, `15000 mcap`, `10m mcap`, `10k mcap`, `10b mcap`, `150k`

<div align="left"><figure><img src="/files/3MltF6MCZS6PQT73SIB1" alt="" width="397"><figcaption></figcaption></figure></div>

Choose how long the order should stay active by pressing Expiration. Enter expiration\
(m = minute, h = hour, d = day, w = week): Examples: 15m, 5h, 2d, 1w**1 hour**, **24 hours**, or **3 days**.

Tap **Create Order** — your limit-order is active now!

<div align="left"><figure><img src="/files/wxZhPiXAbCWh6sn6SS0y" alt="" width="400"><figcaption></figcaption></figure></div>

***

You can view all the active limit orders by pressing **/Start** and then press on **Limit Orders. Here you can create or remove any buy/sell orders.**

<div align="left"><figure><img src="/files/HNHQe4RKcJOLfn4BMvQf" alt="" width="407"><figcaption></figcaption></figure></div>

**Tip:** Combine Limit Buy with Thor’s **Auto Sell** or **Trailing Stop-Loss** to fully automate your entry and exit strategy.


# Trailing Stop-Loss

### What is a Trailing Stop-Loss?

A **Trailing Stop-Loss** is an advanced version of a standard stop-loss.

Instead of remaining fixed, the stop price **automatically moves upward as the token price increases**. This allows you to **lock in profits while limiting downside risk**, making it ideal for capturing strong momentum without giving back gains during pullbacks.

***

### Example

You set:

* **Take Profit:** +200%
* **Stop Loss / Drawdown:** -40%

If the token pumps **+190%** and then starts to drop, the outcome depends on whether the trailing stop is enabled.

| Scenario                   | Result                                                                                                                                                   |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Without Trailing Stop-Loss | The position stays open until the price drops to **-40%**, which can turn a profitable trade into a loss.                                                |
| With Trailing Stop-Loss    | The stop price **moves upward with the price**, securing profits. If the price peaks at **+190%**, the stop adjusts to about **+74%**, locking in gains. |

***

### Formula

The trailing stop is calculated using the following formula:

\text{Stop Price} = \text{Highest Price} \times (1 - \text{Drawdown})

Example calculation:

| Highest Price Reached | Drawdown | Stop Price |
| --------------------- | -------- | ---------- |
| +190%                 | 40%      | +74%       |

This means the trade will **automatically close in profit** if the price drops to that level.

***

### How to Enable Trailing Stop-Loss

{% hint style="info" %}
Trailing Stop-Loss Setup Tutorial: [YouTube](https://youtube.com/shorts/Z-GTnAjdH1I)&#x20;
{% endhint %}

| Step | Action                                                                                                                            |
| ---- | --------------------------------------------------------------------------------------------------------------------------------- |
| 1    | <p>Open <strong>Settings</strong><br></p><p><img src="/files/iPwaPHEVCzib5SVv2IfK" alt="" data-size="original"></p>               |
| 2    | <p>Click on <strong>Trading Settings</strong><br></p><p><img src="/files/DetdqCm9KdfOKXKNKf9E" alt="" data-size="original"></p>   |
| 3    | <p>Enable <strong>Auto Sell</strong><br><br><img src="/files/neNAlHNllcwpbzUMyIoT" alt=""></p>                                    |
| 4    | <p>Activate <strong>Trailing Stop-Loss</strong><br></p><p><img src="/files/NRlfWKSk1chd8eYwfTMc" alt="" data-size="original"></p> |


# Copy Trade

### Copy Trading

Copy Trading lets you **automatically mirror another wallet's trades on Solana**.\
Whenever the tracked wallet buys or sells a token, your wallet follows suit according to your settings effortless and precise.

***

### Buying Methods

Customize how your wallet copies trades:

* Fixed amount per trade
* Percentage of your current position
* Set limits and conditions for smarter execution

***

### Selling Methods

Your wallet automatically follows the tracked wallet’s selling actions.

**Example:** If the copied wallet sells **10%**, your position also sells **10%**.

***

### Risk Filters

Keep your trades under control with:

* Maximum trade size
* Token filters (choose which coins to copy)
* Slippage limits
* Minimum liquidity settings

***

### Important Notes

⚠️ **Copy trades may fail due to:**

* Low SOL balance
* Slippage settings
* Network congestion
* Low priority fee

The system **retries failed trades 1–3 times** depending on the error.

***

### Copy Trade Set-up

| Step | Action                                                                                                                                                  |
| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | <p>Open Copy Trade<br></p><p><img src="/files/CNbhGrlQqTGwQ8UH6Qgm" alt="" data-size="original"></p>                                                    |
| 2    | <p>Create a <strong>New Copy Task</strong><br></p><p><img src="/files/i9v6qSwjiLVUHU4gsvNF" alt="" data-size="original"></p>                            |
| 3    | <p>Enter the <strong>wallet address</strong> you want to copy<br></p><p><img src="/files/PL19WqXXBXmiI6vRJPi5" alt="" data-size="original"></p>         |
| 4    | <p>Configure <strong>buy method, selling method, and filters</strong><br></p><p><img src="/files/5YKWBYI3Nawq1kfPFC6G" alt="" data-size="original"></p> |
| 5    | <p>Save the task to start copy trading<br></p><p><img src="/files/E6Dx381RNWiDgPA2b7qC" alt="" data-size="original"></p><p></p>                         |


# Nuke All

Nuke All sells every token across all your connected wallets in a single action. It is designed as an emergency exit button for situations where you need to close all positions instantly.

Once enabled, the Nuke All button appears on the home screen between Buy and Positions.

**This action is irreversible. Use only in emergencies.**

<div align="left"><figure><img src="/files/IQUOCvn0O3lOHygPK766" alt="" width="404"><figcaption></figcaption></figure></div>

***

### **What it does**

* Sells all tokens across all connected wallets at once
* Executes immediately with no confirmation step
* Cannot be undone

***

### **Setup**

1. Go to settings

<div align="left"><figure><img src="/files/lyPpXfQbTaJfiX0cPIJ0" alt="" width="402"><figcaption></figcaption></figure></div>

2. Toggle Nuke All on

<div align="left"><figure><img src="/files/TsP1o3bDYnet4UrYa0jT" alt="" width="396"><figcaption></figcaption></figure></div>

Only enable this feature if you need a fast exit option readily available.


# FAQ

### Thor Trading Bot FAQ – Essential Questions

#### 🔐 Is Thor Bot safe?

Yes. Thor is a non-custodial trading bot, meaning you remain the owner of your private keys. Wallets are securely managed server-side, and private keys can only be accessed through requests made via the bot.

***

#### 💳 Which tokens and chains can I trade?

* Currently: **SOL and Solana-compatible tokens**
* Coming soon: BNB chain and other major networks\
  Thor is regularly updated to expand token and chain support.

***

#### ⚡ How fast are trades executed?

Speed depends on **network congestion** and **priority fees**. Setting a higher priority fee improves execution during high-volume launches.

***

#### 🛠 Can I manage multiple wallets?

Yes. Thor allows **up to 10 wallets per user**, ideal for:

* Multi-strategy trading
* Asset segregation
* Testing different copy trading setups

***

#### 🤖 Can I customize AutoBuy and AutoSell?

* **AutoBuy** and **AutoSell** can be toggled on/off anytime.
* You can set **trade limits, risk filters, and token preferences** for safer automation.

***

#### 💰 How does cashback work?

* Calculated monthly based on total trading volume
* Automatically credited to your wallet or bot balance
* Higher tiers unlock **better cashback rates**

***

#### ⚠️ How can I prevent failed trades?

* Keep enough **SOL for fees**
* Avoid extremely low priority fees
* Adjust **slippage and trade size limits**
* System retries failed trades 1–3 times automatically

***

#### 📈 What is Copy Trading, and how does it work?

* Mirror trades from another wallet automatically
* Buy/sell actions follow the **percentage settings you choose**
* Risk filters allow you to limit trade size and token exposure

***

#### 🆘 What if I make a mistake with funds?

Thor is **non-custodial**. If funds are sent to the wrong address, **they cannot be recovered**. Always double-check wallet addresses before sending.

***

#### 📞 How do I get support?

Join the **Support Channel on Telegram** [@thortradingsupport](https://t.me/thortradingsupport)


# Global Language Support

To make the experience seamless for every trader across the world, Thor now supports 10 languages across the interface and key bot interactions.

**Available languages:**\
🇬🇧 English\
🇷🇺 Russian\
🇩🇪 German\
🇪🇸 Spanish\
🇨🇳 Chinese\
🇹🇭 Thai\
🇨🇿 Czech\
🇫🇷 French\
🇵🇹 Portuguese\
🇸🇦 Arabic

Switch your preferred language in seconds and trade comfortably with **real-time updates, commands, and insights in your own language** — no translation needed.

***

### Tutorial

* Press on LANGUAGE to choose your preferred language for the bot.

<div align="left"><figure><img src="/files/D3jbNpt8vT558nHao3G7" alt="" width="401"><figcaption></figcaption></figure></div>

* Choose on of the current 10 language available by pressing on the one you prefer:\
  \
  ![](/files/QVDqfMgpgBoOp7rbmkTC)


# Security tips

### ⚡ Thor Safety Tip

The blockchain battlefield is a dark forest — fight smart, stay alert.\
Two golden rules for every warrior:

**1️⃣ Zero Trust**\
Never hand your keys to anyone or anything. Every “admin,” “bot,” or “plugin” asking for your private key is a trap.

**2️⃣ Validate Everything**\
Check twice before signing once. Make security a habit.

***

#### 🧠 Common Scams

**⚔️ Fake Admins in TG**\
No Thor or Odin admin will ever DM you first.\
Scammers mimic usernames and bios — always verify from the official channels.

**⚔️ Fake Groups**\
Never join random Telegram groups.\
Turn on:\
`Settings → Privacy & Security → Groups & Channels → “Nobody can add me.”`

**⚔️ Phishing Links & “Verification” Pages**\
Ignore any site asking for your wallet, phone, or password.\
If you didn’t request it — it’s bait.

**⚔️ Web3 Signature Traps**\
What you see = what you sign.\
Regularly check wallet approvals and revoke unknown permissions.\
Airdropped NFTs or “claim” sites can drain your SOL — avoid them.

***

### ⚠️ **Airdrop Scam Detection**

Thor helps you identify suspicious tokens that appear in your wallet but were not actually purchased.

Tokens flagged as potential scams will show:

* An **Airdrop Scam** warning label
* No PnL data
* No average entry price
* No market capitalization information

***

### 🔒 Shield Up: Protect Your Wallets

**Telegram**

* Enable 2-Step Verification
* Hide your phone number
* Use official apps only

**Wallet**

* Cancel unknown approvals
* Enable auto-lock
* Don’t install random browser extensions or apps

***

### 🧩 Device Safety

* Don’t click unknown links or install shady files
* Keep system updates current
* Separate wallets: one for testing, one for storing
* For important wallets: less is more — avoid unnecessary updates

***

### 🚨 If You’re Hacked

1. **Act fast** – Move remaining funds to a clean wallet
2. **Stay calm** – Disconnect the device, preserve evidence
3. **Trace it** – Identify the hacker’s address, fill [SlowMist recovery form](https://aml.slowmist.com/recovery-funds.html)

{% hint style="danger" %}
Security comes first with Thor. There are **no backdoors, no hidden permissions, no wallet access**. If your assets are compromised, review the safety steps above — Thor never touches or controls your funds.
{% endhint %}


# Trading Fees & Cashback Tiers & Rewards

### 💸 Trading Fee & Cashback Tiers

Thor charges a **1% fee per trade**, but loyal users can get up to 7&#x35;**% cashback** based on trading volume.

### **🎖 Cashback Tiers:**

| Tier        | Required Volume | Cashback Reward |
| ----------- | --------------- | --------------- |
| 🥉 Bronze   | $0,00+          | 10%             |
| 🥈 Silver   | $100,000+       | 20% Cashback    |
| 🏅 Gold     | $1,000,000+     | 30% Cashback    |
| 💎 Diamond  | $5,000,000+     | 40% Cashback    |
| 🪨 Platinum | $10,000,000+    | 50% Cashback    |
| 👾 Degen    | $100,000,000+   | 75% Cashback    |

Earn higher rewards as your trading volume increases — Thor gives back to its strongest warriors.

### **How It Works**

* Cashback is calculated monthly. You can view you tier by going to <kbd>/referral</kbd>
* You’ll receive it directly to your wallet balance.
* Tier status is automatically upgraded when volume thresholds are hit.

***

### **We also offer a 5-layer rewards system - THE BEST in the market!**&#x20;

**Thor reward layers:**&#x20;

* **Layer 1: 30%**
* **Layer 2: 4.5%**
* **Layer 3: 2.5%**
* **Layer 4: 2%**
* **Layer 5: 1%**

### **Private Referral Links**

Referral links now use a random hash instead of your username or user ID —\
providing stronger privacy for all users.\
\
Use `/referral` to create your personal referral link and share it with your network.\
On this page, you can view your link, track users who joined through it (up to 5 levels), and see the total SOL rewards you’ve earned.

<div align="left"><figure><img src="/files/Ynx0yg21n7Tprac7AqT6" alt="" width="404"><figcaption></figcaption></figure></div>

You earn rewards not only when your referrals trade but also when their referrals trade, up to multiple levels. The system is designed to scale and grow your earnings over time.


# Thor - Web Extension

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

#### How It Works

The Thor Extension integrates Telegram trading straight into your web terminal, blending speed, automation, and flexibility into one smooth process. You continue with your favorite terminal, boosted by Thor’s execution engine and features.

Thor enhances your current terminal without replacing it, offering quicker executions, more customization options, effortless mobile trading, and strong automation in a single, unified setup.

***

#### **What You Get**

**Unified Trading**

* Embed Telegram trading power directly into your terminal.
* No need to switch between Telegram, charts, or other apps like DexScreener and Pump.fun.

**Instant Execution**

* One-click trades for quick buys and sells.
* Sell all holdings in a single action.

**Quick Control**

* Execute trades without leaving the terminal.
* Switch strategies fast using customizable presets.
* Trade with one or multiple wallets easily.

**Advanced Features**

* Set slippage, priority fees, and expirations for precision.
* Create limit orders with triggers like percentage, market cap, or price.
* Add trailing stops for automated protection.

{% embed url="<https://youtu.be/7Q_gjHMgkwQ>" %}


# Download

{% hint style="info" %}
Important Note\
\ <mark style="color:$danger;">Always ensure you are using the official Thor Extension. We are not responsible for unofficial, modified, or impersonated versions.</mark>

We know that browser extensions can be sensitive, especially in crypto environments. The Thor Extension is reviewed and approved through the official browser store and only adds Thor trading actions (such as Buy and Sell) to supported trading terminals.

Thor will never request private keys, wallet access, or transaction approvals. The extension does not store, track, or transmit any user data.
{% endhint %}

***

You can download the Thor Extension either from the Chrome Web Store or as a .zip file directly from our [website](https://odin.tools/thor) linked below.

{% embed url="<https://odin.tools/thor/extension>" %}

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


# Activation

### Activation Steps

{% stepper %}
{% step %}
Click on Get Code.

<div align="left"><figure><img src="/files/1jKzsv2mCM6YTr0b5GEt" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
You’ll be redirected to Thor on Telegram, where your activation code is sent. Never share this code.

<div align="left"><figure><img src="/files/GooMpETVkjs8NdNCYE5Q" alt="" width="391"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Copy and paste the code into the extension.

<div align="left"><figure><img src="/files/WwplF3tXUvk37m6dfrLF" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click Verify.

<div align="left"><figure><img src="/files/nv5LE6KiPnO9Mqwny7d7" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
The extension refreshes and activates.

<div align="left"><figure><img src="/files/xWcIwKrxzRThzBFycSS1" alt="" width="261"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Open a chart and Thor will be ready.

<div align="left"><figure><img src="/files/9LHgBvhWJ1FQOEqbRozb" alt="" width="262"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


# Settings

To access settings, click the gear icon in the extension pop-up.

<div align="left"><figure><img src="/files/vzTPhM096oSpuhWFq2mz" alt="" width="263"><figcaption></figcaption></figure></div>

***

### Buy/Sell Preferences&#x20;

#### Accessing Presets

Open Settings and navigate to Buy/Sell Preferences.\
Here, you can manage your buy and sell presets. Click Add to create multiple presets.

#### Buy Preset&#x20;

Configure your Buy presets by clicking the Solana icon to switch between USD ($) and SOL amounts.\
You can also define your slippage and priority for buy and sell actions.

#### Sell Presets

For Sell presets, select predefined percentages such as 10%, 20%, 35%, 50%, or 100%.

{% embed url="<https://youtu.be/5_sW3ewXpkI>" %}

***

### Site Preferences&#x20;

Open Settings and navigate to Site Preferences.\
The Thor Fast Trading Window appears on selected supported websites and terminals.

#### Supported Platforms&#x20;

Enable or disable the fast trading window for the following platforms:

* **Axiom**
* Axiom Instant Trade
* Axiom Pulse QB
* Axiom Watchlist
* Axiom Wallet Tracker
* BullX Neo
* Dexscreener
* Telegram Web
* GmGN
* Padre
* Pump.fun
* Market Stalker
* Birdeye
* DexTools
* Twitter / X

***

{% hint style="info" %}
All settings are saved automatically.
{% endhint %}


# Limit Orders

Limit Orders (Buy / Sell)

Limit orders allow you to create Buy limit orders to purchase a token at a specific trigger price, as well as Sell limit orders used for Take Profit (TP) and Stop Loss (SL).

Triggers can be defined based on:

* Percentage (%)
* Market Cap (MC)
* Price ($)

{% hint style="info" %}
If Telegram Auto-Sell TP/SL is enabled, those settings will be used automatically for Sell limit orders (TP/ SL).
{% endhint %}

***

### Creating Limit Orders via Web Extension

You can configure Buy limit orders and Sell limit orders (TP / SL) directly in the web extension.

#### Open Limit Orders

1. Open a token chart
2. The Thor web extension opens automatically
3. Click Limit Orders
4. Click + New in the top-right corner

***

#### Configure the Order

Select the order type:

* Buy – Create a Buy limit order to purchase tokens at a defined trigger price
* Sell – Create a Sell limit order for Take Profit (TP) or Stop Loss (SL)

***

#### Trigger Type

Choose how the trigger should be evaluated:

* % – Percentage-based trigger
* MC – Market cap-based trigger
* $ – Price-based trigger

Example trigger values:

* <mark style="color:$danger;">`-50%`</mark> for a Stop Loss
* <mark style="color:$success;">`+100%`</mark> for a Take Profit

***

#### Set Amount

* Buy limit orders: enter the amount in SOL to buy
* Sell limit orders: enter the percentage (%) of tokens to sell

***

#### Expiration

Choose how long the limit order should remain active:

* 1h
* 6h
* 24h
* 7d
* 30d

***

#### Create the Order

Click Create Limit Order to activate the limit order.

The order will remain active until it is executed or expires.<br>


# Thor - Sniper

The **Thor - Sniper** is a high-speed tool that buys tokens instantly across **X**, **Telegram**, **Discord**, and **WhatsApp**. The moment a token contract appears in a chat, Thor executes the purchase in milliseconds, giving you a clear advantage in fast-moving markets.

Suitable for launches, call groups, DMs, and private communities, Thor is designed to act faster than anyone else, ensuring you never miss an opportunity.

<div align="left"><figure><img src="/files/ev0Cz0pBaVlJAWoxcPu7" alt="" width="563"><figcaption></figcaption></figure></div>

***

### How It Works

Thor monitors messages in real-time and automatically buys tokens when they appear. You can adjust settings to control which groups it watches, token priorities, and trading strategies.

<div align="left"><figure><img src="/files/7lCNCYXdyiGr48QLkaEA" alt="" width="563"><figcaption></figcaption></figure></div>

***

### What You Get

**Instant Sniping**&#x20;

* Buys tokens the moment they are shared

**Multi-Platform**&#x20;

* Works on X, Telegram, Discord, and WhatsApp

**Versatile Use**&#x20;

* For launches, call groups, DMs, and private groups

**Real-Time Monitoring**&#x20;

* Detects token announcements immediately

**Adjustable Settings**&#x20;

* Set take profits, stop losses, and other preferences

***

### Why To Choose Thor

Thor is easy to set up, fast, and reliable. Perfect for beginners and advanced traders alike, it ensures speed is always on your side.

<div align="left"><figure><img src="/files/gtIQN4lvsLVWHmUwvvQT" alt="" width="563"><figcaption></figcaption></figure></div>


# Download

{% hint style="info" %}
Important Note\
\ <mark style="color:$danger;">Always ensure you are using the official Thor Sniper. We are not responsible for unofficial, modified, or impersonated versions.</mark>\
\
To ensure your safety, always download Thor Sniper exclusively from our official website: [**odin.tools/thor**](https://odin.tools/thor). Avoid third-party sources to protect your funds and maintain a secure trading experience. \
\
Thor will never request private keys, wallet access, or transaction approvals. The extension does not store, track, or transmit any user data.
{% endhint %}

You can download Thor Sniper directly from our official [website](https://odin.tools/thor/thor) linked below.

{% embed url="<https://odin.tools/thor/extension>" %}

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


# Login

After you have installed Thor Sniper, it will open automatically. To start using it, you need to get your API key through our official Telegram bot.

**Generate Your Access Code & Login:**

1. Open the official Telegram bot using this [link](https://t.me/thorsolana_bot?start=r-mmdoseh-lextlogin).&#x20;

{% embed url="<https://t.me/thorsolana_bot?start=r-mmdoseh-lextlogin>" %}

2. Copy the login code from the Telegram message, paste it into the Thor Web Extension, and click Verify.

{% hint style="info" %}
**Note: Y**ou can click **Get Code** directly inside the Desktop App. This code is required to securely connect Thor Sniper to your account.
{% endhint %}

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


# X

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

### X Sniper – Own the Token Before the World Sees It

**Snipe any account. Any Community.**\
Big launches. Hyped coins. Viral projects.

Even the biggest names - like **Donald Trump** with his **Trump Coin -** the moment it drops, **X Sniper** automatically buys within **milliseconds**.

No manual copy-paste.\
No delay.

The Thor Sniper gives you the execution advantage to act before information spreads beyond communities. Built for traders who understand: **in this game, speed is everything.**

{% embed url="<https://youtu.be/xU7qZVFomfk>" %}


# Telegram

## Telegram Sniper – Buy the Token Before Others

**Snipe any token. Any group. Any channel.**\
Launch calls. Private groups. Viral projects.

The moment a contract address appears in a **call group**, a **private channel**, or a **DM**, Telegram Sniper detects it and executes automatically within **milliseconds**.

No manual copy-paste.\
No delay.

The Thor Sniper gives you the execution advantage to act before anyone else even reacts. Built for traders who understand: **in this game, speed is everything.**

{% embed url="<https://youtu.be/hYrhleXvKwU>" %}


# Discord

## Discord Sniper – Execute Before the Market Reacts

**Monitor any server. Any channel. Any DM.**\
Public launches. Private communities. Early access groups.

The moment a contract address appears inside a **server**, a **private channel**, or a **direct message**, Discord Sniper detects it and executes within milliseconds.

No manual copy-paste.\
No delay.

The Thor Sniper gives you the execution advantage to act before information spreads beyond closed communities. Built for traders who understand: in this market, timing defines the edge.

{% embed url="<https://youtu.be/mPZApMz2IZs>" %}


# What's App

## WhatsApp Sniper – Buy the Token Before Others

**Monitor any group, broadcast, or direct message.**\
Public launches. Private communities. Early access groups.

The moment a contract address is shared in a **group**, a **broadcast**, or a **DM**, WhatsApp Sniper detects it and executes automatically within **milliseconds**.

No manual copy-paste.\
No delay.

The Thor Sniper gives you the execution advantage to act before anyone else even reacts. Built for traders who understand: **in this game, speed is everything.**

{% embed url="<https://youtu.be/IE_tdCSPjL8>" %}


# Heimdall - Protection bot

@heimdall\_odintools\_bot

***

<div align="center"><figure><img src="/files/V8OGC8znrQ9Xc4cIJq75" alt="" width="563"><figcaption></figcaption></figure></div>

Heimdall is a powerful Telegram group management bot designed for crypto communities. It provides comprehensive moderation tools, anti-spam protection, portal verification, custom filters, and integration with various crypto services.

***

### **Anti-Spam Protection**

Automatic detection and removal of spam messages, fake admins, scammers, and prohibited content. Includes OCR-based text extraction from images and videos to detect spam hidden in media.

### Portal verification

Secure entry system requiring users to verify through a web portal before joining groups. Collects device fingerprints to detect alt accounts of banned users.

### **Custom Filters**

Create automatic responses to keywords or phrases. Supports single words and multi-word phrases in quotes.

### **Crypto Integration**

Track token prices, market caps, holders. Integration with DexScreener, PumpFun, and various buy bots. Supports Solana, Ethereum, TON, and BSC tokens.

### **Automatic Whitelisting**

Users are automatically whitelisted after sending 10 safe (non-spam) messages, exempting them from further anti-spam checks without admin intervention.

### **Image & Video Text Detection**

Uses OCR technology to extract and scan text from images, videos, GIFs, and documents for spam content - catching scammers who hide messages in media.

### **Whales Mode**

Restrict chat to verified token holders based on minimum holding requirements. Users verify by connecting their wallet on-chain.

### **Referral Contests**

Create and manage referral competitions with automatic tracking and leaderboards. Each user gets a unique invitation link to share.


# Heimdall set-up

#### ⚙️ How to Add Heimdall to Your Telegram Group

Adding Heimdall `(@heimdall_odintools_bot)` to your Telegram community takes less than a minute. Once active, it automatically protects your group from spam, scams, and malicious users - and connects you to the global Heimdall protection network.

#### Setup

1. **Invite Heimdall Bot**
   * Open the official **Heimdall Bot** link: t.me/heimdall\_odintools\_bot \
     (Username: @heimdall\_odintools\_bot)
   * Click **“Add Bot to Group”** and choose your Telegram community.
2. **Grant Admin Permissions**\
   Heimdall needs admin rights to ban, mute, and delete susspicious messages.\
   Make sure the following permissions are **enabled**:
   * Delete messages
   * Ban users
   * Restrict users
   * Pin messages (optional)
3. **Confirm Activation**\
   Once added, Heimdall will send a confirmation message in your group showing it’s active and synced with the global network.
4. **Done. You’re Protected.**\
   That’s it - your group is now part of the **Heimdall Network**.\
   From this point, any spammer banned anywhere in the network will automatically be banned in your group too.

{% embed url="<https://youtu.be/r_ipw5Rp7Zc?si=-pIlYEY3363nST8Y>" %}

#### 🛡️ Optional Settings

* `/help` – See more options
* `/settings` – View and adjust moderation preferences.
* `/stats` – See your group’s protection data.
* `/info @username` - View user ID, recent suspicious messages, and status.

***

Adding Heimdall early to your community helps prevent infiltration before your project grows. Every new group strengthens the overall shield - so when you protect your chat, you help protect thousands of others.


# Portal set-up

Step by step guide how to set-up the Heimdall Portal

***

### Heimdall Portal

#### Enhance your group security with the Heimdall Portal.

1. `You need a group and a channel where Heimdall is added as an administrator.`
2. `Type /menu in your group.`
3. `Click on "Configure Group".`
4. `Click on "Portal".`
5. `Configure your portal, select your channel, and click "Save".`

{% embed url="<https://www.youtube.com/watch?v=mn7s-RnWNI0>" %}


# Moderation

***

### Ban & Unban

#### <mark style="color:blue;">/ban</mark> <mark style="color:red;">(Admin)</mark>

`/ban @username | /ban UserID | Reply with /ban`

Ban a user from the group. Can be used by replying to a message, mentioning a user, or providing a UserID.

***

#### <mark style="color:blue;">/unban</mark> <mark style="color:red;">(Admin)</mark>

`/unban @username | /unban UserID`

Unban a previously banned user, allowing them to rejoin the group.

***

#### Mute & Unmute

#### <mark style="color:blue;">/mute</mark> <mark style="color:red;">(Admin)</mark>

`/mute @username [duration] | Reply with /mute`

Mute a user, preventing them from sending messages. Optional duration (e.g., 1h, 1d, 1w). Without duration, mute is permanent until unmuted.

***

#### <mark style="color:blue;">/unmute</mark> <mark style="color:red;">(Admin)</mark>

`/unmute @username | /unmute UserID`

Unmute a user, restoring their ability to send messages. Resets their deleted message counter and removes pending verifications.&#x20;

***

### Message Management

#### <mark style="color:blue;">/delete</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`Reply to a message with /delete`

Delete the replied-to message.

***

#### <mark style="color:blue;">/report</mark> <mark style="color:$success;">(All Users)</mark>&#x20;

`Reply with /report | /report @username [reason]`

Report a user or message to group admins. Creates a report record and notifies admins with ban/mute buttons.

***

#### <mark style="color:blue;">/lock</mark> <mark style="color:red;">(Admin)</mark>

`/lock`

Lock the chat, preventing all non-admin members from sending messages. Shows confirmation buttons.

***

#### <mark style="color:blue;">/unlock</mark> <mark style="color:red;">(Admin)</mark>

`/unlock`

Unlock the chat, allowing all members to send messages again. Shows confirmation buttons.

***

### User Management

#### <mark style="color:blue;">/whitelist</mark> <mark style="color:red;">(Admin)</mark>

`/whitelist @username | /whitelist UserID`

Manually whitelist a user, exempting them from anti-spam checks and automatic moderation. Resets their deleted message counter. Note: Users are also automatically whitelisted after 10 safe messages (see [Automatic Whitelisting](https://trafficbots.xyz/odin/docs/heimdall_documentation.html#auto-whitelisting)).

***

#### <mark style="color:blue;">/exclude</mark> <mark style="color:$success;">(All Users)</mark>

`/exclude | /exclude @username (admin only)`

Exclude yourself (or a specified user if admin) from the /all mention feature.

***

#### <mark style="color:blue;">/removedeletedaccounts</mark> <mark style="color:red;">(Admin)</mark>

`/removedeletedaccounts`

Scan and remove all deleted Telegram accounts from the group.

***

#### <mark style="color:blue;">/info</mark> <mark style="color:$success;">(All Users)</mark>

`/info @username | /info UserID | Reply with /info`

Get detailed information about a user including: permban status, report count, mute count, ban count, whitelist status, verification status, and recent deleted messages.

***

#### <mark style="color:blue;">/getreports</mark> <mark style="color:$success;">(All Users)</mark>&#x20;

`/getreports @username | /getreports UserID`

View all reports filed against a specific user, including both message content and reasons.

***

### Inactive User Management

#### <mark style="color:blue;">/inactive</mark> <mark style="color:red;">(Admin)</mark>

`/inactive [days] | /inactivecount [days]`

Get count of users who haven't sent a message in X days (default: 7 days).

***

#### <mark style="color:blue;">/inactivelist</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`/inactivelist [days]`

List inactive users with their UserID, days since last message, and total message count. Shows first 50 users.

***

#### <mark style="color:blue;">/kickinactive</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`/kickinactive [days]`

Warn inactive users by mentioning them. Users who don't respond within 1 hour will be automatically removed. Skips admins and whitelisted users.

***


# Filters

***

{% hint style="info" %}
**How Filters Work**

Filters create automatic responses when specific keywords or phrases are detected in messages.

**Single-word filters:** Match when used as a command (e.g., typing "ca" or "/ca" triggers the filter)

**Multi-word filters:** Match when the phrase appears ANYWHERE in a message (case-insensitive)
{% endhint %}

***

#### <mark style="color:blue;">/filter</mark> <mark style="color:red;">(Admin)</mark>

`/filter word response text here /filter "multi word phrase" response text here`

Create a new filter. For single words, the word becomes a trigger command. For multi-word phrases, wrap in quotes - it will match anywhere in messages.

**Examples:**

`/filter website https://example.com` - Triggers on /website or website

`/filter "when moon" Soon! Keep holding!` - Triggers whenever "when moon" appears in any message.

***

#### <mark style="color:blue;">/filters</mark> <mark style="color:$success;">(All Users)</mark>

`/filters`

Display all active filter keywords/phrases for the group.

***

#### <mark style="color:blue;">/removefilter</mark> <mark style="color:red;">(Admin)</mark>

`/removefilter keyword`

Remove a specific filter by its keyword.

***

#### <mark style="color:blue;">/removeallfilters</mark> <mark style="color:red;">(Admin)</mark>

`/removeallfilters`

Remove ALL filters from the group. Use with caution!

***

{% hint style="info" icon="check" %}
**Special Filter: CA**

Setting a filter with keyword "ca" or "/ca" will also automatically set the group's contract address, enabling the `/mcap` command and other crypto features.
{% endhint %}


# Configuration

***

### Main Configuration

#### <mark style="color:blue;">/config</mark> <mark style="color:red;">(All Users)</mark>&#x20;

`/config | /menu | /setup | /settings`

Open the main configuration menu. Provides access to: Portal setup, Welcome Messages, Filters, Whales Mode, Voting campaigns, Lounge Mode, and all other group settings.

***

#### <mark style="color:blue;">/admins</mark> <mark style="color:$success;">(All Users)</mark>&#x20;

`/admins`

Display list of all group administrators with their roles. Can be disabled via `/adminslist off`.

***

### Feature Toggles

#### <mark style="color:blue;">/silentmode</mark> <mark style="color:red;">(Admin)</mark>

`/silentmode | /silentmode on|off`

Toggle silent mode. When enabled: removes ads, hides ban/mute notification messages, and suppresses bot action notifications for a cleaner chat experience. Premium feature with payment option.

***

#### <mark style="color:blue;">/jokes</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`/jokes on|off`

Enable/disable joke mode. When enabled, the /sol command will first show a fake price before revealing the real one.

***

#### [<mark style="color:blue;">/memes</mark>](#user-content-fn-1)[^1] <mark style="color:red;">(Admin)</mark>

`/memes on|off`

Enable/disable the /meme command for the group.

***

#### <mark style="color:blue;">/adminslist</mark> <mark style="color:red;">(Admin)</mark>

`/adminslist on|off`

Enable/disable the /admins command for regular users.

[^1]:


# Crypto Tools

***

### Price & Market Data

#### <mark style="color:blue;">/sol</mark> <mark style="color:$success;">(All Users)</mark>

`/sol`

Get the current SOL/USD price from PumpFun API.

***

#### <mark style="color:blue;">/mcap</mark> <mark style="color:$success;">(All Users)</mark>

`/mcap | /mcap [contract_address]`

Get market cap and holder count for a token. Without argument, uses the group's set CA. Supports Solana, Ethereum, TON, and BSC tokens.

***

#### <mark style="color:blue;">/ca</mark> <mark style="color:red;">(Admin)</mark>

`/ca [contract_address] | /ca`

Set or display the group's contract address. When set, enables various crypto features like /mcap without arguments.

***

### Voting & Trending

#### <mark style="color:blue;">/voteall</mark> <mark style="color:$success;">(All Users)</mark>

`/voteall`

Display all available voting buttons for the group's token. Automatically detects which buy bots are installed (Skeleton, Major, WTF, etc.) and shows relevant voting links.

***

#### <mark style="color:blue;">/rankboost</mark> <mark style="color:red;">(Admin)</mark>

`/rankboost`

Start a community-funded rank boost campaign for DEX trending.

***

#### <mark style="color:blue;">/volumeboost</mark> <mark style="color:red;">(Admin)</mark>

`/volumeboost`

Start a community-funded volume boost campaign.

***

#### <mark style="color:blue;">/bumpbot</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`/bumpbot`

Start a FREE PumpFun bump bot campaign.

***

#### <mark style="color:blue;">/stoprankboost</mark> <mark style="color:red;">(Admin)</mark>

`/stoprankboost`

Stop an active rank boost campaign. Donated SOL will be refunded.

***

#### <mark style="color:blue;">/stopvolumeboost</mark> <mark style="color:red;">(Admin)</mark>&#x20;

`/stopvolumeboost`

Stop an active volume boost campaign. Donated SOL will be refunded.

***

#### <mark style="color:blue;">/stopbumpbot</mark> <mark style="color:red;">(Admin)</mark>

`/stopbumpbot`

Stop an active bump bot campaign.

***

### Bot Integration

#### <mark style="color:blue;">/buybot</mark> <mark style="color:$success;">(All Users)</mark>

`/buybot`

Get instructions for adding the Skeleton Price Bot (@skeletonpricebot) to your group.

***

#### <mark style="color:blue;">/raidbot</mark> <mark style="color:$success;">(All Users)</mark>

`/raidbot`

Get instructions for adding the Freya Raid Bot (@Freya\_raid\_bot) to your group.

***


# Utility

***

### Communication

#### <mark style="color:blue;">/all</mark> <mark style="color:red;">(Admin)</mark>

`/all | @all | /all [message]`

Mention all members in the group. Shows confirmation dialog first. Members can exclude themselves using /exclude. Automatically bans permabanned users detected during the process.

***

### Entertainment

#### <mark style="color:blue;">/joke</mark> <mark style="color:$success;">(All Users)</mark>&#x20;

`/joke`

Get a random crypto-themed joke. Only works if jokes are enabled for the group.

***

#### <mark style="color:blue;">/meme</mark> <mark style="color:$success;">(All Users)</mark>

`/meme`

Get a random meme (image or video). Memes are sourced from 9GAG across multiple categories including humor, crypto, and classic memes. Videos are automatically converted for Telegram compatibility. Only works if memes are enabled for the group (toggle with `/memes on|off`).

***

### Statistics

#### [<mark style="color:blue;">/stats</mark>](#user-content-fn-1)[^1] <mark style="color:$success;">(All Users)</mark>&#x20;

`/stats`

View group statistics including bans, mutes, removed users, etc.

***

#### <mark style="color:blue;">/globalstats</mark> <mark style="color:$success;">(All Users)</mark>

`/globalstats`

View global Heimdall statistics across all protected groups.

***

#### <mark style="color:blue;">/help</mark> <mark style="color:$success;">(All Users)</mark>&#x20;

`/help`

Display help information and command overview.

***

### Referral Contests

#### <mark style="color:blue;">/refcontest</mark> <mark style="color:$success;">(All Users)</mark>

`/refcontest`

View current referral contest leaderboard or create a new contest (if admin). Each user receives a unique cryptographically-generated invitation link to share. When someone joins through the link, it is automatically tracked and counted toward the referrer's score. Contests support start/end dates, prize descriptions, and real-time leaderboards.

<br>

[^1]:


# DM commands

***

{% hint style="info" %}
These commands work when messaging the bot directly in private chat.
{% endhint %}

### User Information

#### <mark style="color:blue;">/info</mark> <mark style="color:purple;">(DM)</mark>&#x20;

`/info @username | /info UserID`

Same as group /info but available in DM. You can also forward a message from a user with hidden identity to automatically resolve who they are.

***

#### <mark style="color:blue;">/groupinfo</mark> <mark style="color:purple;">(DM)</mark>&#x20;

`/groupinfo GroupID`

Get information about who installed Heimdall in a specific group.

***

#### <mark style="color:blue;">/getreports</mark> <mark style="color:purple;">(DM)</mark>

`/getreports @username | /getreports UserID`

View all reports for a user (works same as in groups).

***

### Group Configuration via DM

#### <mark style="color:blue;">/filter</mark> <mark style="color:red;">(Admin)</mark> <mark style="color:purple;">(DM)</mark>&#x20;

`/filter word response /filter "phrase" response`

Add filters via DM when configuring a group through the bot. Works same as in-group /filter command.

***

#### <mark style="color:blue;">/removefilter</mark> <mark style="color:red;">(Admin)</mark> <mark style="color:purple;">(DM)</mark>&#x20;

`/removefilter keyword`

Remove a filter via DM when configuring a group.

***

#### <mark style="color:blue;">/removeallfilters</mark> <mark style="color:$danger;">(Admin)</mark> <mark style="color:purple;">(DM)</mark>

`/removeallfilters`

Remove all filters via DM when configuring a group.


# Image & Video OCR

***

### Image & Video Text Recognition (OCR) <a href="#ocr" id="ocr"></a>

Heimdall uses OCR to extract text from media sent in chat. This prevents scammers from bypassing text-based filters by putting their spam inside images or videos.

* **Image processing:** Images are converted to grayscale with automatic level and contrast enhancement for maximum OCR accuracy
* **Video processing:** Heimdall extracts the middle frame of a video (for best content representation) and runs OCR on it
* **Fallback logic:** If no text is found in the initial scan, additional frames are extracted and scanned
* **Spam checking:** All extracted text is combined with the message text and checked against the full spam detection ruleset

**Supported formats:** JPG, PNG, WebP, GIF, BMP, MP4, AVI, MKV, WebM, MOV, WMV, FLV, and more.


# Spam Detection

***

### Spam Detection <a href="#spam-detection" id="spam-detection"></a>

Over **200 spam patterns** are actively checked against every message. The system uses text normalization to defeat evasion techniques.

| Detection Type             | Description                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Banned Words**           | Messages containing known spam phrases from a maintained word list                                                              |
| **Scam Patterns**          | "Contact me if you hold X", fake wallet/payment scams, rug pull indicators, phishing attempts                                   |
| **Fake Admins**            | Users impersonating admins via similar names, titles like "CEO", "Dev", or "Owner", or matching the group/token name            |
| **Fake Contracts**         | Users with blockchain addresses in their display names to trick others                                                          |
| **Fake Bots**              | Impostor bots using homograph/lookalike characters in usernames (e.g., capital "I" instead of "l")                              |
| **Text Normalization**     | Cyrillic-to-Latin conversion, Unicode mapping, and number-to-letter substitution (0→O, 1→I) to catch evasion tricks             |
| **Image Hash Matching**    | Perceptual image hashing (DifferenceHash) detects copied or slightly modified spam images, even after cropping or color changes |
| **Similar Name Detection** | Levenshtein distance algorithm catches names visually similar to admin names or the group name                                  |


# Portal Verification

***

#### Portal Verification <a href="#portal" id="portal"></a>

New users must verify through a web portal before accessing the group. The portal serves two purposes: confirming the user is human, and collecting device fingerprint data for alt account detection.

The portal supports customizable welcome text, an image, and inline buttons. Users who don't verify within the configured time receive reminders.

***

#### Permban Propagation <a href="#permban" id="permban"></a>

When a user is permanently banned, the ban is enforced across **ALL Heimdall-protected groups**. This creates a network-wide defense against persistent bad actors.

{% hint style="info" icon="triangle-exclamation" %}
**Alt Account Detection:** If a permabanned user creates a new Telegram account, Heimdall detects it through fingerprint matching during portal verification and automatically bans the alt account as well.
{% endhint %}


# Link Security

***

#### Link Security <a href="#link-security" id="link-security"></a>

Heimdall automatically checks links posted in chat for safety:

* **Safe domain whitelist:** Configurable list of trusted domains (cached with regular updates)
* **Redirect chain following:** Follows shortened URLs (bit.ly, t.co, tinyurl.com, etc.) to check the final destination
* **Pattern matching:** Regex patterns detect phishing, malware, and scam content on linked pages
* **404 detection:** Links returning 404 errors are flagged as dangerous
* **Re-checking:** Previously checked URLs are re-validated every 7 days


# Whales Mode

***

#### Whales Mode <a href="#whales-mode" id="whales-mode"></a>

When enabled, Whales Mode restricts chat to verified token holders who meet a minimum holding requirement.

**How verification works:**

1. Admin enables Whales Mode and sets the minimum token holding requirement
2. Users verify by sending 1 token to the Heimdall verification wallet
3. Users can verify multiple wallets
4. Heimdall checks holdings every 30 minutes

**Behavior:**

* Users who fall below the minimum are automatically muted with a notification
* If a previously qualified user sells their tokens, they receive a different message indicating their holdings dropped
* Users are automatically unmuted when holdings are restored
* Notifications have a 24-hour cooldown to prevent spam
* Admins and whitelisted users are always exempt


# Welcome Messages

***

**Customizable welcome messages greet new users when they join the group.**

* **Custom text:** Set any welcome message text
* **Image:** Optionally include an image with the welcome message
* **Inline buttons:** Add clickable buttons (e.g., links to website, socials, rules)
* **Toggle:** Can be enabled or disabled per group via the /config menu


# Other Features

***

### Other Features <a href="#other-features" id="other-features"></a>

#### **Lounge Mode**

When enabled, relaxes certain spam checks to allow forwarded messages and channel posts without triggering moderation. Useful for groups that regularly share content from other channels or sources. Toggle through the /config menu.

***

#### **Message Tracking**

Heimdall keeps a history of up to 30 messages per user per group. Deleted messages are preserved in the tracking system, and administrators can view a user's recent deleted messages via the /info command for evidence in moderation decisions.

***

#### **New User Monitoring**

Newly joined users are closely monitored with stricter scrutiny until they build up a history of safe messages and become auto-whitelisted. Users with pending verifications receive reminders to complete the process.

***

#### **Inactive User Warnings**

When admins trigger /kickinactive, inactive users receive a warning mention. If they don't respond within 1 hour, they are automatically removed. Admins and whitelisted users are always exempt.

***

#### **CA Auto-Detection**

Automatically detects blockchain contract addresses posted in chat and tracks them for analytics purposes.

***

#### **Silent Mode**

When enabled, removes ads and hides ban/mute notification messages from chat for a cleaner experience. Available as a premium feature via the /silentmode command.


