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:

/help

X 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:

/add_accounts @elonmusk
/add_accounts @VitalikButerin @SatoshiLite @APompliano
/add_accounts @ProjectAccount filter=marketing_campaign

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 tracking
filter=name (optional): Remove from a named filter

Admin Only: Yes

Examples:

/remove_accounts @elonmusk
/remove_accounts @Account1 @Account2
/remove_accounts @ProjectAccount filter=marketing_campaign

/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:

/get_accounts
/get_accounts filter=marketing_campaign

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:

/add_keywords "Bitcoin" "#BTC" "cryptocurrency"
/add_keywords "DeFi" "#DeFi" "decentralized finance"
/add_keywords "Solana ecosystem" filter=solana_tracking

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 tracking
filter=name (optional): Remove from a named filter

Admin Only: Yes

Examples:

/remove_keywords "Bitcoin"
/remove_keywords "#OldCampaign" filter=marketing_campaign

/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:

/get_keywords
/get_keywords filter=marketing_campaign

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:

/add_cashtags $BTC $ETH $SOL
/add_cashtags $MYTOKEN filter=token_launch

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 tracking
filter=name (optional): Remove from a named filter

Admin Only: Yes

Examples:

/remove_cashtags $BTC
/remove_cashtags $OLDTOKEN filter=token_launch

/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:

/get_cashtags
/get_cashtags filter=token_launch

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 of
filter=name (optional): Assign to a named filter

Admin Only: Yes

Examples:

/add_mentions @YourProjectAccount
/add_mentions @Influencer1 @Influencer2 filter=kol_tracking

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 of
filter=name (optional): Remove from a named filter

Admin Only: Yes

Examples:

/remove_mentions @OldAccount
/remove_mentions @Influencer1 filter=kol_tracking

/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:

/get_mentions
/get_mentions filter=kol_tracking

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 exclude
filter=name (optional): Assign to a named filter

Admin Only: Yes

Examples:

/add_exclusions "spam" "giveaway scam"
/add_exclusions "#irrelevant" filter=marketing_campaign

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 excluding
filter=name (optional): Remove from a named filter

Admin Only: Yes

Examples:

/remove_exclusions "giveaway"
/remove_exclusions "#campaign" filter=marketing_campaign

/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:

/get_exclusions
/get_exclusions filter=marketing_campaign

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:

/add_ignore_list @TestAccount @BotAccount
/add_ignore_list @TeamAdmin @InternalAccount

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:

/remove_ignore_list @TestAccount

/get_ignore_list

View all accounts currently on the ignore list.

Usage: /get_ignore_list

Parameters: None

Admin Only: No

Example:

/get_ignore_list

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:

/add_accounts @Client1Account filter=client1
/add_keywords "client1 keyword" filter=client1

Generate reports for a named filter

Use the recreate command with the filter parameter:

/recreate filter=client1

View filter configuration

Inspect items in a filter:

/get_accounts filter=client1
/get_keywords filter=client1

Examples of Named Filter Usage

Example 1: Multiple Client Tracking (KOL Team)

# Client A Setup
/add_accounts @ClientA_Account filter=client_a
/add_cashtags $TOKENA filter=client_a

# Client B Setup
/add_accounts @ClientB_Account filter=client_b
/add_cashtags $TOKENB filter=client_b

# Generate separate reports
/recreate filter=client_a
/recreate filter=client_b

Example 2: Different Campaign Tracking (Project)

# Marketing Campaign
/add_keywords "#MarketingCampaign" "campaign hashtag" filter=marketing

# Community Competition
/add_accounts @CommunityAccount1 @CommunityAccount2 filter=competition

# Generate campaign-specific reports
/recreate filter=marketing
/recreate filter=competition

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:

/set_schedule 12:00
/set_schedule 09:00 filter=client_a
/set_schedule 18:30

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:

/get_schedule
/get_schedule filter=client_a

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:

/delete_schedule
/delete_schedule filter=client_a

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:

/recreate
/recreate filter=marketing_campaign

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:

/report
/report filter=client_a

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:

