Quick Start

This guide walks you through creating your BlockchainAnalysis.io account, running your first wallet screening, reading the report, and understanding the risk score. You will be up and running in under 5 minutes.

Step 1: Create Your Account

1. Navigate to app.blockchainanalysis.io/signup.
2. Enter your business email address and create a password (minimum 12 characters, must include uppercase, lowercase, number, and special character).
3. Select your organization type:
   • VASP / Exchange
   • Fund / Asset Manager
   • Auditor / Forensic Investigator
   • Compliance Consultant
   • OTC Desk / Broker
   • Other
4. Complete email verification by clicking the link sent to your inbox.
5. Set up two-factor authentication (2FA). BlockchainAnalysis.io requires 2FA for all accounts — TOTP (Google Authenticator, Authy) and hardware keys (YubiKey) are supported.

After completing registration, you will land on the dashboard with 10 free screening credits to get started.

Step 2: Run Your First Screening

Option A: Web Dashboard

1. From the dashboard, click New Screening in the top navigation bar.
2. In the address input field, paste the blockchain address you want to screen. For example:

0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

3. The platform will auto-detect the blockchain. For addresses that exist on multiple EVM chains, you can select the specific chain from the dropdown or choose All EVM Chains to screen across all supported EVM networks simultaneously.
4. Click Screen Address.
5. The report typically generates in 5-15 seconds depending on the complexity of the address's transaction history.

Option B: Telegram Bot

1. Open Telegram and search for @BA_ScreenBot or navigate to t.me/BA_ScreenBot.
2. Send the /start command to initialize the bot.
3. Link your BlockchainAnalysis.io account by sending /login and following the authentication flow.
4. Screen an address by sending it directly to the bot:

/screen 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

5. The bot will respond with a summary report including the risk score, entity match, and top risk factors. Use /full to request the complete 12-section report as a PDF.

Option C: REST API

For programmatic access, use the screening endpoint:

curl -X POST https://api.blockchainanalysis.io/v1/screening \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "chain": "ethereum"
  }'

Step 3: Read the Report

Every screening produces a report with 12 sections. Here is what each section tells you:

| # | Section | What It Contains | |---|---|---| | 1 | Executive Summary | One-paragraph overview of the address, its risk level, and the most significant findings. Designed for decision-makers who need a quick pass/fail assessment. | | 2 | Entity Match | Whether the address is linked to a known entity in the 49M+ database. Shows the entity name, category (exchange, protocol, mixer, sanctioned, etc.), and confidence level. | | 3 | Risk Score Breakdown | The overall 0-100 score with a per-factor breakdown showing which of the 11 risk factors contributed and by how much. | | 4 | Source of Funds | Traces where the funds in this address originated. Shows the percentage breakdown by source category (exchanges, DeFi protocols, direct mining, unknown, etc.). | | 5 | Destination Analysis | Where the address has sent funds. Categorized by destination type with volume and frequency data. | | 6 | Sanctions Check | Cross-reference results against OFAC SDN, EU Consolidated List, UN Security Council, and 29+ other sanctions lists. Shows exact match, fuzzy match, or clear status. | | 7 | DeFi Protocol Interactions | Lists all DeFi protocols the address has interacted with, including swap volume, liquidity positions, lending/borrowing activity, and protocol risk ratings. | | 8 | NFT Activity | NFT minting, purchasing, selling, and transfer history. Flags wash trading patterns and high-value NFT movements. | | 9 | Bridge Usage | Cross-chain bridge transactions including source chain, destination chain, bridge protocol used, and volume. Flags high-risk bridge patterns. | | 10 | Mixer/Privacy Protocol Exposure | Any interaction with mixing services (Tornado Cash, Wasabi Wallet, etc.) or privacy-enhancing protocols. Shows direct and indirect exposure percentages. | | 11 | Historical Risk Trend | How the address's risk score has changed over time. Useful for identifying addresses that have recently increased their risk profile. | | 12 | Recommendations | Actionable next steps based on the findings — whether to proceed, flag for review, block, or file a suspicious activity report (SAR). |

Step 4: Understand the Risk Score

The risk score is a number from 0 to 100:

| Range | Classification | Typical Action | |---|---|---| | 0 - 15 | Low Risk | Proceed normally. No elevated risk indicators detected. | | 16 - 40 | Medium-Low Risk | Proceed with standard due diligence. Minor risk factors present but within acceptable thresholds for most compliance programs. | | 41 - 60 | Medium Risk | Enhanced due diligence recommended. One or more significant risk factors detected. Review the Risk Score Breakdown section. | | 61 - 80 | High Risk | Escalate to compliance team. Multiple significant risk factors or direct exposure to high-risk categories. | | 81 - 100 | Critical Risk | Block or reject the transaction. Direct sanctions exposure, confirmed mixer usage, or association with known illicit activity. |

The score is computed from 11 independent risk factors, each weighted according to its severity. For a detailed explanation of every factor, see the Risk Score documentation.

What to Do Next

• Set up Transaction Monitoring — Configure continuous monitoring for addresses you interact with regularly. See Transaction Monitoring.
• Integrate the API — Automate screening in your deposit/withdrawal pipeline. See Integrations.
• Explore the Compliance Suite — Learn about Wallet Screening, Risk Scoring, and Supported Blockchains in depth.
• Configure Alerts — Set up real-time alerts for risk score changes, sanctions list updates, and high-risk transaction patterns from Settings > Alerts.