Bot Commands

Complete list of slash commands available in hambot. Use these commands in your Discord server to access amateur radio tools and information.

Lookup Tools

/call

Look up detailed information about any amateur radio callsign. Searches both Callook (for US callsigns) and HamQTH databases. Returns operator name, address, license class, grid square, and other registration details. Automatically falls back between databases if one doesn't have the callsign.

Usage:/call <callsign>
Example:/call W1AW

Capabilities

  • Searches Callook API for US callsigns
  • Falls back to HamQTH for international callsigns
  • Displays operator name, address, license class
  • Shows grid square and other registration details
  • Returns source information for data transparency

/dx

Get comprehensive DXCC (DX Century Club) information for any callsign prefix. Shows the DXCC entity, CQ zone, ITU zone, continent, and time zone offset. Useful for identifying where a station is located and understanding propagation paths.

Usage:/dx <prefix>
Example:/dx K1

Capabilities

  • DXCC entity identification
  • CQ and ITU zone information
  • Continent and time zone data
  • Works with any valid callsign prefix
  • Uses up-to-date DXCC database

Solar & Propagation

/cond

View current solar conditions including solar flux, sunspot numbers, A-index, K-index, and solar activity maps. Essential for understanding current HF propagation conditions and predicting band openings. Data sourced from hamqsl.com.

Usage:/cond
Example:/cond

Capabilities

  • Real-time solar flux index
  • Sunspot number and solar activity
  • A-index and K-index geomagnetic data
  • Solar activity visualization maps
  • Updated regularly for current conditions

/muf

Display Maximum Usable Frequency (MUF) propagation map showing the highest frequency that can be used for skywave propagation between two points. Critical for determining which HF bands are open for long-distance communication. Source: prop.kc2g.com

Usage:/muf
Example:/muf

Capabilities

  • MUF predictions for different paths
  • Visual propagation map
  • Helps determine open HF bands
  • Updated with current ionospheric conditions
  • Essential for DX planning

/fof2

View Frequency of F2 Layer (foF2) map showing the critical frequency of the F2 ionospheric layer. Particularly useful for NVIS (Near Vertical Incidence Skywave) propagation on lower HF bands like 80m and 40m. Source: prop.kc2g.com

Usage:/fof2
Example:/fof2

Capabilities

  • F2 layer critical frequency data
  • NVIS propagation planning
  • Lower HF band conditions
  • Regional propagation analysis
  • Updated ionospheric data

/drap

Display D Region Absorption Prediction (DRAP) map showing areas where solar radiation is causing increased absorption in the D layer of the ionosphere. High absorption can significantly reduce HF signal strength, especially on lower frequencies.

Usage:/drap
Example:/drap

Capabilities

  • D layer absorption predictions
  • Solar radiation impact visualization
  • Signal degradation warnings
  • Lower frequency band conditions
  • Real-time absorption data

DX Cluster & Spot Monitoring

/dxspots

Display recent DX Cluster spots with filtering options. View real-time spots from connected DX Cluster servers. The filter parameter can be: a number (limits results to that count), a recognized band name like "20m" or "40m" (filters by frequency range), or any text (searches in callsign or spotter name). Shows frequency, mode, spotter, and timestamp for each spot. Default shows last 10 spots if no filter provided.

Usage:/dxspots [filter]
Example:/dxspots 10 or /dxspots 20m or /dxspots W1AW

Capabilities

  • Real-time DX Cluster spot monitoring
  • Filter by callsign or spotter (text search)
  • Filter by recognized band names (20m, 40m, etc.) - filters by frequency range
  • Limit results by count (numeric filter)
  • Shows frequency, mode, spotter, and timestamp
  • Displays up to 20 spots per embed
  • Automatic connection to configured DX Cluster servers
  • Default shows last 10 spots if no filter

Alert Management

/addalert

Create an alert to receive DM notifications when a specific callsign or prefix is spotted on PSKReporter or DX Cluster. You can specify modes (FT8, FT4, CW, etc.) or leave empty to match all modes. Choose data source: "all" (both PSKReporter and DX Cluster), "pskreporter" (digital modes only), or "dxcluster" (all modes). Alerts automatically expire after 30 days (configurable). Alert DMs are automatically deleted after 1 hour to keep your inbox clean. Built-in deduplication and throttling prevent spam.

Usage:/addalert <callsign_or_prefix> [modes] [data_source]
Example:/addalert W1AW or /addalert W1AW FT8,FT4 or /addalert K1 pskreporter

