Skip to main content

Forensic Agent - Blockchain Analytics

Last Updated: 2026-01-23 Version: 1.0 (MVP) Status: ✅ Production Ready

Overview​

Forensic Agent is Vartovii's on-chain analytics module that provides real-time blockchain intelligence through AI Chat. It analyzes wallet balances, token distributions, transaction histories, and smart contract information directly from blockchain data.

Supported Networks:

  • ✅ Ethereum Mainnet (Current)
  • 🚧 Arbitrum (Q2 2026)
  • 🚧 Polygon (Q3 2026)
  • 🚧 Solana (Q3 2026)

Features​

1. 💰 Wallet Balance Analysis​

Check ETH balances for any Ethereum address with real-time USD conversion.

Example Questions:

  • "What's the balance of Vitalik's wallet: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"
  • "Check balance for 0xabcd..."
  • "How much ETH does this address hold: 0x..."

Response Includes:

  • ETH balance (precise to 4 decimals)
  • USD value (at current market price)
  • Etherscan link for verification
  • Blockchain network (Ethereum mainnet)

Example:

Wallet 0xd8dA6BF2... holds 32.11 ETH on Ethereum mainnet.
≈ $94,241.62 USD (ETH @ $2,933.45)
Etherscan: https://etherscan.io/address/0xd8dA...

2. 📊 Token Holder Distribution​

Analyze top holders of any ERC20 token to understand distribution and concentration.

Example Questions:

  • "Who are the top holders of USDT?"
  • "Show me token distribution for 0xdac17f958d2ee523a2206206994597c13d831ec7"
  • "Analyze USDC holders"

Response Includes:

  • Top N holders (default: 20)
  • Token balances (human-readable, not scientific notation)
  • USD value for each holder
  • Total supply held by top holders
  • Token price
  • Etherscan token page link
  • Context (e.g., "Binance Cold Wallet")

Example:

Found 20 top holders for USDT.

Top holder: 0xf977814e... with 21,951,179,974.29 USDT ($21,925,650,751.98)
Total among top 20: 48,490,426,863.74 USDT ($48,434,032,497.30 USD)

Token price: $0.998837
Etherscan: https://etherscan.io/token/0xdac17f...

3. 📜 Transaction History​

View recent transactions for any wallet address.

Example Questions:

  • "Show recent transactions for 0xd8dA..."
  • "What are the latest transfers for Vitalik's wallet?"
  • "Has this address been active recently?"

Response Includes:

  • Transaction count (last 30 days by default)
  • Most recent transaction details
  • Direction (incoming/outgoing)
  • ETH value
  • Etherscan link for full history

Example:

Found 5 transactions in last 30 days for 0xd8dA6BF2....
Most recent: 2.5 ETH (out) 3 days ago.
View on Etherscan: https://etherscan.io/address/0xd8dA...#transactions

4. 🔍 Smart Contract Verification​

Identify smart contract types and deployment information.

Example Questions:

  • "What type of contract is 0xdac17f958...?"
  • "Is this an ERC20 token contract?"
  • "When was this contract deployed?"

Response Includes:

  • Contract type (ERC20 Token / ERC721 NFT / Smart Contract)
  • Deployment date
  • Etherscan contract link
  • Bytecode verification status

Example:

Contract 0xdac17f95... found on Ethereum.
Type: ERC20 Token
Deployed: November 28, 2017, 00:41:21 UTC
Etherscan: https://etherscan.io/address/0xdac17f...

How to Use​

Via AI Chat​

Simply ask Vartovii's AI Chat about blockchain data in natural language:

  1. Open AI Chat in Vartovii dashboard
  2. Ask about wallets, tokens, transactions, or contracts
  3. Include Ethereum addresses (0x...)
  4. Get comprehensive, contextualized responses

Tips:

  • Use full addresses (0x... format)
  • Be specific about what you want to know
  • Questions can be in Ukrainian, English, or German

Data Sources​

  • Blockchain Data: Google BigQuery Public Datasets (bigquery-public-data.crypto_ethereum)
  • Price Data: CoinGecko API (real-time ETH/USD and token prices)
  • Verification: Etherscan (all responses include clickable links)

Limitations​

Current (MVP)​

  • ✅ Ethereum mainnet only
  • ✅ Top 20 token holders (more can be requested)
  • ✅ 30-day transaction history (configurable)
  • ⚠️ Token balances calculated from transfer events (approximate)

Planned Improvements (Q2-Q3 2026)​

  • 🚧 Multi-chain support (Arbitrum, Polygon, Solana)
  • 🚧 NFT holder analysis (ERC721)
  • 🚧 DeFi protocol interactions
  • 🚧 Wallet risk scoring
  • 🚧 Historical price data for past transactions

Example Use Cases​

1. Due Diligence​

"Before investing in a token, analyze the top holders to check for concentration risk."

Query: "Show me top holders of [token contract]" Insight: Identify if whales control >50% of supply

2. Wallet Verification​

"Verify a wallet address shared by a project team."

Query: "Check balance for [address]" Insight: Confirm they hold what they claim

3. Smart Contract Auditing​

"Verify if an address is a legitimate ERC20 token contract."

Query: "What type of contract is [address]?" Insight: Identify potential scam contracts

4. Transaction Monitoring​

"Check if a wallet has been active recently."

Query: "Show recent transactions for [address]" Insight: Detect dormant/active wallets

Integration with Other Modules​

Forensic Agent works seamlessly with Vartovii's other AI capabilities:

  • Corporate Analytics: Analyze company-owned wallets
  • Crypto Intelligence: Cross-reference DeFi project treasuries
  • AI Smart Reports: Include blockchain data in investment memos
  • Scam Alert: Verify addresses mentioned in crypto scam reports

Privacy & Security​

  • ✅ No wallet connection required - all data is public blockchain data
  • ✅ Read-only - cannot execute transactions
  • ✅ No personal data - addresses are pseudonymous
  • ✅ Rate-limited - protects against abuse

Support​

For questions, feature requests, or issues:

Changelog​

v1.0.0 (2026-01-23) - MVP Release​

  • ✅ Wallet balance with USD conversion
  • ✅ Token holder distribution analysis
  • ✅ Transaction history
  • ✅ Smart contract verification
  • ✅ Etherscan link integration
  • ✅ Human-readable token balances (no scientific notation)
  • ✅ Comprehensive AI responses with context

Powered by Google BigQuery, CoinGecko, and Google Vertex AI Gemini 3 preview (with 2.5 fallback)