Bot Commands

The BlockchainAnalysis.io Telegram Bot (@AMLScreeningBot) supports the following commands for wallet screening, credit management, and configuration.

To get started with the bot, open Telegram and search for @AMLScreeningBot, or visit t.me/AMLScreeningBot. Send /start to begin.

`/start`

Initializes the bot and creates your account. If you already have an account, it confirms your existing session.

Example:

You: /start

Bot: Welcome to BlockchainAnalysis.io AML Screening Bot!

Your account has been created. You have 0 credits.

Use /screen <address> to screen a wallet address.
Use /buy to purchase screening credits.
Use /help for a full list of commands.

`/screen [address]`

Performs a standard screening of the specified wallet address. Returns a risk score, entity match (if any), and a basic counterparty summary. Costs 1 credit per screening.

Usage: /screen [wallet_address]

Example:

You: /screen 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Bot: Screening address...

--- Standard Screening Result ---

Address: 0xd8dA...96045
Chain: Ethereum
Entity: Vitalik Buterin (Public Figure)
Risk Score: 12 / 100 (LOW RISK)

Top Counterparties:
  - Uniswap V3 Router (32%)
  - Coinbase (18%)
  - Gitcoin Grants (11%)
  - Other DeFi (39%)

Sanctions Match: None
Credits Remaining: 14

Use /screen_advanced for a full detailed report.

For EVM-compatible addresses (used on Ethereum, BSC, Polygon, Arbitrum, etc.), the bot defaults to Ethereum. Use /chain to switch to a different EVM chain before screening.

`/screen_advanced [address]`

Performs an advanced screening of the specified wallet address. Returns a full report with transaction timeline, counterparty breakdown, risk factor analysis, and a downloadable PDF link. Costs 5 credits per screening.

Usage: /screen_advanced [wallet_address]

Example:

You: /screen_advanced 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Bot: Running advanced screening... This may take 15-30 seconds.

--- Advanced Screening Report ---

Address: 0xd8dA...96045
Chain: Ethereum
Entity: Vitalik Buterin (Public Figure)
Risk Score: 12 / 100 (LOW RISK)

Risk Factor Breakdown:
  Sanctions Exposure: 0/100
  Mixer Usage: 0/100
  Darknet Activity: 0/100
  Gambling: 0/100
  Scam Association: 0/100
  Stolen Funds: 0/100
  Terrorist Financing: 0/100
  High-Risk Jurisdiction: 5/100
  DeFi Risk: 15/100
  Bridge Risk: 10/100
  Entity Reputation: 0/100

Source of Funds:
  - Known Exchanges: 22%
  - DeFi Protocols: 45%
  - Mining/Staking: 8%
  - Direct Transfers: 20%
  - Unknown: 5%

Sanctions Check: CLEAR (no matches)
Mixer Exposure: None detected

PDF Report: https://app.blockchainanalysis.io/report/abc123

Credits Remaining: 10

For a detailed comparison of standard vs. advanced screening, see Standard vs Advanced.

`/credits`

Displays your current credit balance.

Example:

You: /credits

Bot: Your current balance: 15 credits

  - Standard screenings available: 15
  - Advanced screenings available: 3

Use /buy to purchase more credits.

`/buy`

Opens the credit purchase menu. Select a credit package and complete payment via Stripe directly within Telegram.

Example:

You: /buy

Bot: Select a credit package:

  1. 10 credits — $10
  2. 50 credits — $40 (20% off)
  3. 100 credits — $70 (30% off)
  4. 500 credits — $250 (50% off)

Tap a package to proceed to payment.

Payment is processed securely via Stripe. Credits are added to your account immediately upon successful payment. See Pricing for full pricing details.

`/chain [chain_name]`

Sets the active blockchain for subsequent screenings. This is primarily useful for EVM-compatible addresses, which share the same address format across multiple chains.

Usage: /chain [chain_name]

Supported chain names:

ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, fantom, cronos, gnosis, celo, moonbeam, zksync, linea, scroll, mantle, blast, bitcoin, litecoin, dogecoin, solana, near, tron, cosmos, xrp, stellar, sui, aptos, ton

Example:

You: /chain polygon

Bot: Active chain set to Polygon.
All subsequent EVM address screenings will use Polygon.

Use /chain ethereum to switch back.

Non-EVM addresses (Bitcoin, Solana, NEAR, Tron, etc.) are automatically detected by their address format. The /chain command is only needed when screening EVM-compatible addresses on a chain other than Ethereum.

`/settings`

Displays your current bot settings and allows you to update preferences.

Example:

You: /settings

Bot: Current Settings:

  Active Chain: Ethereum
  Default Screening: Standard
  Notifications: Enabled

Options:
  /chain <name> — Change active chain
  /settings notifications off — Disable notifications
  /settings notifications on — Enable notifications

`/help`

Displays a summary of all available commands.

Example:

You: /help

Bot: BlockchainAnalysis.io AML Screening Bot

Commands:
  /start — Initialize the bot
  /screen <address> — Standard screening (1 credit)
  /screen_advanced <address> — Advanced screening (5 credits)
  /credits — Check credit balance
  /buy — Purchase credits
  /chain <name> — Set active blockchain
  /settings — View/update settings
  /help — Show this help message

Documentation: https://docs.blockchainanalysis.io/telegram-bot
Support: support@blockchainanalysis.io

Error Handling

Common error responses from the bot:

| Error | Cause | Resolution | |---|---|---| | Insufficient credits | Your credit balance is too low for the requested screening type | Use /buy to purchase more credits | | Invalid address format | The address does not match any supported blockchain format | Check the address for typos | | Chain not supported | The specified chain name in /chain is not recognized | Use /help to see supported chain names | | Rate limited | Too many requests in a short period | Wait 60 seconds and try again | | Screening failed | Internal processing error | Try again. If persistent, contact support |

Next Steps

Standard vs Advanced — Detailed comparison of screening types.
Pricing — Credit packages and pricing.
Supported Chains — Full list of supported blockchains.