BurnByte - Telegram Bot Documentation

Introduction to BurnByte

BurnByte is a sophisticated Telegram bot designed to monitor and track token burn events across the Binance Smart Chain (BSC) network in real-time.

The concept of "token burning" refers to the permanent removal of tokens from circulation by sending them to a special "burn address" - effectively reducing the total supply and potentially impacting the token's market value. These burn events can be strategic moves by project teams or part of tokenomic mechanisms designed to create deflationary pressure.

BurnByte empowers traders, investors, and crypto enthusiasts with instant notifications when significant burn events occur, providing valuable market insights and potential trading opportunities. With support for both personal chats and group notifications, BurnByte serves as your vigilant sentinel in the crypto market.

BurnByte's real-time notification system in action

Why Use BurnByte?

Real-Time Alerts

Receive instant notifications the moment tokens are burned, giving you a time advantage over other market participants.

Market Insights

Gain valuable insights into tokenomics and potential price movements based on supply reductions through burns.

Personalized Tracking

Customize your tracking list with the tokens that matter most to you, filtering out the noise of the broader market.

Quick Start Guide

Get up and running with BurnByte in just a few simple steps:

Step 1

Open Telegram and search for @BurnByteBot or click 
https://t.me/BurnByteBot

Step 2

Start the bot by clicking the "Start" button 
or sending the /start command

Step 3

Add tokens to track using one of these methods:
- Click "Add Token" in the main menu
- Use the /addtoken command followed by a contract address
- Simply paste a token contract address in the chat

Step 4

That's it! You'll now receive instant notifications
when your tracked tokens experience burn events

Pro Tip

For the best experience, start by tracking popular tokens like D.O.G.E (0x0632365f723cdb003f125a94254a4d9dccd25051) to see how the notification system works before adding your own custom tokens.

Ready to Start Tracking Burns?

Join thousands of crypto enthusiasts who rely on BurnByte for real-time token burn intelligence.

Launch Bot Join Announcements Channel

Key Features

BurnByte offers a comprehensive suite of features designed to provide you with the most powerful token burn tracking experience on the Binance Smart Chain:

Real-Time Burn Detection

Advanced blockchain monitoring system that detects token burns instantly as they occur on the BSC network.

Instant Notifications

Receive detailed alerts with burn amount, USD value, transaction details, and token information within seconds.

Group Integration

Add BurnByte to your Telegram groups to share burn notifications with your community or trading team.

Multi-Token Tracking

Monitor up to 20 different tokens simultaneously with smart prioritization for high-volume tokens.

Token Analytics

View detailed token statistics including burn history, total burned, and supply impact metrics.

Multi-Language Support

BurnByte speaks your language with support for English, Chinese, Russian, Spanish, and more.

Web Dashboard Integration

Seamless connection between Telegram bot and BurnByte's web interface for enhanced analytics.

High-Reliability Infrastructure

Enterprise-grade infrastructure with failover systems ensures you never miss a significant burn event.

Trending Tokens

Discover popular tokens being tracked by the community to stay on top of market trends.

Bot Commands

BurnByte offers a comprehensive set of commands to help you manage your token tracking and customize your experience. Here's a complete reference:

Core Commands

Command	Description	Example
/start	Initialize the bot and display the welcome message with the main menu	`/start`
/help	Display a comprehensive help guide with available commands and features	`/help`
/addtoken	Add a token to your tracking list by providing its contract address	`/addtoken 0x0632365f723cdb003f125a94254a4d9dccd25051`
/removetoken	Remove a token from your tracking list	`/removetoken` (displays selection menu)
/listtokens	List all tokens you're currently tracking with detailed metrics	`/listtokens`
/language	Change the bot's language to your preferred option	`/language` (displays language options)
/setup	Set up the bot in a Telegram group for community burn notifications	`/setup`
/link	Link your Telegram account with the BurnByte web dashboard	`/link ABC123` (where ABC123 is your linking code)

Command Aliases

For convenience, BurnByte supports shorter aliases for frequently used commands:

/add → /addtoken

/list → /listtokens

/remove → /removetoken

Admin Commands

These commands are available only to bot administrators for management purposes:

