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
  • HLP alert: 1
  • Rysk subscriptions: 10
  • Owned profiles: 10
  • Profile subscriptions: 2

Basic bot commands

Use these first to initialize and check your setup.

Commands:

  • /start
  • /help
  • /outcomes
  • /list

Example behavior:

  • /start gives onboarding and quick setup hints.
  • /help shows the main command overview.
  • /outcomes shows currently open HIP-4 outcomes on mainnet.
  • /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.

Wallet movement tracking

Tracks wallet position movements such as opens, closes, liquidations, ADL, and TWAP starts/finishes.

Example behavior:

  • /track 0x1234...abcd Juan tracks that address with label Juan.
  • /entity_create MarketMakerX creates an entity.
  • /track 0x1234...abcd MarketMakerX tracks the address under that entity if the entity exists.
  • Alerts are aggregated by address/entity in a 60-minute window instead of sending every fill.

Commands:

  • Track an address: /track <address> [label or entity]
  • Stop tracking an address: /track_remove <address>
  • List tracked addresses/entities: /track_list
  • Set movement threshold: /track_threshold <usd_notional>
  • Create an entity: /entity_create <name>
  • List entities: /entity_list
  • Delete an entity with confirmation: /entity_delete <name>

Examples:

/entity_create Juan
/track 0x1234...abcd Juan
/track_threshold 25000
/track_list
/track_remove 0x1234...abcd
/entity_delete Juan

Notes:

  • Minimum movement threshold is $1,000.
  • Private chat tracking is personal to you.
  • Group tracking is shared for that group, and setup commands require group admin permissions.
  • In topic-enabled groups, use /setalertstopic movements or /setalertstopic all to route movement alerts.

Smart address labels and risk context

Many relevant addresses are labeled automatically inside alerts, so you can identify the entity behind the flow faster.

Example behavior:

  • If a known address triggers an external liquidation, wick, or unstaking alert, the alert can show the entity name instead of only the raw wallet.
  • Some unstaking alerts also include quick context such as market maker / delta-neutral or liquid staking deployer risk profile.

Commands:

  • No setup required. This is built into alert rendering.

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

Notes:

  • The bot rechecks triggered TWAP and Net TWAP alerts shortly after trigger.
  • If the flow disappears almost immediately with suspicious execution or error patterns, the original alert can be edited as likely spoofing.
  • For HYPE TWAPs, HYPE means spot and HYPE-PERP means perp.

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

Liquidation heatmap

Generates a liquidation heatmap image for a market around current price. When Hydromancer TP/SL data is available, take-profit and stop-loss trigger orders are overlaid as separate color layers.

Example behavior:

  • /heatmap HYPE 20 120 renders the liquidation distribution from -20% to +20% with 120 bins.

Commands:

  • /heatmap <coin> [range_pct] [bins]

Examples:

/heatmap HYPE
/heatmap BTC 20
/heatmap km:US500 25 140

Market structure

Returns a compact market structure snapshot for a selected lookback window.

Example behavior:

  • /market_structure HYPE 30 returns price change, OI change, near-liquidation buckets, depth, and key walls over 30 minutes.

Commands:

  • /market_structure <coin> <minutes>

Examples:

/market_structure HYPE 30
/market_structure BTC 60
/market_structure km:USOIL 120

Top positions by OI

Returns the 10 largest open positions for one perp market, ranked by USD notional (position OI).

Example behavior:

  • /top10positions xyz:ORCL returns the largest open positions for that market, with side, notional, OI share, size, entry, liquidation price, and trader link.

Commands:

  • /top10positions <coin>

Examples:

/top10positions HYPE
/top10positions BTC
/top10positions xyz:ORCL

Basket TVL snapshot

Returns the current basket TVL snapshot and, when available, a chart of recent history.

Example behavior:

  • /tvl returns the cached or latest basket TVL snapshot.
  • /tvl refresh bypasses the short cache and recalculates the snapshot.

Commands:

  • /tvl
  • /tvl refresh

HLP alert

Tracks high-signal HLP vault events with fixed thresholds.

Example behavior:

  • /hlp_alert shows whether your HLP alert is on or off.
  • /hlp_alert on enables the alert.
  • /hlp_alert off disables the alert.

Commands:

  • /hlp_alert
  • /hlp_alert on
  • /hlp_alert off

Notes:

  • The alert uses fixed thresholds: PnL delta of $100,000 over 60 minutes, large opens of $1,000,000, and a 1,800s cooldown.

Inline market charts

Generates a price chart directly from a normal text message, without using a slash command.

Example behavior:

  • Sending hl HYPE 15m returns a HYPE chart with local tops and bottoms marked.
  • Sending hl KNTQ 1h returns the spot chart if that market exists in spot.

Commands:

  • Inline syntax: hl <asset> <timeframe>

Examples:

hl HYPE 5m
hl BTC 1h
hl KNTQ 4h
hl km:USOIL 1d

Notes:

  • Supported timeframes: 1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M.
  • Works in private chats and groups.
  • For assets that exist in both scopes, use the same market naming rules as the bot elsewhere.

Big position alerts

Tracks large position open/add and close/reduce events above your threshold. Spot markets use a rolling 60-minute buy/sell window.

Example behavior:

  • /big_position_add km:US500 1000000 alerts when a >=$1M position event is detected for that market.

Commands:

  • Add big position alert: /big_position_add <coin> <usd_notional>
  • List big position alerts: /big_position_list
  • Remove big position alert: /big_position_remove <coin>

Examples:

/big_position_add km:US500 1000000
/big_position_list
/big_position_remove km:US500

Transfer alerts

Tracks large spot token transfers above your threshold.

Example behavior:

  • /transfers_add KNTQ 10000 alerts when a >=$10K KNTQ transfer is detected.

Commands:

  • Add transfer alert: /transfers_add <token> <usd_notional>
  • List transfer alerts: /transfers_list
  • Remove transfer alert: /transfers_remove <token>

Examples:

/transfers_add KNTQ 10000
/transfers_list
/transfers_remove KNTQ

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 transfers
/setalertstopic funding,prices,jumps
/setalertstopic off

Available filters include all, liquidations, external_liquidations, big_positions, transfers, movements, funding, prices, jumps, twaps, and nettwaps.

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.