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. - 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

Disable routing in a specific topic:

/setalertstopic off

Step 3: Add shared market alerts

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

/funding_add km:USOIL below -0.0057
/jump_add km:USOIL down 5 60 600
/liquidation_add km:USOIL 1000000
/wick_catcher km:USOIL

Step 4: Verify final setup

/list
/help

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 (km:, xyz:, etc.) in communities.
  • Start with strict thresholds and relax only if signal is too low.