3. Private Setup Guide

This is a practical setup for personal use in private chat.

Step 1: Start the bot

  • Open @hl_positions_tracker_bot in Telegram.
  • Click Start.
  • Run /help to see the command surface.
  • Try a chart first:
hl HYPE 1h

Step 2: Track wallets

/track <your_address> MainWallet
/track_threshold 50000
/track_threshold_outcomes 5000

You can add several addresses at once under the same label or entity:

/track 0xabc...123 0xdef...456 Juan

Tracked wallets can alert on position changes, spot/HIP-4 fills, TWAPs, transfers, staking/unstaking, and liquidation risk.

Step 3: Add high-signal market alerts

Start with flow and liquidation context:

/show_twaps BTC 1000000
/nettwap_add BTC 5000000
/liquidation_add BTC 1000000
/big_position_add BTC 1000000

Then add price/funding/jump alerts if you want classic triggers:

/funding_add BTC below -0.0057
/jump_add BTC down 3 60 600
/price_add BTC 80000

Step 4: Add token transfers and reports

/transfers_add KNTQ 10000
/transfers_add deposit 100000
/hype_etf_subscribe
/hypestrat_subscribe
/leopold_subscribe

Step 5: Optional protocol modules

Hyperlend:

/hyperlend_supply USDH up 10
/hyperlend_borrow USDH up 15

HLP:

/hlp_alert
/hlp_alert on
/hlp_alert off

TVL:

/tvl
/tvl refresh

Rysk:

/rysk_calls HYPE
/rysk_subscribe 0x1234...abcd
/rysk_expiry 5000000

To add current-holder attribution and exercise-funding gaps to /rysk_expiry, set an Etherscan V2 key in .env:

ETHERSCAN_API_KEY=your-key

The key is optional: without it, the canonical OI/checkpoint alert still works, but the holder and wallet-liquidity block is marked unavailable.

Unstaking:

/unstaking_add 100000
/unstaking_timeleft 30

Step 6: Review and cleanup

Use:

/list
/funding_list
/jump_list
/price_list
/liquidation_list
/twap_list
/nettwap_list
/transfers_list
/hyperlend_list
/rysk_list
/rysk_expiry status
/unstaking_list

Then remove noise with the matching *_remove commands.

Batch command tip

You can send multiple commands in one message, one line each.

Example:

/funding_add mkts:US500 below -0.0057
/funding_add mkts:US500 above 0.0057
/jump_add mkts:US500 down 5 60 600
/jump_add mkts:US500 up 5 60 600