# Telegram Bot User Guide

The Telegram Bot is a non-custodial trading assistant for Black Pearl Market. It helps users open wallet views, browse the orderbook, create or take orders, follow swaps, use referrals, and recover from pending states.

Official bot: [BlackPearlMarket\_bot](http://t.me/BlackPearlMarket_bot)

## Safety First

* Use only the official bot.
* The bot does not persist user private keys or seed phrases.
* Never send wallet recovery material to support, admins, bots, websites, or other users.
* Use private chat with the bot, not group chats, for wallet actions.

## Common Commands

| Command                  | Purpose                          |
| ------------------------ | -------------------------------- |
| `/start`                 | Open the bot home menu.          |
| `/wallet`                | View wallet and balance actions. |
| `/deposit`               | Show a deposit address.          |
| `/withdraw`              | Start a withdrawal flow.         |
| `/otc` or `/marketplace` | Open the OTC marketplace.        |
| `/myswaps`               | View active and archived swaps.  |
| `/referral` or `/ref`    | Open the referral panel.         |

## Bot-Assisted Orders

Bot-Assisted Orders can settle faster because eligible Telegram session steps may be automated when readiness checks pass. The bot is a convenience layer, not a custody layer. It does not replace the smart contract lifecycle.

Human-Confirmed Orders use the same protocol, but some steps may wait for a user or counterparty to manually confirm.

## Referrals

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

Upcoming rules may let active participants compete for stronger reward positions, including the possibility to increase the percentage shared with them. Final rules will be announced through official channels.

## Leaderboard

Users can follow rank and points from eligible trading activity. Tiers and multipliers can boost points. Points are not currently a token, equity, or guaranteed financial reward.

## If Something Looks Stuck

1. Refresh the bot message.
2. Check My Swaps.
3. Check any transaction hash on the relevant explorer.
4. Wait a few minutes if the transaction was recent.
5. Contact support with public details only.

Public support details include wallet address, transaction hash, order/deal id, screenshot, and approximate time.


---

# 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/wallet/telegram-bot.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.