Command	Description
/admin	Access the admin dashboard with all administrative functions
/botcontrol	Start, stop, or restart the bot service
/stats	View bot usage statistics and metrics
/broadcast	Send a broadcast message to all bot users
/setpolling	Adjust the blockchain polling interval for optimized performance

Pro Tip

You can directly paste a BSC token contract address (starting with 0x) into the chat, and BurnByte will recognize it as a token tracking request without needing to use the /addtoken command.

Tracking Tokens

The core functionality of BurnByte revolves around tracking specific tokens for burn events. Here's how to manage your token tracking effectively:

Adding Tokens to Track

There are multiple ways to add tokens to your tracking list:

Using Commands

Send the /addtoken command followed by a valid BSC token contract address.

/addtoken 0x0632365f723cdb003f125a94254a4d9dccd25051

Direct Input

Simply paste any valid BSC token contract address into the chat, and BurnByte will recognize and process it.

0x0632365f723cdb003f125a94254a4d9dccd25051

Popular Tokens Menu

Access the "Popular Tokens" menu from the main interface to select from pre-configured popular tokens.

Trending Tokens

Browse the "Trending Tokens" section to discover what other users are actively tracking.

Managing Your Tracking List

BurnByte allows you to track up to 20 tokens simultaneously. To manage your tracking list effectively:

View your tracked tokens by sending the /listtokens command, which displays all tokens you're currently tracking along with key metrics and interactive management buttons.
Remove tokens by using the /removetoken command or by clicking the "Remove" button next to a token in your list view.
View detailed token information by clicking on a token name in your list to see comprehensive statistics.
Prioritize tokens - BurnByte automatically prioritizes your tokens based on user count and activity, ensuring optimal performance.

Important Note

BurnByte can only track valid BEP-20 tokens on the Binance Smart Chain. Tokens on other networks (Ethereum, Solana, etc.) are not supported. Always verify you're using the correct BSC contract address.

Burn Notifications

BurnByte's notification system is designed to deliver comprehensive, real-time alerts when burn events occur for your tracked tokens. Here's what you need to know about the notification system:

Notification Format

BurnByte Bot

12:34 PM

🔥 BURN ALERT

Token: D.O.G.E (DOGE)

Amount Burned: 1,000,000 DOGE ($2,500)

Burn Address: 0x000...000dead

Timestamp: April 19, 2025 12:34 PM

Transaction: 0x7a6b...f234

Notification Elements

Each burn notification includes the following information:

Token Details: Name, symbol, and contract address of the burned token
Burn Amount: Quantity of tokens burned and USD equivalent value (when available)
Burn Address: The destination address where tokens were sent (typically a dead address)
Transaction Details: Transaction hash, block number, and timestamp
Action Button: Direct link to view the transaction on BSCScan for verification

Notification Thresholds

To prevent notification fatigue, BurnByte implements intelligent filtering based on burn significance:

Burn Category	Threshold	Notification Behavior
Micro Burns	< $10 equivalent	Aggregated into hourly summaries
Small Burns	$10 - $1,000 equivalent	Individual notifications for all users
Significant Burns	$1,000 - $10,000 equivalent	Priority notifications with additional details
Major Burns	> $10,000 equivalent	Instant high-priority alerts with full analytics

Pro Tip

You can customize notification thresholds in your user preferences to only receive alerts for burns above a certain value or percentage of total supply.

Group Integration

BurnByte can be added to Telegram groups to share burn notifications with your community or trading team. This feature is perfect for crypto communities, trading groups, and project teams who want to keep members informed about token burns.

Adding BurnByte to a Group

There are two ways to integrate BurnByte into your Telegram group:

Method 1: Direct Addition

Open your Telegram group
Click the group name at the top
Select "Add members"
Search for @BurnByteBot and add it
The bot will automatically introduce itself

Method 2: Setup Command

Start a private chat with @BurnByteBot
Send the /setup command
Click "Add to Group" button
Select your group from the list
Configure group-specific settings

Group Configuration

Once BurnByte is added to your group, you can configure various settings:

Token Selection: Choose which tokens to track specifically for this group
Notification Threshold: Set minimum burn value/size to trigger group notifications
Notification Format: Configure compact or detailed notification style
Admin Controls: Determine which group members can manage BurnByte settings

