Reference

Slash command reference

Every command the CryptoWatchTools bot exposes, with its parameters, options, and who can run it. Type / in any channel to see them inline.

New to the bot?

Start with the feature overview and setup guide — it covers adding the bot, required permissions, and first-time configuration.

Member commands

Anyone in the server can run these. Responses come back as embeds in the channel where you run them.

/price

Everyone

The latest price for a coin, served from the CryptoWatchTools price cache (Binance-sourced).

Parameters

symboltextrequired
The cryptocurrency symbol (e.g., BTC, ETH).

Returns

An embed with the coin's current price.

/funding

Everyone

BloFin perpetual-futures funding-rate analysis. Deeply negative funding means shorts are paying longs — crowded shorts, the fuel for a squeeze.

Parameters

modechoicerequired
Type of funding analysis to perform.
Most Negative · negativeScanner (Overview) · scannerImproving (Less Negative) · improvingWorsening (More Negative) · worseningRecently Turned Positive · turnedCheck Specific Symbol · check
limitintegeroptionaldefault: 10
Number of results to show.
symboltextoptional
Symbol to check — only used with the Check Specific Symbol mode.

Returns

Color-coded embeds. Scanner shows all four categories at once; the other modes return a single ranked list.

Notes

Scanner is the fastest read of the whole board; the other modes drill into one angle.
limit only affects list length; symbol only applies to Check mode.

/volatility

Everyone

Top movers and volatility across timeframes from 5 minutes to 48 hours.

Parameters

modechoicerequired
Type of volatility analysis.
Scanner (Top Movers) · scannerMost Volatile · moversCheck Specific Symbol · check
timeframechoiceoptionaldefault: 1h (for Scanner / Most Volatile)
Time period for analysis.
5 minutes · 5m15 minutes · 15m1 hour · 1h4 hours · 4h24 hours · 24h48 hours · 48h
limitintegeroptionaldefault: 10
Number of results to show.
symboltextoptional
Symbol to check — only used with the Check Specific Symbol mode.

Returns

An embed of top movers with percentage change. Check mode shows one coin's move across every timeframe.

Notes

Thresholds scale with the window — roughly 2% at 5m up to 30% at 48h — so a coin has to move meaningfully to appear.

/mystats

Everyone

Your own engagement over the last 30 days: message count, active days, current roles, and progress toward the Active role.

Returns

An embed with your 30-day activity and role status.

Notes

Server-only — it reads your activity in the server you run it in.

/about

Everyone

What the bot does, where its data comes from, and useful links.

Returns

An info embed.

/help

Everyone

Every command grouped by category. Server admins also see the admin and setup commands.

Returns

A reference embed. Admin sections appear only for administrators.

Admin & setup commands

These configure the bot and manage members. Unless noted, they need the Administrator permission and reply privately (ephemeral), so only you see the output.

/setup

Administrator

The server's feature switchboard. Show the current configuration or toggle a feature on and off.

Parameters

actionchoicerequired
Configuration action to perform.
Show Configuration · showToggle Engagement Tracking · engagementToggle Engagement Enforcement · enforce_engagementToggle Market Events · marketToggle Market Display · market_displayCheck Engagement Status · engagement_status

Returns

A private (ephemeral) embed. Show lists channels, features, and thresholds; toggles confirm the new state; Status reports how much engagement data has been collected.

Notes

Toggle Market Events needs the channels set first via /setup_market_channels.
Toggle Engagement Tracking creates the NewMember / Member / Active / Vacation roles if they don't exist yet.

/setup_alerts

Administrator

Route a category of alert — or a specific TradingView signal source — to a text channel.

Parameters

channeltext channelrequired
Text channel that will receive the alerts.
alert_typechoice (autocomplete)required
Type of alerts for this channel.
Market Events · market_eventsFunding Rates · fundingGeneral Alerts · alerts📡 (your live TradingView signal sources) · signal_…

Returns

An ephemeral confirmation naming the channel and alert type.

Notes

The TradingView signal sources in the dropdown are pulled live from CryptoWatchTools; choosing one starts delivering that source's signals to the channel.

/setup_timezone

Administrator

Turn a voice channel into a live clock for any timezone. The name updates every 5 minutes.

Parameters

channelvoice channelrequired
Voice channel to display the timezone.
timezonetext (autocomplete)required
Timezone to display — type to search all 597 IANA timezones.

Returns

An ephemeral confirmation. The channel is renamed immediately, e.g. “Tokyo 3:45pm”.

Notes