Capabilities

  • Monitor callsigns or prefixes
  • Filter by specific modes (FT8, FT4, PSK31, CW, RTTY, etc.)
  • Match all modes if none specified
  • Choose data source: all, pskreporter, or dxcluster
  • Receive instant DM notifications when spotted
  • Alerts expire after 30 days (configurable via ALERT_EXPIRATION_DAYS)
  • Alert DMs auto-delete after 1 hour
  • Smart deduplication prevents duplicate alerts
  • Per-alert cooldown: 5 minutes (prevents spam from same alert)
  • Per-user rate limit: 20 alerts per hour maximum
  • Cross-source deduplication: same callsign+mode within 5 minutes = one alert
  • Supports both digital and analog mode monitoring

/removealert

Remove one or more alerts by callsign/prefix or specific alert ID. If you call the command without arguments, it will list your active alerts. You can remove alerts by typing the callsign/prefix or the numeric alert ID shown in the alert list.

Usage:/removealert [callsign_or_alert_id]
Example:/removealert W1AW or /removealert 123

Capabilities

  • Remove by callsign or prefix (removes all matching alerts)
  • Remove by specific alert ID
  • List all alerts if no argument provided
  • Shows alert details before removal
  • Confirms successful removal

/listalerts

Display all your currently active alerts in a formatted list. Shows callsign/prefix, monitored modes, data source, expiration date, and alert ID for easy reference. Useful for managing multiple alerts.

Usage:/listalerts
Example:/listalerts

Capabilities

  • Lists all active alerts
  • Shows callsign/prefix, modes, and data source
  • Displays expiration dates
  • Includes alert IDs for easy removal
  • Formatted embed for easy reading

Server Management

/metrics

View comprehensive command usage statistics for your Discord server. Shows total commands executed, error rates, top commands by usage, and tracking duration. Only accessible to server administrators and the bot owner. Helps understand how hambot is being used in your community.

Usage:/metrics
Example:/metrics

Capabilities

  • Total command count and error statistics
  • Top 10 most used commands with percentages
  • Error rate calculation
  • Tracking duration and first seen date
  • Admin-only access for privacy
  • Per-server statistics (not available in DMs)
  • Real-time metrics updates

Resources & Learning

/study

Get comprehensive study resources and proven strategies for passing your amateur radio license exam. Includes links to Ham Radio Crash Course videos, detailed instructions for using ham.study (free online study tool), and a step-by-step study method that has helped many hams pass their exams. Covers Technician, General, and Extra class preparation.

Usage:/study
Example:/study

Capabilities

  • Study method from experienced ham (K6YXH)
  • Links to Ham Radio Crash Course videos
  • Instructions for ham.study (free tool)
  • Step-by-step study progression guide
  • Tips for Technician, General, and Extra exams
  • Best practices for exam preparation

/testing

Information about taking your amateur radio license examination. Provides links to the HRCC VE (Volunteer Examiner) team testing information, including how to schedule exams, what to bring, and what to expect during the testing process.

Usage:/testing
Example:/testing

Capabilities

  • HRCC VE team testing information
  • Exam scheduling details
  • What to expect during testing
  • Links to official testing resources

/hamlive

Complete guide to using Ham.Live for participating in the HRCC HF Net and other live ham radio events. Includes setup instructions, account creation, how to provide signal reports during nets, and tips for getting the most out of the interactive net experience. Covers both Google login and email-based authentication.

Usage:/hamlive
Example:/hamlive

Capabilities

  • HRCC HF Net participation guide
  • Account setup instructions
  • Signal reporting during nets
  • Interactive features explanation
  • Profile picture setup
  • Troubleshooting and support information

Utilities

/utc

Display the current Universal Coordinated Time (UTC), the standard time reference used in amateur radio. Shows both the date and time in UTC format, essential for scheduling contacts, net times, and understanding propagation predictions which are all based on UTC.

Usage:/utc
Example:/utc

Capabilities

  • Current UTC date and time
  • Standardized time reference
  • Essential for net scheduling
  • Used for propagation predictions

/uptime

Show how long hambot has been running continuously. Displays uptime in a human-readable format (days, hours, minutes, seconds). Useful for checking bot status and reliability.

Usage:/uptime
Example:/uptime

Capabilities

  • Bot uptime in readable format
  • Days, hours, minutes, seconds
  • Status and reliability indicator

/help

Display a comprehensive help message listing all available hambot commands with brief descriptions. Quick reference for discovering what the bot can do and how to use various features.

Usage:/help
Example:/help

Capabilities

  • Complete command list
  • Brief descriptions of each command
  • Quick reference guide
  • Organized by category

/about

Show information about hambot including the bot version, owner, invite link to add hambot to your server, and link to the source code repository. Great for sharing hambot with others!

Usage:/about
Example:/about

Capabilities

  • Bot information and version
  • Server invite link
  • Source code repository link
  • Owner information

Need Help?

If you encounter any issues or have questions about using hambot, check out the GitHub repository or open an issue.