Important Requirements

For BurnByte to function properly in a group, it needs these permissions:

Send Messages
Send Media
Send Stickers & GIFs
Add Web Page Previews

Without these permissions, the bot may not be able to deliver notifications properly.

Group Management Commands

The following commands can be used within groups to manage BurnByte:

Command	Description
/addtoken	Add a token to the group's tracking list
/removetoken	Remove a token from the group's tracking list
/listtokens	List all tokens the group is tracking
/groupsettings	Configure notification preferences for the group

Pro Tip

For token projects, adding BurnByte to your official Telegram group allows your community to stay informed about burn events automatically, increasing transparency and engagement.

User Preferences

BurnByte offers various customization options to tailor the bot's behavior to your specific needs:

Language Settings

BurnByte supports multiple languages to make the bot accessible to users worldwide:

🇺🇸 English

🇨🇳 Chinese

🇷🇺 Russian

🇪🇸 Spanish

🇰🇷 Korean

🇯🇵 Japanese

🇮🇩 Indonesian

🇹🇷 Turkish

To change your language, use the /language command or click the "Change Language" button in the help menu.

Notification Preferences

Customize how and when you receive burn notifications:

Setting	Options	Description
Notification Style	Detailed / Compact	Choose between comprehensive or concise notification formats
Value Threshold	Custom USD value	Only notify for burns above a certain USD value
Percentage Threshold	Custom % of supply	Only notify for burns exceeding a percentage of total supply
Quiet Hours	Time range	Silence notifications during specific hours (uses your local timezone)
Daily Digests	On / Off	Receive daily summaries of all burn activity

Access these settings by clicking "Notification Settings" in the help menu or by using the /settings command.

Web Integration

Link your Telegram account with the BurnByte web dashboard for enhanced analytics and control:

Visit the BurnByte website at https://burnbyte.dogeonbsc.net
Go to the "Link Account" page from the main navigation
Generate a unique linking code on the website
Send the code to BurnByte using the /link CODE command in Telegram
Confirm successful linking - you'll receive confirmation messages both in Telegram and on the website

Pro Tip

Linking your account allows you to manage your tracked tokens from both the web interface and Telegram bot, with changes synchronized automatically between platforms.

Bot Architecture

BurnByte is built on a sophisticated, multi-layered architecture designed for reliability, scalability, and real-time performance:

System Components

Telegram Bot Interface

Python-based Telegram bot client built on python-telegram-bot v20+ with enhanced async capabilities.

Blockchain Listener

Advanced real-time event listener using WebSocket and HTTP fallback for redundancy.

Data Management

High-performance SQLite database with optimized queries and redundant storage.

Web Interface

Flask-based dashboard providing analytics, user management, and token tracking.

Technical Stack

Backend: Python 3.11+ with asyncio for non-blocking operations
Blockchain Interface: Web3.py with custom enhancement for BSC-specific optimizations
Telegram API: python-telegram-bot v20 with custom reliability enhancements
Data Storage: SQLAlchemy ORM with SQLite for local data persistence
Web Framework: Flask with Gunicorn for WSGI application serving
HTTP Client: HTTPX with enhanced timeout and retry capabilities
WebSocket: websockets and asyncio for real-time event subscriptions

Performance Optimizations

BurnByte implements several advanced techniques to ensure optimal performance:

Connection Pooling

Maintains persistent connections to blockchain nodes with intelligent failover mechanisms.

Multi-RPC Strategy

Dynamically routes requests across multiple RPC providers to avoid rate limiting.

Smart Caching

Implements intelligent caching of token metadata and transaction data for faster response times.

Batch Processing

Groups blockchain operations into optimized batches to reduce API calls.

Health Monitoring

Continuous self-diagnostics with predictive recovery for network disruptions.

WebSocket Priority

Prioritizes WebSocket connections with HTTP polling as a redundant fallback method.

Blockchain Integration

BurnByte integrates deeply with the Binance Smart Chain to provide accurate, real-time token burn detection:

Burn Detection Methodology

BurnByte employs a multi-layered approach to detect and verify token burns:

