# Commands

Every command available in ThorBot. Most features are also accessible through the button menu — commands are shortcuts for power users.

***

## Core

| Command  | Description                 |
| -------- | --------------------------- |
| `/start` | Open the home screen        |
| `/help`  | Show all available commands |

***

## Trading

| Command      | Syntax                            | Description                                        |
| ------------ | --------------------------------- | -------------------------------------------------- |
| `/buy`       | `/buy <amount> <CA> [chain]`      | Buy tokens with native currency                    |
| `/sell`      | `/sell <percentage> <CA> [chain]` | Sell a percentage of your holdings                 |
| *Paste a CA* |                                   | Paste a contract address to open the trading board |

**`/buy` — Instant Buy**

Buys tokens by spending native currency (ETH, BNB, MNT, SOL).

```
/buy <amount> <CA> [chain]
```

* `<amount>` — Amount of native currency to spend (e.g., `0.1`)
* `<CA>` — Token contract address
* `[chain]` — Optional. Defaults to your active chain

Examples:

```
/buy 0.1 0x1a2b3c...4d5e base
/buy 0.5 0x1a2b3c...4d5e bsc
/buy 1.0 0x1a2b3c...4d5e mantle
/buy 0.01 0x1a2b3c...4d5e megaeth
/buy 2 DezXAZ8z7...abc solana
```

**`/sell` — Instant Sell**

Sells a percentage of your token holdings (1–100).

```
/sell <percentage> <CA> [chain]
```

* `<percentage>` — Percentage of your holdings to sell (1–100)
* `<CA>` — Token contract address
* `[chain]` — Optional. Defaults to your active chain

Examples:

```
/sell 50 0x1a2b3c...4d5e base        (sell 50%)
/sell 100 0x1a2b3c...4d5e bsc        (sell all)
/sell 25 DezXAZ8z7...abc solana      (sell 25%)
```

{% hint style="info" %}
**Tip:** You can also paste any contract address directly into the chat to open the trading board, then use the buy/sell buttons.
{% endhint %}

***

## Wallet

| Command         | Description                                              |
| --------------- | -------------------------------------------------------- |
| `/wallets`      | View and manage your wallet slots (W1–W5)                |
| `/balance`      | Check wallet balances across all chains                  |
| `/importwallet` | Import an existing wallet via private key or seed phrase |
| `/exportkey`    | Export your private key (with confirmation)              |

***

## Limit Orders

| Command         | Syntax                                          | Description                          |
| --------------- | ----------------------------------------------- | ------------------------------------ |
| `/limitbuy`     | `/limitbuy <amount> <CA> <price> [chain]`       | Auto-buy when price drops to target  |
| `/limitsell`    | `/limitsell <amount_or_%> <CA> <price> [chain]` | Auto-sell when price rises to target |
| `/limits`       | `/limits`                                       | View all open limit orders           |
| `/cancel_order` | `/cancel_order <order_id>`                      | Cancel a specific limit order        |

**`/limitbuy` — Limit Buy Order**

Places a buy order that triggers when the token price drops to your target.

```
/limitbuy <amount> <CA> <price> [chain]
```

* `<amount>` — Native currency to spend when triggered (e.g., `0.1`)
* `<CA>` — Token contract address
* `<price>` — Target USD price to trigger the buy
* `[chain]` — Optional. Defaults to your active chain

Examples:

```
/limitbuy 0.1 0x1a2b3c...4d5e 0.005 base
/limitbuy 0.5 0x1a2b3c...4d5e 0.001 bsc
```

**`/limitsell` — Limit Sell Order**

Places a sell order that triggers when the token price rises to your target. You can specify either a token amount or a percentage of your holdings.

```
/limitsell <amount_or_%> <CA> <price> [chain]
```

* `<amount_or_%>` — Token amount (e.g., `1000`) or percentage with `%` suffix (e.g., `50%`)
* `<CA>` — Token contract address
* `<price>` — Target USD price to trigger the sell
* `[chain]` — Optional. Defaults to your active chain

Examples:

```
/limitsell 50% 0x1a2b3c...4d5e 0.01 base       (sell 50% at $0.01)
/limitsell 1000 0x1a2b3c...4d5e 0.01 bsc        (sell 1000 tokens at $0.01)
```

**How to place a limit order via the trading board:**

1. Paste the token CA to open the trading board
2. Tap **Limit** on the board
3. Choose **Limit Buy** or **Limit Sell**
4. Set your target price and amount
5. Confirm — the order stays active until filled or cancelled

***

## Automation

| Command        | Description                                              |
| -------------- | -------------------------------------------------------- |
| `/dca`         | Open the DCA wizard — create, manage, and view DCA plans |
| `/snipe`       | Open the Smart Sniper wizard — set up token snipers      |
| `/automations` | View all active automations (TP/SL, limits, DCA, snipes) |

**`/dca` — Dollar-Cost Averaging**

Opens an interactive wizard to create and manage DCA plans. The wizard walks you through:

1. Select wallet
2. Enter token contract address
3. Select chain
4. Set total investment amount
5. Set slippage (0.1%–10%)
6. Set interval (1h, 4h, 12h, 1d, or custom like `30m`, `2h`, `6h`, `3d`)
7. Choose number of buys or per-order amount
8. Confirm

