4. Group Setup Guide

Group behavior

  • Alerts in groups are shared for all members.
  • Only group admins can configure alerts.

Step 1: Add the bot as admin

  • Add @hl_positions_tracker_bot to the group.
  • Promote it to admin (recommended) so it can work cleanly with group/topic flows.
  • Make sure your setup account is also a group admin.

Step 2: Decide routing mode (single topic vs split topics)

If your group has topics, routing is configured per topic.

Single-topic mode: - Open the topic where you want all alerts. - The default/general topic also works. - Run:

/setalertstopic all

Split-topic mode: - Go to Topic A and run:

/setalertstopic funding
  • Go to Topic B and run:
/setalertstopic prices,jumps
  • Go to Topic C and run:
/setalertstopic twaps,nettwaps
  • Go to Topic D and run:
/setalertstopic liquidations,external_liquidations
  • Go to Topic E and run:
/setalertstopic movements
  • Go to Topic F and run:
/setalertstopic gamification

Disable routing in a specific topic:

/setalertstopic off

Step 3: Add shared market alerts

Now add the actual alerts (same commands as private mode):

/track 0x1234...abcd MarketMakerX
/track_threshold 50000
/track_threshold_outcomes 5000
/show_twaps HYPE 1000000
/nettwap_add HYPE 5000000
/liquidation_add BTC 1000000
/big_position_add BTC 1000000
/transfers_add KNTQ 10000
/transfers_add withdrawal 100000

Step 4: Add shared feeds

/hype_etf_subscribe
/hypestrat_subscribe
/leopold_subscribe

Step 5: Verify final setup

/list
/help
hl HYPE 1h

Check that:

  • Alert routes point to the intended topics.
  • Alert counts are correct.
  • No duplicated or conflicting routing exists.

Good practices

  • Keep one or two admins in charge of bot setup.
  • Use explicit market symbols (mkts:, xyz:, etc.) in communities.
  • Start with strict thresholds and relax only if signal is too low.
  • Use setalertstopic to keep high-volume alerts out of general chat.