Transfer Event Monitoring
Listens for BEP-20 Transfer events across all tracked tokens using WebSocket subscriptions.
Burn Address Verification
Identifies transfers to known burn addresses, including:
- 0x000000000000000000000000000000000000dEaD
- 0x0000000000000000000000000000000000000000
- 0x0000000000000000000000000000000000000001
- Custom project-specific burn addresses
Transaction Validation
Retrieves and validates full transaction details to confirm legitimacy and extract additional metadata.
Token Metadata Enrichment
Augments burn data with token details including name, symbol, decimals, and total supply.
Value Calculation
Determines USD value of burned tokens using real-time price data from PancakeSwap and other DEXes.

RPC Connection Strategy

BurnByte maintains high reliability through a sophisticated connection management system:

Configuration

# Primary RPC endpoint with Alchemy
BSC_RPC_URL = "https://bnb-mainnet.g.alchemy.com/v2/API_KEY"

# Fallback endpoints
FALLBACK_RPC_URLS = [
    "https://bsc-dataseed1.binance.org/",
    "https://bsc-dataseed2.binance.org/",
    "https://bsc-dataseed3.binance.org/",
    "https://bsc-dataseed4.binance.org/",
    "https://bsc.publicnode.com",
    "https://binance.llamarpc.com"
]

# WebSocket endpoints
BSC_WEBSOCKET_URL = "wss://bnb-mainnet.g.alchemy.com/v2/API_KEY"
FALLBACK_WS_URLS = [
    "wss://bsc.publicnode.com",
    "wss://bsc-mainnet.publicnode.com"
]

Token Contract Interaction

BurnByte interacts with token smart contracts to retrieve essential information:

Contract Method	Description	Usage
`name()`	Get token name	Token identification in notifications
`symbol()`	Get token symbol	Short identifier in notifications
`decimals()`	Get token decimal places	Proper formatting of token amounts
`totalSupply()`	Get current total token supply	Supply impact analysis for burns
`balanceOf(address)`	Get token balance for an address	Verification of burn address balances

Web Integration

BurnByte offers seamless integration with its companion web dashboard at burnbyte.dogeonbsc.net, providing enhanced analytics and management capabilities:

Account Linking

Connect your Telegram and web accounts for a unified experience:

Link Your Accounts

Visit the "Link Account" page on the BurnByte website
Generate a unique linking code
Send code to the bot with /link YOUR_CODE
Receive confirmation of successful linking

Synchronization Benefits

Manage tokens from either platform
Access enhanced analytics on web dashboard
View historical burn data and trends
Customize notification settings
Export data for personal analysis

Web Dashboard Features

The BurnByte web dashboard complements the Telegram bot with additional capabilities:

Advanced Analytics

Visualize burn trends, supply impact, and historical data with interactive charts.

Burn History

Access comprehensive historical burn data beyond what's available in Telegram.

Token Management

Add, remove, and organize your tracked tokens with enhanced sorting and filtering.

Detailed Settings

Fine-tune notification preferences with more granular control than the bot interface.

Data Export

Export burn data to CSV or JSON formats for further analysis or record-keeping.

Mobile Optimized

Responsive design provides a seamless experience across desktop and mobile devices.

API Documentation

BurnByte provides a RESTful API that allows developers to access burn data and integrate with their own applications:

Authentication

API access requires authentication using your linked Telegram account:

Authentication Headers

Authorization: Bearer YOUR_API_KEY

To obtain your API key, link your Telegram account with the web dashboard and visit the API section in your account settings.

Available Endpoints

Endpoint	Method	Description
`/api/v1/burns`	GET	Get recent burn events with optional filtering
`/api/v1/burns/{tx_hash}`	GET	Get detailed information about a specific burn event
`/api/v1/tokens`	GET	List all tokens being tracked by your account
`/api/v1/tokens/{address}`	GET	Get detailed information about a specific token
`/api/v1/tokens`	POST	Add a new token to your tracking list
`/api/v1/tokens/{address}`	DELETE	Remove a token from your tracking list
`/api/v1/stats`	GET	Get statistics about burn activity and tracked tokens

Example Request: Get Recent Burns

cURL Request