/set_points 1 2 1.5 3 2 0.001
/set_points 2 4 3 6 4 0.002
/set_points 1 1 1 1 1 0

What this does:

Customizes how performance scores are calculated
Higher weights give more importance to that engagement type
Affects leaderboard rankings

Default Formula:

Performance Score = (Likes × 1) + (Retweets × 2) + (Replies × 1.5) +
                   (Quotes × 3) + (Bookmarks × 2) + (Impressions × 0.001)

/get_points

View current engagement point weights.

Usage: /get_points

Parameters: None

Admin Only: No

Example:

/get_points

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:

/set_colors #FF6B6B #4ECDC4 #45B7D1 #FFA07A #98D8C8 #F7DC6F
/set_colors #FF0000 #00FF00 #0000FF #FFFF00 #FF00FF #00FFFF

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:

/get_colors

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:

/set_top_title "🏆 Top Community Champions" "#FFD700"
/set_top_title "Elite KOL Performance" "#4ECDC4"

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_best_title "⭐ Best Tweet of the Month" "#FFD700"
/set_best_title "Top Performing Post" "#4ECDC4"

/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:

/set_engagement_title "📊 Engagement Metrics" "#45B7D1"
/set_engagement_title "Performance Breakdown" "#FFA07A"

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:

/set_project_name "Solana Foundation"
/set_project_name "Alpha KOL Team"

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:

/get_project_name

/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:

/set_project_description "High-performance blockchain supporting builders around the world"
/set_project_description "Elite crypto KOL team specializing in DeFi and trading"

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:

/get_project_description

/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:

/set_project_logo "https://example.com/solana-logo.png"
/set_project_logo "https://cdn.example.com/team-logo.jpg"

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:

/get_project_logo

/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:

/set_project_long_description "Solana is a high-performance blockchain that supports builders around the world creating decentralized applications. Known for its speed and low transaction costs..."

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:

/get_project_long_description

/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:

/set_project_urls "https://solana.com" "https://twitter.com/solana" "https://discord.gg/solana"
/set_project_urls "https://kolteam.io" "https://twitter.com/alphakols"

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:

/get_project_urls

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)

/buy

In group chat (visible to everyone in the group)

/buy

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:

/subscription

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:

/get_credits

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:
```
/add_keywords "decentralized finance" "crypto trading"
```
Include Symbols: Don't forget @ for accounts, # for hashtags, $ for cashtags:
```
/add_accounts @VitalikButerin
/add_keywords "#Bitcoin"
/add_cashtags $ETH
```
Named Filters for Organization: Use named filters to keep different tracking scenarios organized:
```
/add_accounts @Client1 filter=client1
/recreate filter=client1
```
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 /buy
Admin 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_keywords
Wait a few hours for X API to collect data
Ensure tracked accounts are public

Reports Not Generating

Check schedule is set: /get_schedule
Verify 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:

# Client A
/add_accounts @KOL1 @KOL2 filter=client_a
/add_cashtags $TOKENA filter=client_a
/set_schedule 10:00 filter=client_a

# Client B
/add_accounts @KOL1 @KOL3 filter=client_b
/add_cashtags $TOKENB filter=client_b
/set_schedule 14:00 filter=client_b

# Generate separate reports
/recreate filter=client_a
/recreate filter=client_b

Comprehensive Project Tracking:

# Official accounts
/add_accounts @ProjectOfficial @ProjectFounder

# Community cashtags
/add_cashtags $PROJECTTOKEN

# Track mentions of key accounts
/add_mentions @ProjectOfficial @ProjectFounder

# Exclude spam
/add_exclusions "scam" "fake giveaway"

# Hide internal accounts
/add_ignore_list @ProjectTestAccount @InternalBot

# Schedule daily reports
/set_schedule 12:00

# Customize branding
/set_project_name "My Project"
/set_project_description "Revolutionary DeFi protocol"
/set_top_title "🏆 Top Community Contributors" "#FFD700"

This command reference is for X Bot Beta Version. Commands and features are subject to change as the platform improves.

PreviousHow To Install NextGetting Support

Was this helpful?