**`/snipe` — Smart Sniper**

Opens an interactive wizard to set up token snipers. The wizard walks you through:

1. Select wallet
2. Enter token contract address
3. Select chain
4. Set amount to snipe
5. Set slippage
6. Set trigger conditions
7. Confirm

***

## Portfolio & Analytics

| Command      | Syntax        | Description                     |
| ------------ | ------------- | ------------------------------- |
| `/bags`      | `/bags`       | View all your token holdings    |
| `/positions` | `/positions`  | View all your open positions    |
| `/chart`     | `/chart <CA>` | View price chart for a token    |
| `/audit`     | `/audit <CA>` | Run a security audit on a token |

**`/chart`** and **`/audit`** auto-detect which chain the token is on — no chain parameter needed.

Examples:

```
/chart 0x1a2b3c...4d5e
/audit DezXAZ8z7...abc
```

***

## Bridge

| Command   | Description                        |
| --------- | ---------------------------------- |
| `/bridge` | Open the interactive bridge wizard |

The bridge is fully interactive — type `/bridge` and the wizard walks you through selecting source chain, amount, destination chain, and confirmation.

Bridging is available between **Base, BSC, Mantle, and Solana**. MegaETH does not support bridging. See [Bridge](https://thorbot.gitbook.io/home/bridge/bridge).

***

## Social & Earnings

| Command        | Description                                 |
| -------------- | ------------------------------------------- |
| `/referral`    | View referral dashboard and share your link |
| `/leaderboard` | View the trading leaderboard                |
| `/cashback`    | Open the Cashback Center                    |

***

## Settings

| Command     | Description                                                    |
| ----------- | -------------------------------------------------------------- |
| `/settings` | Configure bot preferences (gas, slippage, MEV, TP/SL, presets) |

***

## No Command Needed

These actions work without typing a `/command`:

| Action                 | How                                   |
| ---------------------- | ------------------------------------- |
| **Open trading board** | Paste a contract address as a message |
| **View a position**    | Tap the token from 👜 Bags            |
| **Switch chains**      | Tap a chain button on the home screen |
| **Refresh balances**   | Tap 🔄 Refresh                        |
| **Navigate**           | Use the button menu on any screen     |

***

## Command Parameters

### `[chain]` — Optional chain parameter

Specifies which chain to trade on. If omitted, your currently active chain is used (default: `base`).

**Accepted values — use these exact strings:**

| Value     | Chain                 | Native Currency |
| --------- | --------------------- | --------------- |
| `base`    | Base                  | ETH             |
| `bsc`     | BSC (BNB Smart Chain) | BNB             |
| `mantle`  | Mantle                | MNT             |
| `megaeth` | MegaETH               | ETH             |
| `solana`  | Solana                | SOL             |

{% hint style="warning" %}
Use the exact chain names above. Abbreviations like `sol`, `eth`, `bnb`, or `mega` are **not accepted** — you must type the full value (`solana`, `base`, `bsc`, `megaeth`).
{% endhint %}

### `<CA>` — Contract address

The token's contract address.

* **EVM chains** (Base, BSC, Mantle, MegaETH): `0x` followed by 40 hex characters (e.g., `0x1a2b3c...4d5e`)
* **Solana:** Base58 format, 32–44 characters (e.g., `DezXAZ8z7...abc`)

### `<amount>` — Native currency amount

Amount of native currency to spend. Used in `/buy` and `/limitbuy`.

* Format: Decimal number (e.g., `0.1`, `0.5`, `1.0`)
* Must be greater than 0

### `<percentage>` — Sell percentage

Percentage of your token holdings to sell. Used in `/sell`.

* Range: 1–100
* Example: `50` sells 50% of your holdings, `100` sells everything

### `<price>` — Target price (USD)

The USD price target for limit orders. Used in `/limitbuy` and `/limitsell`.

* Format: Decimal number (e.g., `0.005`, `1.50`)
* `/limitbuy` triggers when price **drops to** this value
* `/limitsell` triggers when price **rises to** this value

***

## Home Screen Buttons

The home screen gives you quick access to all features:

| Button | Feature                                      |
| ------ | -------------------------------------------- |
| 👜     | **Bags** — View portfolio                    |
| 💼     | **Wallets** — Manage wallet slots            |
| 🌉     | **Bridge** — Cross-chain transfers           |
| 👥     | **Referral** — Earnings & links              |
| 🤖     | **Automations** — TP/SL, limits, DCA, snipes |
| 💰     | **Cashback** — Earnings on your own trades   |
| 🏆     | **Leaderboard** — Top traders                |
| ⚙️     | **Settings** — Configure preferences         |
| 📢     | **Community** — Join the community           |
| 📖     | **Docs** — Documentation                     |
| 🔄     | **Refresh** — Update balances                |

***

{% hint style="info" %}
**Tip:** Most users navigate through the button menu. Commands exist as power-user shortcuts for faster execution.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://thorbot.gitbook.io/home/reference/reference/commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.