Autocomplete surfaces 25 popular zones but accepts any IANA zone. Times round to the nearest 5 minutes.

/setup_market_channels

Administrator

Set up the market-session countdown and schedule. This also switches Market Events on.

Parameters

countdown_channelvoice channelrequired
Voice channel for the live countdown to the next session.
schedule_channeltext channelrequired
Text channel that holds the pinned market schedule.

Returns

An ephemeral confirmation listing both channels.

Notes

The voice channel counts down to the next session; the text channel keeps a pinned schedule of the London, US, and Asia opens and closes, refreshed every 5 minutes. Stock-market sessions are skipped on weekends.

/market_display

Administrator

Show live prices or market stats in voice-channel names, e.g. “BTC: $67.5k” or “Fear & Greed: 72”.

Parameters

actionchoicerequired
Action to perform.
Add Channel · addRemove Channel · removeList Channels · listSet Update Interval · interval
channelvoice channeloptional
Voice channel to configure — required for Add and Remove.
data_typechoiceoptional
What kind of data to show — required for Add.
Coin Price · coin_priceMarket Info · market_info
symboltextoptional
Coin symbol for a price (BTC, ETH, SOL…) or a field name for Market Info — required for Add. Market Info fields: btc_dominance, eth_dominance, fear_greed, total_market_cap, total_volume_24h, altseason_index, stablecoin_mcap, defi_mcap.
custom_labeltextoptional
Optional label to prefix the channel name.

Returns

An ephemeral embed. List shows every configured channel, its data, status, and update interval.

Notes

Values refresh every 5 minutes (the minimum interval). Requires Market Display enabled via /setup.

/admin

Administrator

The engagement operations console — analyze activity, inspect members, refresh roles, and backfill history.

Parameters

actionchoicerequired
Admin action to perform.
Analyze Activity · analyzeShow Active Members · activeShow Inactive Members · inactiveCheck Member Stats · check_memberRefresh Roles · refreshBackfill Data · backfillGrant Vacation · vacationTest Warning · test_warningEngagement Settings · settingsConfigure Thresholds · configure
membermemberoptional
Target member — only for Check Member, Grant Vacation, and Test Warning.
limitintegeroptionaldefault: 10
Number of results — only for Analyze, Active, Inactive, and Backfill.

Returns

Ephemeral embeds for each action.

Notes

Backfill scans past messages to seed the engagement database — run it once after enabling tracking so history counts.
Grant Vacation preserves a member's Active status while they're away; Refresh Roles re-evaluates everyone now.

/admin_config

Administrator

Set the thresholds a member has to hit to earn the Active role.

Parameters

messagesintegeroptional
Messages required for the Active role.
active_daysintegeroptional
Number of distinct days with activity required.
periodintegeroptionaldefault: 30
Number of days to look back over.

Returns

An ephemeral confirmation of the new thresholds.

Notes

Defaults: 10 messages over a 30-day window.

/set_channels

Administrator

Point the engagement system at your welcome, intro, and log channels.

Parameters

channel_typechoicerequired
Which engagement channel to configure.
Welcome Channel · welcomeIntroduction Channel · introEngagement Log Channel · engagement_log
channeltext channelrequired
The text channel to use.

Returns

An ephemeral confirmation.

/purge

Manage Messages

Bulk-delete recent messages in the current channel.

Parameters

amountintegeroptionaldefault: 100
Number of messages to delete (1–100).
reasontextoptional
Reason for the purge (recorded in the log).

Returns

An ephemeral confirmation plus a brief public notice; the action is logged.

Notes

Needs the Manage Messages permission, not full admin.
Discord only bulk-deletes messages under 14 days old.

Vesper AI (chat)

Vesper isn't a slash command — you talk to it by mentioning the bot. Type an @mention followed by your question and it replies in the channel, with live market context pulled in for price questions. It keeps about 30 minutes of conversation memory per channel and has a 3-second per-user cooldown.

Type this	Who	What it does
`@bot <your question>`	Everyone	Ask Vesper anything about crypto or the market.
`@bot hal_help`	Everyone	Show Vesper's usage help and example prompts.
`@bot hal_clear`	Manage Messages	Wipe Vesper's conversation memory for the current channel.

The help and memory-clear utilities use the bot's legacy hal_ names. They're invoked by mention (e.g. @CryptoWatchTools hal_help), not with a ! prefix.

Feature overview & setup →What the bot does, how to add it, and the first-time setup checklist.Open the dashboard →The same scanners and Vesper AI on the web.