Telegram Bot Integration

Manage Your Liquidity Strategies in Your Pocket!

The Position Manager Telegram Bot provides instant access to your liquidity strategies no matter where you are. Get real-time alerts, performance snapshots, and a comprehensive suite of management tools directly on Telegram. 1. Setup and Connection

You can link your Telegram account to Position Manager in two alternative ways:

• By entering your Telegram ID in the dashboard

• Or directly from the Telegram bot using the /link command

Both methods are secure and lead to the same result.

Method 1 – Link via Dashboard (Enter Telegram ID manually)

1. Find your Telegram User ID:

   • Search for @userinfobot or @GetMyIDBot in Telegram

   • Tap Start or send /start

   • The bot will immediately reply with your numeric ID (e.g. 123456789). Copy this number.

1. Log in to your Position Manager Dashboard.

2. Click your Profile icon (top-right) → go to the Account tab.

3. Paste your Telegram ID into the Telegram ID field and click Save.

1. Now open Telegram again:

• Search for the official bot: @SquadPosmanBot

• Tap Start

→ Connection complete! You’ll start receiving alerts automatically, and all commands will become available.

Method 2 – Link directly in the bot (Recommended – usually faster)

1. In Telegram, search for @SquadPosmanBot and tap Start.

2. Go back to your Position Manager Dashboard → Account tab (or profile settings).

3. Find your unique linking code displayed there (it looks like: 12345abc).

1. Send the /link command followed by your unique code:

/link 12345abc

1. Once the bot confirms the link (usually within seconds), you’re all set.

→ Alerts and management commands will start working immediately.

2. Instant Management Commands

Use these commands to interact with your strategies instantly:

Command	Action	Description
/performance	Profit Tracking	Provides a breakdown of fees collected over the last 24 hours, 7 days, and 30 days.
/summary	Portfolio Snapshot	Displays high-level information like Total TVL, number of active/total strategies, and Win Rate.
/top	The Leaderboard	Lists your top 3 performing strategies based on Efficiency (Yield/TVL).
/active	List Active Strategies	Provides a list of active strategies.
/alerts	Health Check	Lists all "At Risk Strategies" (inactive but not archived positions).
/v4status	Bin Range Check	(V4 only) Shows whether the price is currently Inside or Outside your current Bin Range.
/errors	Error Log	Displays recent failed transactions or strategy execution errors.
/help	Help Center	Lists all available commands with short explanations.
/getgasbalance	Gas Balance Check	Returns your current native gas token balance (e.g., BNB) for the wallet linked to your account.
/link <code>	Account Linking	Securely links your Telegram account to your Position Manager account using your unique linking code from the Dashboard.

3. Real-Time Smart Notifications

The bot proactively monitors your portfolio and sends alerts for critical events. 🔴 Critical Alerts (Immediate Action Required)

• Out of Range: Notifies you the exact moment your V3 or V4 position stops collecting fees because the price moved beyond your boundaries.

• Failed Repositioning: Alerts you if an automated management transaction (Force Push) fails (Highest Priority).

• Safety Trigger: Notification if a strategy is paused due to extreme price volatility (Max Deviation exceeded).

🟢 Status Updates (Informational)

• Bin Edge Proximity: Sends a warning when the market price is within 5 bins/ticks of your range edge.

• Repositioning Success: Confirmation that your strategy has successfully moved its liquidity to follow the market.

• Vault Milestone: Positive performance notifications (e.g., crossing a fee milestone).

⚠️ Gas Balance Alerts

• If your gas balance falls below the minimum threshold, the bot sends a notification every 10 minutes via Telegram to warn you.

4. Frequently Asked Questions (FAQ)

Q: The bot isn't responding to my commands.

A: First, ensure you have pressed Start in the bot chat. Second, double-check that the Telegram ID entered in your Account settings matches exactly what @userinfobot provided.

Q: Can I add the bot to a group?

A: Yes! You can add the bot to a private group with your team. Note that for security, the bot is configured to respond only to the authorized user linked to the account.

Q: Is my data safe?

A: Yes. The bot displays read-only data from your Dashboard. It cannot execute withdrawals or modify contract ownership. It acts strictly as a monitoring and reporting tool.

Q: Why do I need to enter my ID manually?

A: Telegram does not automatically share user IDs with external websites for privacy reasons. Manually entering your ID ensures that only you can link your specific Telegram account to your dashboard securely.