Skip to main content

BotForge Documentation

Complete documentation for FortiBlox BotForge

Version: 1.0.0|Last updated: Jan 2026

#Getting Started

Welcome to BotForge! This guide will help you create your first Telegram price bot for X1 blockchain tokens. Follow these steps to get started.

#Create Your First Bot

Creating a bot with BotForge is straightforward. Here is the process:

  1. Connect your wallet - Use a Solana-compatible wallet (Phantom, Solflare, or Backpack) with X1 blockchain support.
  2. Enter token address - Provide the mint address of the X1 token you want to track.
  3. Create bot with BotFather - Use Telegram is @BotFather to create a new bot and get your token.
  4. Configure price cards - Choose a template and customize how alerts will appear.
  5. Set up alerts - Define thresholds for buy/sell notifications.
  6. Pay and deploy - Complete payment ($50/month subscription) to activate your bot.
[*]
Your bot will be deployed within seconds of payment confirmation. You can manage it from the Dashboard at any time.

#Compatible Wallets

BotForge works with X1-compatible wallets. Use one of the following:

X1 Wallet (Recommended)

Official X1 blockchain wallet Chrome extension.

Install from Chrome Web Store

Backpack Wallet

Multi-chain wallet with X1 blockchain support.

Download Backpack

#Getting XNT

XNT is the native token of the X1 blockchain. Here is how to get it:

Option 1: Official Bridge

Bridge assets from other chains using the official X1 Bridge by the X1 team.

app.bridge.x1.xyz

Option 2: OTC Trading

Purchase XNT directly via the OTC platform.

otc.xonedex.xyz

Note: This is a community project, not officially affiliated with X1.

#Getting USDC.X

USDC.X is the stablecoin on X1 blockchain used for BotForge payments:

Option 1: Official Bridge

Bridge USDC from other chains to USDC.X on X1 blockchain.

app.bridge.x1.xyz

Option 2: DEX Swap

Swap XNT or other X1 tokens for USDC.X on xDEX.

xdex.xyz
[i]
Bot subscription is $50/month per bot. Pay with USDC.X (X1), USDC (Solana), or 100+ cryptocurrencies. Includes unlimited alerts and professional hosting.

#Bot Configuration

Configure your bot to track tokens and send customized alerts.

#Token Address Setup

Every bot tracks a single X1 blockchain token. Enter the mint address (44 characters):

$Example Token Address
5sN7WB75KLQHKNVkxX6wycRhc75C1NDACiKREiWepZ9n

BotForge will automatically fetch token metadata including:

  • Token name and symbol
  • Decimals
  • Supply information
  • Token image (from IPFS metadata)
[!]
Only Token-2022 standard tokens on X1 blockchain are supported. Legacy SPL tokens may have limited metadata support.

#BotFather Integration

Create your Telegram bot using @BotFather:

$BotFather Commands
1. Open Telegram and search for @BotFather
2. Send /newbot
3. Enter a name for your bot (e.g., "PEPE Price Bot")
4. Enter a username (must end in "bot", e.g., "pepe_price_bot")
5. Copy the API token provided

Bot Token Format

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890
[X]
Never share your bot token publicly. Anyone with the token can control your bot. BotForge stores tokens securely using encryption.

#Alert Templates

Choose from 5 distinct alert templates. Each template displays price information differently:

Minimal

Clean, essential info only. Best for high-volume tokens.

🟢 PEPE BUY
$150.00

Price: $0.00001234
24h: +5.25%
MCap: $1.2M | Liq: $85K

Detailed

Comprehensive data with all metrics. Best for data-driven communities.

🟢 BUY
Pepe (PEPE)

Transaction
Amount: 1,000,000 PEPE
Value: $150.00 (100.5 XNT)
Wallet: 7xKX...gAsU

Price Data
Current: $0.00001234
24h Change: +5.25%

Market
MCap: $1.2M | FDV: $12M
Vol: $45K | Liq: $85K

Meme

Fun, emoji-heavy style. Best for community/meme tokens.

🚀🟢💎 PEPE BUY! 🚀🟢💎

$150.00
1,000,000 PEPE

Price: $0.00001234
24h: +5.25% 📈
MCap: $1.2M | 💧 Liq: $85K

Professional

Formal business style, no emojis. Best for enterprise projects.

Transaction Alert: Purchase
Pepe (PEPE)

Transaction Summary
Type: PURCHASE
Amount: 1,000,000 PEPE
Value (USD): $150.00
Value (XNT): 100.5 XNT
Executed By: 7xKX...gAsU

Market Data
Current Price: $0.00001234
24H Change: +5.25%
Market Capitalization: $1.2M
Liquidity: $85K

