Getting Started with the Telegram Bot

BlockchainAnalysis.io provides @BA_ScreenBot, a Telegram bot that lets you screen blockchain addresses, check risk scores, and generate compliance reports — all without leaving Telegram.

The bot is available 24/7 and supports all 52 blockchains covered by BlockchainAnalysis.io.

Finding the Bot

You can find the bot in three ways:

Direct link — Open t.me/BA_ScreenBot in your browser or Telegram app.
Telegram search — Open Telegram, tap the search icon, and type @BA_ScreenBot. Select the bot with the verified BlockchainAnalysis.io logo.
QR code — Scan the QR code available on the BlockchainAnalysis.io dashboard under Integrations > Telegram Bot.

Always verify you are interacting with @BA_ScreenBot (exact username). Beware of impersonator bots with similar names.

First Launch

Open the bot and press Start

Tap the Start button or send /start. The bot will greet you and display a brief overview of available commands.

Review the command menu

After /start, the bot shows:

| Command | Description | |-------------|--------------------------------------------------| | /check | Standard check — quick risk score + entity match | | /advanced | Advanced check — full 12-section compliance report | | /buy | Purchase credits or upgrade your plan | | /status | View your remaining credits and account info | | /help | Show help message with all available commands |

Run your first check

Send /check followed by any blockchain address:

/check 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18

The bot will respond with a quick risk score and entity identification (if the address is in the 49M+ labeled database).

Commands Overview

`/check` — Standard Check

The standard check is the fastest way to screen an address. It returns:

Risk Score — A 0–100 numeric score (0 = no risk, 100 = critical risk).
Entity Match — If the address belongs to a known entity (exchange, protocol, mixer, etc.), the bot displays the entity name and category.
Threat Level — A human-readable label: none, low, medium, high, or critical.

Usage:

/check <address>

The bot automatically detects which blockchain the address belongs to based on its format (e.g., 0x... for EVM chains, bc1... for Bitcoin, etc.).

For EVM-compatible addresses (which share the same 0x format across Ethereum, BNB Chain, Polygon, Arbitrum, etc.), the bot will display an inline keyboard so you can select the specific chain you want to check.

`/advanced` — Advanced Check

The advanced check generates a comprehensive 12-section compliance report, identical to what you get on the web dashboard. It includes:

Executive Summary
Risk Score Breakdown
Entity Identification
Direct Exposure Analysis
Indirect Exposure (Counterparty) Analysis
Transaction Pattern Analysis
Sanctions & Watchlist Screening
Source of Funds Summary
Destination of Funds Summary
DeFi Protocol Interactions
Cross-Chain Activity
Compliance Recommendation

Usage:

/advanced <address>

Advanced checks consume more credits than standard checks. Use /status to view your remaining balance before running an advanced check.

`/buy` — Purchase Credits

Opens an inline menu where you can purchase additional screening credits or upgrade your subscription plan. Payment is handled securely through Telegram's built-in payment system or via redirect to the BlockchainAnalysis.io billing page.

`/status` — Account Status

Displays your current account information:

Remaining standard check credits
Remaining advanced check credits
Current subscription plan
Account expiration date (if applicable)
Linked BlockchainAnalysis.io account email (if connected)

`/help` — Help

Shows a summary of all available commands with brief descriptions and usage examples.

Standard vs Advanced Mode

| Feature | Standard (/check) | Advanced (/advanced) | |-----------------------------|-----------------------|--------------------------| | Risk Score (0–100) | Yes | Yes | | Entity Match | Yes | Yes | | Threat Level | Yes | Yes | | Full 12-Section Report | No | Yes | | Direct Exposure Analysis | No | Yes | | Indirect Exposure Analysis | No | Yes | | Transaction Patterns | No | Yes | | Sanctions Screening Detail | No | Yes | | Source/Destination of Funds | No | Yes | | DeFi Interactions | No | Yes | | Cross-Chain Activity | No | Yes | | Compliance Recommendation | No | Yes | | Credit Cost | 1 standard credit | 1 advanced credit | | Response Time | ~2–5 seconds | ~10–30 seconds |

Choose Standard for quick, high-volume screening (e.g., checking counterparty addresses during onboarding). Choose Advanced when you need a full audit trail or regulatory-grade report.

Linking Your BlockchainAnalysis.io Account

If you have a BlockchainAnalysis.io web account, you can link it to the Telegram bot to:

Sync credits — Use the same credit balance across web and Telegram.
Access history — View all bot-generated reports on your web dashboard.
Manage billing — Upgrade plans and purchase credits from a single account.

Open the bot and send `/start`

If you have not already done so, start a conversation with @BA_ScreenBot.

Log in to BlockchainAnalysis.io

Go to your web dashboard at app.blockchainanalysis.io and navigate to Settings > Integrations > Telegram.

Copy your linking code

The dashboard will display a one-time linking code. Copy it.

Send the code to the bot

Paste the linking code into the bot chat. The bot will confirm the link and display your synced account details.

You can unlink your account at any time from the web dashboard under Settings > Integrations > Telegram > Unlink.

Chain Detection

The bot automatically identifies the blockchain from the address format:

| Address Format | Detected Chain(s) | |-----------------------------|-------------------------------------------------| | 0x + 40 hex characters | EVM (choose chain via inline keyboard) | | bc1... or 1... or 3...| Bitcoin | | T... (34 characters) | Tron | | r... (25–35 characters) | XRP Ledger | | cosmos1... | Cosmos | | bnb1... | BNB Beacon Chain | | Base58 (32–44 characters) | Solana | | .near or 64 hex chars | NEAR Protocol |

For the complete list of supported chains and address formats, see Supported Chains.

Tips and Best Practices

Batch screening — You can send multiple /check commands in quick succession. The bot processes them in order.
Copy-paste addresses — Always copy-paste addresses rather than typing them manually to avoid errors.
Save reports — Advanced reports can be forwarded to other Telegram chats or saved using Telegram's "Saved Messages" feature.
Rate limits — Free-tier accounts have a rate limit of 10 checks per minute. Upgrade your plan for higher throughput.
Privacy — All queries are encrypted in transit. BlockchainAnalysis.io does not store your Telegram chat history — only the screening results linked to your account.

Next Steps

Bot Commands — Detailed reference for every bot command.
Standard vs Advanced — In-depth comparison to help you choose the right mode.
Pricing — Credit costs and subscription plans.
Supported Chains — Full list of 38 supported blockchains.