# Telegram Bot

### What Is It

Maple Bot (`@maple_fun_bot`) is your window into Maple.fun directly from Telegram. It tracks liquidity pools, shows you what's trending, and pushes live deposit and withdrawal notifications straight into your group chats. No need to keep the site open in another tab.

The bot talks to the Maple.fun backend in real time, so the data you see is always fresh.

***

### Getting Started

Add `@maple_fun_bot` to any Telegram chat (private or group) and type `/start`. You'll get a welcome message with everything you need to know. If you forget what's available, `/help` will remind you, and it's smart enough to show extra commands when you're inside a group.

***

### Looking Up Pools

Want to check out a specific pool? Use `/pool` followed by the pool's name or its Solana contract address.

```
/pool Mercedes
/pool Happy Pool
/pool FG57YCZJf41TZsntRwRVnczBdDbsjaqXnUN7te1AmRCq
```

Names are case-insensitive and support partial matches, so you don't need to get it exactly right. If the input is longer than 30 characters, the bot assumes it's a contract address.

***

### Trending & Top Pools

The bot gives you two ways to see what's hot.

**Top pools** are ranked by total number of participants. Use `/top` for the top 3 or `/top5` for the top 5.

**Trending pools** are ranked by growth over the last 36 hours. Use `/trending` for the top 3 or `/trending5` for the top 5.

For a quick snapshot of the platform overall, `/stats` pulls both top and trending data at once and gives you a clean summary.

***

### Setting Up Live Notifications

This is where things get interesting for group chats. If you run a community around a specific pool, you can pin that pool to your group and get live alerts whenever someone deposits or withdraws.

#### Pinning a Pool

Use `/setup` followed by the pool name or address. The bot will verify the pool exists, register your group, and start sending notifications. The default filter is set to $0.50, meaning transactions below that won't clutter your chat.

```
/setup Happy Pool
```

#### Controlling the Noise

Use `/setmin` to change the minimum USD threshold for notifications. This is admin-only, so random members can't mess with it.

```
/setmin 1      Notify for transactions $1.00 and above
/setmin 5      Only the big ones
/setmin 0      Everything, no filter
```

You can check your current settings anytime with `/getmin`, and if you want to stop notifications entirely, `/unpin` removes the pinned pool and goes silent.

#### What Notifications Look Like

**Deposits** show the USD value, token amount, pool name, and the depositor's shortened wallet address. If it's someone's first time depositing, you'll see a "New Participant" badge.

**Withdrawals** show the same info minus the new participant badge. Both types include links to the transaction on Solscan so anyone can verify on-chain.

***

### Quick Command Reference

| Command                     | What It Does                                    |
| --------------------------- | ----------------------------------------------- |
| `/start`                    | Welcome message and full command list           |
| `/help`                     | Available commands (context-aware)              |
| `/pool <name or address>`   | Look up a specific pool                         |
| `/top` or `/top5`           | Top pools by participants                       |
| `/trending` or `/trending5` | Fastest-growing pools (36h)                     |
| `/stats`                    | Platform overview                               |
| `/setup <pool>`             | Pin a pool for live notifications (groups only) |
| `/unpin`                    | Stop notifications (groups only)                |
| `/setmin <amount>`          | Set minimum USD for notifications (admin only)  |
| `/getmin`                   | Check current notification settings             |

***

### Support

Questions or issues? Reach out to [@ytzbeno](https://t.me/ytzbeno) on Telegram, or join the community through the links on [maple.fun](https://maple.fun/).


---

# 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://maplefun.gitbook.io/docs/risks-and-community/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.