curl -X GET "https://burnbyte.dogeonbsc.net/api/v1/burns?token=0x0632365f723cdb003f125a94254a4d9dccd25051&limit=5" \
     -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": {
    "burns": [
      {
        "tx_hash": "0x7a6b...f234",
        "token_address": "0x0632365f723cdb003f125a94254a4d9dccd25051",
        "token_name": "Dept. of Government Efficiency",
        "token_symbol": "D.O.G.E",
        "amount": "1000000000000000000000000",
        "amount_formatted": "1,000,000",
        "burn_address": "0x000000000000000000000000000000000000dead",
        "usd_value": 2500.00,
        "block_number": 25876543,
        "timestamp": 1682112000,
        "timestamp_formatted": "2023-04-21T15:20:00Z"
      },
      // ... more burns
    ],
    "total": 137,
    "page": 1,
    "limit": 5
  }
}

Rate Limits

To ensure fair usage and system stability, the API enforces the following rate limits:

Tier	Rate Limit	Burst Limit
Standard (Free)	60 requests/hour	10 requests/minute
Enhanced	300 requests/hour	30 requests/minute
Premium	1,000 requests/hour	100 requests/minute

Rate limit headers are included in API responses to help you monitor your usage:

Rate Limit Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1682112300

For Developers

For more detailed API documentation including all parameters, response schemas, and integration examples, visit the API Documentation Portal.

Frequently Asked Questions

Find answers to common questions about BurnByte:

What exactly is a token burn?

A token burn is the process of permanently removing tokens from circulation by sending them to a specialized "burn address" that can receive tokens but never spend them. This effectively reduces the total supply of a token, which can potentially impact its value. Burns are often used in tokenomics as a deflationary mechanism or to create scarcity.

Does BurnByte work with all cryptocurrencies?

BurnByte specifically monitors BEP-20 tokens on the Binance Smart Chain (BSC). It does not currently support other blockchains like Ethereum, Solana, or Polygon. While many popular tokens exist on BSC, tokens on other networks aren't trackable through BurnByte at this time.

How many tokens can I track at once?

Standard users can track up to 20 different tokens simultaneously. This limit ensures optimal performance and notification delivery for all users. If you need to track more tokens, you can rotate your tracked tokens as needed using the /removetoken and /addtoken commands.

How quickly will I be notified of burns?

BurnByte detects burns in real-time using WebSocket connections to the blockchain. For significant burns (valued at $1,000+), notifications are typically delivered within 3-10 seconds of the burn transaction being confirmed on the blockchain. Smaller burns might be aggregated or delivered with a slight delay to optimize system performance.

Is BurnByte free to use?

Yes, BurnByte's core functionality is completely free for individual users and communities. The bot is supported by the D.O.G.E community and relies on optional features like trending token spots for sustainability. There are no fees or subscriptions required to use the basic or advanced features.

How do I add the bot to my Telegram group?

To add BurnByte to your Telegram group, you can either add it directly as a member from your group settings, or use the /setup command in a private chat with the bot. After adding it to your group, you'll need to configure which tokens the group should track. Only group admins can manage the bot's settings within the group.

Can I receive notifications for specific burn sizes only?

Yes, you can customize notification thresholds in your preferences. You can set minimum burn values (e.g., only notify for burns worth $100+) or minimum percentages of total supply (e.g., only notify for burns affecting more than 0.1% of supply). This helps focus on significant burns while filtering out smaller, less impactful events.

How does BurnByte determine the USD value of burns?

BurnByte calculates USD values by querying current token prices from PancakeSwap and other major DEXes on BSC. For tokens with sufficient liquidity, this provides accurate real-time valuations. For newer or less liquid tokens, the system uses best-effort estimates based on available trading pairs, or may indicate that a reliable USD value couldn't be determined.

What happens if I track a token that isn't a valid BEP-20 token?

BurnByte verifies token contracts before adding them to your tracking list. If you attempt to track an invalid address or a contract that doesn't implement the standard BEP-20 interface, the bot will notify you that the token couldn't be verified and won't add it to your tracking list.

How can I link my Telegram account with the web dashboard?

Visit the "Link Account" page on the BurnByte website. The page will generate a unique linking code for you. Send this code to the BurnByte bot using the /link command (e.g., /link ABC123). Once linked, your tracked tokens and preferences will be synchronized between both platforms.