Jan 28, 2026 14:30 UTC

Scanner

Security-focused with risk analysis. Best for safety-conscious communities.

🪙 Pepe $PEPE 🟢 BUY
────────────────────────────
Address: 81LkybSB...kYkDTJ

💵 Transaction
├ Amount: $150.00
├ Tokens: 1,000,000 PEPE
└ Wallet: 7xKX...gAsU

💰 Price Info
├ Price: $0.00001234
└ 24h: +5.25% 📈

📊 Market
├ MCap: $1.2M
└ Liq: $85K

🔒 Security
├ 🟢 Mintable: NO
├ 🟢 Freezable: NO
└ Risk: 🟢 SAFE 15/100

👥 Holders (1,234)
├ Top Holder: 5.2%
└ Top 10: 18.5%

🔗 Explorer · xDEX · Chart
[*]
You can change your bot is template anytime from the Dashboard. Changes take effect immediately for all future alerts.

#Alert Settings

Fine-tune which transactions trigger alerts:

SettingDescriptionDefault
minBuyAmountMinimum USD value for buy alerts$0 (all buys)
minSellAmountMinimum USD value for sell alerts$0 (all sells)
whaleThresholdUSD threshold for whale alerts$10,000
cooldownSecondsMinimum time between alerts5 seconds
[*]
Set higher thresholds for high-volume tokens to avoid alert spam. Use the cooldown setting to batch rapid transactions.

#Bot Commands

Your bot responds to these commands in Telegram chats:

#/start

/startAny user

Initialize the bot in a chat and begin receiving price alerts. The bot will register this chat for notifications.

Usage: /start
Example: Bot responds with welcome message and starts sending alerts

#/price

/priceAny user

Get the current price and market data for the tracked token.

Usage: /price
Example: Returns: $PEPE: $0.00001234 | MCap: $1.2M | 24h: +15.5%

#/ca

/caAny user

Display the contract address (token mint address) for easy copying.

Usage: /ca
Example: Returns: 5sN7WB75KLQHKNVkxX6wycRhc75C1NDACiKREiWepZ9n

#/info

/infoAny user

Show detailed token information including supply, authorities, and metadata.

Usage: /info
Example: Returns full token details with links

#/stats

/statsAny user

Display bot statistics including alerts sent, active chats, and uptime.

Usage: /stats
Example: Returns: Alerts: 1,234 | Chats: 5 | Uptime: 7d 12h

#/mute and /unmute

/muteAdmin only

Temporarily stop price alerts in the current chat. Use /unmute to resume.

Usage: /mute or /unmute
Example: /mute - Bot stops sending alerts; /unmute - Alerts resume

#/settings

/settingsAdmin only

View and modify bot settings for this chat (thresholds, display options).

Usage: /settings [option] [value]
Example: /settings minBuy 100 - Set minimum buy alert to $100

#/help

/helpAny user

Display all available commands and their usage.

Usage: /help
Example: Returns list of all commands with descriptions

#Frequently Asked Questions

Q:How much does it cost to create a bot?
A:Bot subscription is $50/month per bot. This includes unlimited alerts, professional hosting, and all updates. Pay with USDC.X (X1), USDC (Solana), or 100+ cryptocurrencies.
Q:Can I track multiple tokens with one bot?
A:No, each bot tracks a single token. This ensures optimal performance and allows customization specific to each token. Create multiple bots for multiple tokens.
Q:How quickly do alerts arrive?
A:Alerts are sent within 1-3 seconds of transaction confirmation on X1 blockchain. The Price Engine monitors transactions in real-time via WebSocket subscriptions.
Q:Can I add my bot to multiple Telegram groups?
A:Yes! Your bot can be added to unlimited groups. Each group will receive alerts independently and can have its own mute settings.
Q:What happens if the bot goes offline?
A:BotForge uses Docker containers with automatic restart policies. If a bot crashes, it will restart automatically within seconds. Historical alerts during downtime are not re-sent.
Q:Can I customize alert messages?
A:Yes, through price card templates. You can choose what information to display, add custom emojis, and include a custom footer message.
Q:How do I update my bot token?
A:From the Dashboard, select your bot and go to Settings. You can update the Telegram bot token there. The bot will restart with the new token.
Q:Is there an API rate limit?
A:The Price Engine allows up to 100 requests per minute per IP. WebSocket connections have no rate limit. Bot containers have internal cooldowns for alerts.
Q:Can I get a refund?
A:Refunds are available within 24 hours if your bot has not been successfully deployed. Contact support with your wallet address and bot ID.
Q:How do I report a bug or request a feature?
A:Visit our GitHub repository or contact the FortiBlox team on Telegram. We actively maintain and improve BotForge based on community feedback.