X Bot Commands
Complete reference guide for all X Bot commands. Commands are organized by category for easy navigation.
Basic Commands
/help
Display all available bot commands with brief descriptions.
Usage: /help
Parameters: None
Response: Complete list of commands organized by category.
Example:
/helpX API Filtering Setup
X Bot's filtering system allows you to define exactly what X (Twitter) content to track and analyze. You can track specific accounts, monitor keywords and hashtags, follow cryptocurrency cashtags, see who's mentioning important accounts, and filter out noise with exclusions.
The filtering system is highly flexible and supports complex setups through named filters, which allow you to create multiple independent tracking configurations. This is particularly useful for KOL teams managing multiple clients, projects running different campaigns, or anyone who needs to separate different tracking scenarios. Each named filter can have its own set of accounts, keywords, cashtags, mentions, exclusions, and even independent report schedules.
Account Management
Track X (Twitter) accounts to monitor their posts and engagement metrics.
/add_accounts
Add one or more X accounts to track.
Usage: /add_accounts @account1 @account2 ... [filter=name]
Parameters:
@account1 @account2 ...: X (Twitter) handles to track (with @ symbol)filter=name(optional): Assign to a named filter
Admin Only: Yes
Examples:
What this does:
Tracks all posts from specified accounts
Monitors engagement metrics (likes, retweets, replies, quotes, bookmarks, impressions)
Includes accounts in leaderboard rankings
/remove_accounts
Remove one or more X accounts from tracking.
Usage: /remove_accounts @account1 @account2 ... [filter=name]
Parameters:
@account1 @account2 ...: X handles to stop trackingfilter=name(optional): Remove from a named filter
Admin Only: Yes
Examples:
/get_accounts
View all currently tracked X accounts.
Usage: /get_accounts [filter=name]
Parameters:
filter=name(optional): Show accounts for a specific named filter
Admin Only: No
Examples:
Response: List of all tracked X accounts, or accounts in the specified filter.
Keyword Management
Track specific keywords and hashtags to monitor community discussions.
/add_keywords
Add keywords or hashtags to track.
Usage: /add_keywords "keyword1" "keyword2" ... [filter=name]
Parameters:
"keyword1" "keyword2" ...: Keywords or hashtags to track (use quotes for multi-word phrases)filter=name(optional): Assign to a named filter
Admin Only: Yes
Examples:
Note: Use quotes for multi-word phrases. Hashtags should include the # symbol.
/remove_keywords
Remove keywords or hashtags from tracking.
Usage: /remove_keywords "keyword1" "keyword2" ... [filter=name]
Parameters:
"keyword1" "keyword2" ...: Keywords or hashtags to stop trackingfilter=name(optional): Remove from a named filter
Admin Only: Yes
Examples:
/get_keywords
View all currently tracked keywords and hashtags.
Usage: /get_keywords [filter=name]
Parameters:
filter=name(optional): Show keywords for a specific named filter
Admin Only: No
Examples:
Response: List of all tracked keywords and hashtags, or keywords in the specified filter.
Cashtag Management
Track cryptocurrency cashtags (e.g., $BTC, $ETH) to monitor token discussions.
/add_cashtags
Add cashtags to track.
Usage: /add_cashtags $TAG1 $TAG2 ... [filter=name]
Parameters:
$TAG1 $TAG2 ...: Cashtags to track (with $ symbol)filter=name(optional): Assign to a named filter
Admin Only: Yes
Examples:
Note: Cashtags must include the $ symbol.
/remove_cashtags
Remove cashtags from tracking.
Usage: /remove_cashtags $TAG1 $TAG2 ... [filter=name]
Parameters:
$TAG1 $TAG2 ...: Cashtags to stop trackingfilter=name(optional): Remove from a named filter
Admin Only: Yes
Examples:
/get_cashtags
View all currently tracked cashtags.
Usage: /get_cashtags [filter=name]
Parameters:
filter=name(optional): Show cashtags for a specific named filter
Admin Only: No
Examples:
Response: List of all tracked cashtags, or cashtags in the specified filter.
Mention Management
Track X account mentions to see who's talking about specific accounts.
/add_mentions
Add X accounts to track mentions of.
Usage: /add_mentions @account1 @account2 ... [filter=name]
Parameters:
@account1 @account2 ...: X handles to track mentions offilter=name(optional): Assign to a named filter
Admin Only: Yes
Examples:
What this does:
Tracks posts that mention the specified accounts
Shows who is talking about these accounts
Includes mention frequency in reports
/remove_mentions
Remove X accounts from mention tracking.
Usage: /remove_mentions @account1 @account2 ... [filter=name]
Parameters:
@account1 @account2 ...: X handles to stop tracking mentions offilter=name(optional): Remove from a named filter
Admin Only: Yes
Examples:
/get_mentions
View all accounts currently tracked for mentions.
Usage: /get_mentions [filter=name]
Parameters:
filter=name(optional): Show mentions for a specific named filter
Admin Only: No
Examples:
Response: List of all accounts being tracked for mentions, or mentions in the specified filter.
Exclusion Management
Exclude specific keywords or hashtags from reports to filter out noise.
/add_exclusions
Add keywords or hashtags to exclude from tracking.
Usage: /add_exclusions "keyword1" "keyword2" ... [filter=name]
Parameters:
"keyword1" "keyword2" ...: Keywords or hashtags to excludefilter=name(optional): Assign to a named filter
Admin Only: Yes
Examples:
What this does:
Excludes posts containing these keywords from reports
Helps filter out spam, scams, or irrelevant content
Improves report quality
/remove_exclusions
Remove keywords or hashtags from exclusion list.
Usage: /remove_exclusions "keyword1" "keyword2" ... [filter=name]
Parameters:
"keyword1" "keyword2" ...: Keywords or hashtags to stop excludingfilter=name(optional): Remove from a named filter
Admin Only: Yes
Examples:
/get_exclusions
View all currently excluded keywords and hashtags.
Usage: /get_exclusions [filter=name]
Parameters:
filter=name(optional): Show exclusions for a specific named filter
Admin Only: No
Examples:
Response: List of all excluded keywords and hashtags, or exclusions in the specified filter.
Ignore List Management
Ignore specific X accounts so they don't appear in leaderboards (useful for hiding bots, test accounts, or team admins).
/add_ignore_list
Add X accounts to the ignore list.
Usage: /add_ignore_list @account1 @account2 ...
Parameters:
@account1 @account2 ...: X handles to ignore in leaderboards
Admin Only: Yes
Examples:
What this does:
Hides specified accounts from leaderboard rankings
Posts are still tracked but not shown in public reports
Useful for internal/test accounts
/remove_ignore_list
Remove X accounts from the ignore list.
Usage: /remove_ignore_list @account1 @account2 ...
Parameters:
@account1 @account2 ...: X handles to stop ignoring
Admin Only: Yes
Examples:
/get_ignore_list
View all accounts currently on the ignore list.
Usage: /get_ignore_list
Parameters: None
Admin Only: No
Example:
Response: List of all ignored X accounts.
Named Filters
Named filters allow you to create multiple tracking configurations for different purposes (e.g., different clients, campaigns, or projects).
Understanding Named Filters
Named filters let you:
Track different sets of accounts/keywords for different purposes
Generate separate reports for different clients or campaigns
Keep configurations organized and separate
How to use named filters:
Create a named filter
Add items with the filter=name parameter, for example:
Generate reports for a named filter
Use the recreate command with the filter parameter:
View filter configuration
Inspect items in a filter:
Examples of Named Filter Usage
Example 1: Multiple Client Tracking (KOL Team)
Example 2: Different Campaign Tracking (Project)
Schedule Management
Automate report generation with scheduled daily reports.
/set_schedule
Schedule automated daily reports.
Usage: /set_schedule HH:MM [filter=name]
Parameters:
HH:MM: Time in 24-hour format (UTC timezone)filter=name(optional): Schedule for a specific named filter
Admin Only: Yes
Examples:
What this does:
Generates automated daily reports at the specified time
Posts performance screenshots and leaderboards to the group
Time is in UTC (Coordinated Universal Time)
Timezone Conversion Examples:
New York (EST): 12:00 UTC = 07:00 EST
London (GMT): 12:00 UTC = 12:00 GMT
Singapore (SGT): 12:00 UTC = 20:00 SGT
/get_schedule
View current report schedule.
Usage: /get_schedule [filter=name]
Parameters:
filter=name(optional): Show schedule for a specific named filter
Admin Only: No
Examples:
Response: Current scheduled report time in UTC, or message if no schedule is set.
/delete_schedule
Cancel automated daily reports.
Usage: /delete_schedule [filter=name]
Parameters:
filter=name(optional): Delete schedule for a specific named filter
Admin Only: Yes
Examples:
What this does:
Removes scheduled report generation
Reports can still be generated manually with
/recreate
Report Generation
Generate analytics reports manually.
/recreate
Generate a new analytics report immediately.
Usage: /recreate [filter=name]
Parameters:
filter=name(optional): Generate report for a specific named filter
Admin Only: Yes (for manual generation)
Examples:
What this does:
Creates performance report with current data
Generates leaderboards for accounts, hashtags, cashtags, and mentions
Posts performance screenshot to the group
Shows engagement metrics and rankings
Note: Report generation can take 1-2 minutes depending on data volume.
/report
Alternative command to generate analytics report.
Usage: /report [filter=name]
Parameters:
filter=name(optional): Generate report for a specific named filter
Admin Only: Yes
Examples:
Note: Functions identically to /recreate.
Customization
Customize report appearance and scoring to match your brand.
/set_points
Customize engagement point weights for performance scoring.
Usage: /set_points <likes> <retweets> <replies> <quotes> <bookmarks> <impressions>
Parameters:
<likes>: Point weight for likes (default: 1)<retweets>: Point weight for retweets (default: 2)<replies>: Point weight for replies (default: 1.5)<quotes>: Point weight for quote tweets (default: 3)<bookmarks>: Point weight for bookmarks (default: 2)<impressions>: Point weight for impressions (default: 0.001)
Admin Only: Yes
Examples:
What this does:
Customizes how performance scores are calculated
Higher weights give more importance to that engagement type
Affects leaderboard rankings
Default Formula:
/get_points
View current engagement point weights.
Usage: /get_points
Parameters: None
Admin Only: No
Example:
Response: Current point weights for all engagement types.
/set_colors
Customize colors used in performance reports.
Usage: /set_colors <likes> <retweets> <replies> <quotes> <bookmarks> <impressions>
Parameters:
<likes>: Hex color code for likes (default: #FF6B6B)<retweets>: Hex color code for retweets (default: #4ECDC4)<replies>: Hex color code for replies (default: #45B7D1)<quotes>: Hex color code for quotes (default: #FFA07A)<bookmarks>: Hex color code for bookmarks (default: #98D8C8)<impressions>: Hex color code for impressions (default: #F7DC6F)
Admin Only: Yes
Examples:
What this does:
Customizes visual appearance of reports
Applies to performance screenshots
Helps match your brand colors
Note: Colors must be valid hex codes (e.g., #FF6B6B).
/get_colors
View current color configuration.
Usage: /get_colors
Parameters: None
Admin Only: No
Example:
Response: Current hex color codes for all engagement types.
/set_top_title
Customize the title for the main leaderboard section.
Usage: /set_top_title "Custom Title" "#HexColor"
Parameters:
"Custom Title": Title text for main leaderboard section"#HexColor": Hex color code for the title
Admin Only: Yes
Examples:
What this does:
Replaces default "Top Accounts by Performance" title
Adds custom branding to reports
Title appears in performance screenshots
/set_best_title
Customize the title for the best tweet section.
Usage: /set_best_title "Custom Title" "#HexColor"
Parameters:
"Custom Title": Title text for best tweet section"#HexColor": Hex color code for the title
Admin Only: Yes
Examples:
/set_engagement_title
Customize the title for the engagement scoring section.
Usage: /set_engagement_title "Custom Title" "#HexColor"
Parameters:
"Custom Title": Title text for engagement scoring section"#HexColor": Hex color code for the title
Admin Only: Yes
Examples:
Project Settings
Configure project metadata to enhance your presence on xbot.ninja.
/set_project_name
Set your project or team name.
Usage: /set_project_name "Project Name"
Parameters:
"Project Name": Name of your project or team
Admin Only: Yes
Examples:
What this does:
Sets project name displayed on xbot.ninja
Appears in public leaderboards if you meet listing criteria
Helps projects and KOLs get discovered
/get_project_name
View current project name.
Usage: /get_project_name
Parameters: None
Admin Only: No
Example:
/set_project_description
Set your project or team description.
Usage: /set_project_description "Description text"
Parameters:
"Description text": Brief description of your project or team
Admin Only: Yes
Examples:
What this does:
Sets description shown on xbot.ninja
Helps users understand what your project/team does
Appears in featured projects list
/get_project_description
View current project description.
Usage: /get_project_description
Parameters: None
Admin Only: No
Example:
/set_project_logo
Set your project or team logo URL.
Usage: /set_project_logo "https://url-to-logo.png"
Parameters:
"https://url-to-logo.png": Direct URL to your logo image
Admin Only: Yes
Examples:
What this does:
Sets logo displayed on xbot.ninja
Provides visual branding for your project/team
Logo appears in featured projects showcase
Note: Logo should be square format (1:1 ratio) and accessible via HTTPS.
/get_project_logo
View current project logo URL.
Usage: /get_project_logo
Parameters: None
Admin Only: No
Example:
/set_project_long_description
Set detailed project or team description.
Usage: /set_project_long_description "Long description text"
Parameters:
"Long description text": Detailed description of your project or team
Admin Only: Yes
Examples:
What this does:
Sets extended description for project detail pages
Provides more context about your project/team
Helps users make informed decisions
/get_project_long_description
View current long project description.
Usage: /get_project_long_description
Parameters: None
Admin Only: No
Example:
/set_project_urls
Set project or team URLs (website, social media, etc.).
Usage: /set_project_urls "url1" "url2" "url3" ...
Parameters:
"url1" "url2" ...: URLs for website, social media, documentation, etc.
Admin Only: Yes
Examples:
What this does:
Sets links displayed on xbot.ninja
Provides ways for users to learn more about your project/team
Helps drive traffic to your platforms
/get_project_urls
View current project URLs.
Usage: /get_project_urls
Parameters: None
Admin Only: No
Example:
Getting Credits
X Bot includes 100 FREE credits to get you started. Each credit corresponds to one post tracked in your filtering setup (accounts, keywords, cashtags, and mentions you've configured). Once you've used your free credits, you can purchase additional credits to continue tracking.
/buy
Purchase X Bot Pro Edition credits using BWS tokens.
Usage: /buy
Parameters: None
Where: Works in both group chats and Direct Messages (DM) with the bot
🔒 PRIVACY RECOMMENDED: Use Direct Message (DM) for Private Purchases
For complete privacy, send /buy in a Direct Message to @BWS_X_Bot instead of in the group chat. This keeps the entire purchase conversation private - only you will see the purchase link and transaction details.
Examples:
Recommended: In Direct Message with bot (completely private)
In group chat (visible to everyone in the group)
What this does:
Provides secure purchase link for BWS token credit purchase
Redirects to purchase page at xbot.ninja
Credits are added to your group immediately after successful purchase
How to purchase privately in DM:
Open a Direct Message with the bot
Open a Direct Message with @BWS_X_Bot.
Send the buy command
Send /buy command in the DM (not in the group).
Receive private link
Bot sends you a private purchase link that only you can see.
Complete purchase
Complete your purchase privately - no one in the group will see any part of the transaction.
Credits applied
Credits are automatically added to your group upon successful payment.
/subscription
View your current Pro subscription status.
Usage: /subscription
Parameters: None
Admin Only: No
Example:
Response: Current subscription status, expiration date, and available credits.
/get_credits
View available Pro credits for your group.
Usage: /get_credits
Parameters: None
Admin Only: No
Example:
Response: Number of remaining Pro credits for report generation and other Pro features.
Command Tips & Best Practices
General Tips
Use Quotes for Multi-Word Terms: Always use quotes when adding keywords with spaces:
Include Symbols: Don't forget @ for accounts, # for hashtags, $ for cashtags:
Named Filters for Organization: Use named filters to keep different tracking scenarios organized:
Schedule in UTC: Remember that schedule times are in UTC timezone. Convert from your local time.
Performance Optimization
Start Small: Begin with a few accounts/keywords and expand based on results
Use Exclusions: Filter out spam and irrelevant content with exclusions
Regular Reports: Set daily schedules to track trends over time
Named Filters: Separate different campaigns or clients for clearer insights
Report Quality
Balanced Tracking: Track both accounts and keywords for comprehensive insights
Clean Data: Use ignore list to hide test accounts and bots
Custom Scoring: Adjust point weights to reflect what matters most to your community
Branding: Set custom titles and colors to match your brand
Privacy and Security
DM for Privacy: Use Direct Messages for sensitive commands like
/buyAdmin Commands: Only admins can configure tracking and settings
Public Reports: Anyone in the group can view reports and current configuration
Filter Isolation: Named filters keep different client/campaign data separate
Troubleshooting
No Data in Reports
Verify accounts/keywords are configured:
/get_accounts,/get_keywordsWait a few hours for X API to collect data
Ensure tracked accounts are public
Reports Not Generating
Check schedule is set:
/get_scheduleVerify time is in UTC
Manually test with
/recreate
Bot Not Responding
Verify bot has admin status in the group
Check if bot was removed or banned
Try removing and re-adding the bot
Advanced Usage
Multi-Client KOL Team Setup:
Comprehensive Project Tracking:
This command reference is for X Bot Beta Version. Commands and features are subject to change as the platform improves.
Last updated
Was this helpful?