# Bot Commands

The Telegram Bot provides simple commands for wallet, marketplace, swap, history, and referral flows.

| Command                                 | Purpose                                            |
| --------------------------------------- | -------------------------------------------------- |
| `/start`                                | Open the bot home menu.                            |
| `/createwallet`                         | Create a new non-custodial wallet session.         |
| `/importwallet`                         | Import an existing wallet into the active session. |
| `/disconnect`                           | Clear or disconnect the active session.            |
| `/wallet` or `/balance`                 | Show balances and wallet actions.                  |
| `/deposit`                              | Show a deposit address.                            |
| `/withdraw`                             | Start a withdrawal flow.                           |
| `/settings`                             | Show user settings.                                |
| `/marketplace`, `/orderbook`, or `/otc` | Open the OTC marketplace.                          |
| `/myswaps` or `/myotc`                  | View active and archived swaps.                    |
| `/history`                              | Show or export user history where available.       |
| `/referral` or `/ref`                   | Open the referral panel.                           |

## Referral Commands

The referral panel can show a referral link or code, referral stats, and referral activity where available. Referral claiming is currently paused while Black Pearl Market prepares a stronger competition and gamification model.

## Safety

The bot is non-custodial. It does not persist user private keys or seed phrases. Support will never ask for recovery material.


---

# 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://docs.blackpearlmarket.com/overview-1/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.