2. Commands

This section explains the command surface by workflow, with practical examples so you can set up alerts fast and avoid common mistakes.

Current limits

  • Addresses: 10
  • Funding alerts: 10
  • Price alerts: 20
  • Jump alerts: 20
  • External liquidation alerts: 10
  • TWAP alerts: 10
  • Net TWAP alerts: 10
  • Hyperlend alerts: 20
  • Rysk subscriptions: 10
  • Owned profiles: 10
  • Profile subscriptions: 2

Basic bot commands

Use these first to initialize and check your setup.

Commands:

  • /start
  • /help
  • /list

Example behavior:

  • /start gives onboarding and quick setup hints.
  • /help shows the main command overview.
  • /list shows your active configuration and alert counters.

Address liquidation risk

Lets you get near-liquidation alerts for any addresses you want to follow.

Example behavior:

  • If you track 0x123... with threshold 0.5, and one of its positions comes within 0.5% of liquidation, the bot sends an alert.

Commands:

  • Set address to track: /add <address> [label]
  • Remove one or all tracked addresses: /remove [address]
  • Set liquidation threshold: /threshold <percent>
  • Set cooldown for these alerts: /cooldown <seconds>
  • List current setup: /list

Examples:

/add 0x1234...abcd OilWhale
/threshold 0.5
/cooldown 600
/remove 0x1234...abcd

Notes:

  • threshold must be > 0 and <= 100.
  • cooldown must be between 60 and 86400 seconds.

Funding alerts

Tracks positive/negative funding conditions for a market.

Example behavior:

  • If you set below -0.0057 on km:US500, the alert triggers when funding is at or below that value.

Commands:

  • Add funding alert: /funding_add <coin> <negative|positive|below|above> [percent]
  • List funding alerts: /funding_list
  • Remove all funding alerts for one market: /funding_remove <coin>

Examples:

/funding_add km:US500 negative
/funding_add km:US500 below -0.0057
/funding_add km:US500 above 0.0100
/funding_remove km:US500

Price cross alerts

One-shot level alerts that trigger when price crosses a target.

Example behavior:

  • If you set /price_add BTC 80000, the alert fires when BTC crosses 80,000 in either direction, then auto-disables.

Commands:

  • Add alert: /price_add <coin> <price>
  • List alerts: /price_list
  • Remove alerts by market: /price_remove <coin>

Examples:

/price_add BTC 80000
/price_add spot:KNTQ 0.35
/price_remove BTC

Price jump alerts

Tracks directional moves over a time window.

Example behavior:

  • /jump_add km:US500 down 5 60 600 triggers when km:US500 drops 5% in 60 minutes, with 600s cooldown.

Commands:

  • Add jump alert: /jump_add <coin> <up|down> <percent> <minutes> [cooldown_seconds]
  • List jump alerts: /jump_list
  • Remove jump alert: /jump_remove <alert_id>
  • Change jump cooldown: /jump_cooldown <alert_id> <seconds>

Examples:

/jump_add km:US500 up 5 60 600
/jump_add km:US500 down 5 60 600
/jump_cooldown 12 300

Notes:

  • percent must be between 0 and 100.
  • minutes must be between 1 and 1440.
  • jump cooldown must be between 60 and 86400 seconds.

External liquidation alerts

Tracks large liquidation fills in a selected market.

Example behavior:

  • If you set /liquidation_add BTC 1000000, you get alerts when external liquidations on BTC are at least $1M.

Commands:

  • Add alert: /liquidation_add <coin> <usd_notional>
  • List alerts: /liquidation_list
  • Remove alert: /liquidation_remove <coin>

Examples:

/liquidation_add BTC 1000000
/liquidation_remove BTC

Wick catcher

Designed to detect potential wick events around liquidations.

Example behavior:

  • You receive alerts for high-impact pre/post liquidation setups, according to Wick Catcher logic.

Commands:

  • Add wick catcher: /wick_catcher <coin>
  • List wick catcher alerts: /wick_catcher_list
  • Remove wick catcher alert: /wick_catcher_remove <coin>

Examples:

/wick_catcher BTC
/wick_catcher km:US500
/wick_catcher_remove BTC

TWAP and Net TWAP alerts

Tracks large TWAP flow and net TWAP pressure.

Example behavior:

  • /twap_add BTC 10000000 triggers on new large buy TWAPs.
  • /twap_add BTC -5000000 triggers on new large sell TWAPs.
  • /nettwap_add BTC 3000000 triggers when net active TWAP (buy-sell) is at least +$3M.

Commands:

  • Add TWAP alert: /twap_add <coin> <usd_notional>
  • List TWAP alerts: /twap_list
  • Remove TWAP alert: /twap_remove <coin>
  • Add net TWAP alert: /nettwap_add <coin> <usd_notional>
  • List net TWAP alerts: /nettwap_list
  • Remove net TWAP alert: /nettwap_remove <coin>
  • Show active TWAPs: /show_twaps <coin> <min_usd_notional>

Examples:

/twap_add BTC 10000000
/twap_add BTC -5000000
/twap_add HYPE 2000000
/twap_add HYPE-PERP 2000000
/nettwap_add BTC 3000000
/show_twaps BTC 1000000

Next liquidations map

Shows near liquidation levels for a market direction.

Example behavior:

  • /nextliquidations down BTC 1000000 10 returns up to 10 relevant downside liquidation levels above your minimum notional.

Commands:

  • /nextliquidations <up|down> <coin> <min_usd_notional> [count]

Example:

/nextliquidations down BTC 1000000 10

Hyperlend alerts

Tracks supply and borrow APY conditions.

Example behavior:

  • /hyperlend_supply USDH up 10 triggers when USDH supply APY goes above 10%.

Commands:

  • /hyperlend_supply <coin> <up|down> <percent>
  • /hyperlend_borrow <coin> <up|down> <percent>
  • /hyperlend_list
  • /hyperlend_remove <supply|borrow> <coin>

Examples:

/hyperlend_supply USDH up 10
/hyperlend_borrow USDH up 15

Rysk commands

Lets you monitor options availability and wallet expiries.

Commands:

  • /rysk_calls <underlying>
  • /rysk_puts <underlying>
  • /rysk_subscribe <address>
  • /rysk_unsubscribe <address>
  • /rysk_list

Examples:

/rysk_calls HYPE
/rysk_puts BTC
/rysk_subscribe 0x1234...abcd

Unstaking alerts

Tracks new unstaking requests above your minimum size.

Commands:

  • /unstaking_add <min_hype_amount>
  • /unstaking_list
  • /unstaking_timeleft <minutes>
  • /unstaking_remove

Examples:

/unstaking_add 100000
/unstaking_timeleft 30

Profiles

Profiles are reusable alert bundles that can be shared publicly.

Commands:

  • /profiles_help
  • /profiles_create <name>
  • /profiles_edit <profile_id>
  • /profiles_exit
  • /profiles_list
  • /profiles_share <profile_id>
  • /profiles_import <share_token>
  • /profiles_subscribe <profile_id>
  • /profiles_unsubscribe <profile_id>
  • /profiles_activate <profile_id>
  • /profiles_deactivate <profile_id>
  • /profiles_alerts <profile_id>
  • /profiles_changelog <profile_id>
  • /profiles_revoke <profile_id> [on|off]
  • /profiles_delete <profile_id>
  • /profiles_ranking

Referrals

Use referrals to grow your distribution.

Commands:

  • /referrals

How it works:

  • The command returns your personal referral link and your referral count.
  • If someone subscribes to a profile you created and that person has no referrer yet, they are automatically assigned to your referral.

Why this matters:

  • Sharing profiles usually converts better than sharing only a plain referral link.
  • Referrals are expected to unlock higher limits and more premium features in future updates.

Group topic routing

Use this in topic-enabled groups to control where each alert type is posted.

Command:

  • /setalertstopic <filters>

Examples:

/setalertstopic all
/setalertstopic prices
/setalertstopic funding,prices,jumps
/setalertstopic off

Important:

  • Run the command inside the exact topic where you want those alerts to appear.
  • For split routing, go into each topic and run setalertstopic with different filters.