🔍 Forensischer Agent

KI-gestützte On-Chain-Intelligenz zur Untersuchung von Ethereum-Wallets, Transaktionen und Smart Contracts.

Überblick

Der Forensische Agent bietet Echtzeit-Blockchain-Analysen, unterstützt von Google BigQuery und Gemini AI. Fragen Sie On-Chain-Daten mittels natürlicher Sprache oder direkter API-Aufrufe ab.

Hauptmerkmale

✅ Wallet-Guthabenprüfung — Abfrage von ETH + Top-ERC20-Beständen pro Adresse ✅ Transaktionsverlauf — Verfolgen Sie Geldflüsse und Wallet-Aktivitäten ✅ Token-Inhaber-Analyse — Identifizieren Sie Wal-Konzentration und -Verteilung ✅ Smart Contract-Verifizierung — Überprüfen Sie ERC-Typen plus Explorer-Quellverifizierungsstatus ✅ AI Chat-Integration — Abfragen in natürlicher Sprache auf Englisch und Ukrainisch

---

Verwendung

Über AI Chat (Empfohlen)

Stellen Sie Fragen in natürlicher Sprache:

English:

What is the balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?
Show me the top holders of USDT
Is 0xdAC17F958D2ee523a2206206994597C13D831ec7 an ERC20 contract?

Ukrainian:

Перевір баланс гаманця 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
Покажи топ холдерів USDT
Чи є 0xdAC17F958D2ee523a2206206994597C13D831ec7 ERC20 контрактом?

Über API

1. Wallet-Guthaben prüfen

curl -X POST https://api.vartovii.com/api/forensic/check_wallet \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Antwort:

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "eth_balance": 32.111223478,
  "usd_value": 94241.62,
  "eth_price": 2934.2,
  "token_balances": [
    {
      "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "balance": 2500.0,
      "usd_value": 2500.0
    }
  ],
  "found": true,
  "chain": "ethereum"
}

2. Transaktionsverlauf abrufen

curl -X POST https://api.vartovii.com/api/forensic/transaction_history \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
    "limit": 10,
    "days": 30
  }'

Antwort:

{
  "address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
  "transactions": [
    {
      "tx_hash": "0x...",
      "from": "0x...",
      "to": "0x...",
      "eth_value": 10.5,
      "gas_price_gwei": 12.4,
      "status": "success",
      "timestamp": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 10
}

3. Token-Inhaber abrufen

curl -X POST https://api.vartovii.com/api/forensic/token_holders \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "limit": 20
  }'

Antwort:

{
  "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "holders": [
    {
      "rank": 1,
      "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
      "balance": 2.195e16
    }
  ],
  "count": 20
}

4. Vertragsinformationen abrufen

curl -X POST https://api.vartovii.com/api/forensic/contract_info \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"}'

Antwort:

{
  "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "found": true,
  "is_erc20": true,
  "is_erc721": false,
  "deployed_at": "2017-11-28T00:41:21+00:00",
  "has_bytecode": true,
  "is_verified_source": true,
  "verification_source": "etherscan",
  "verification_url": "https://etherscan.io/address/0xdac17f958d2ee523a2206206994597c13d831ec7#code",
  "contract_name": "Tether USD"
}

---

Technische Details

Datenquelle

• Provider: Google BigQuery Public Datasets
• Dataset: bigquery-public-data.crypto_ethereum
• Update Frequency: Nahe Echtzeit (ca. 5 Minuten Verzögerung)

Unterstützte Chains

• ✅ Ethereum (Mainnet)
• 🔜 Arbitrum (Coming Q2 2026)
• 🔜 Solana (via Helius API)

Ratenbegrenzungen

• Free Tier: 10 Anfragen/Tag (Öffentliche API)
• Authenticated: Unbegrenzt (erfordert API key)
• AI Chat: In Chat-Limits enthalten

---

Anwendungsfälle

🕵️ Wallet-Untersuchungen

Abfrage: "Check balance for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" Anwendungsfall: Team-Wallet-Bestände überprüfen, Wal-Bewegungen verfolgen

📊 Token-Distributionsanalyse

Abfrage: "Show top 20 holders of USDT" Anwendungsfall: Tokenomics-Risiko bewerten, Konzentration identifizieren

🔐 Vertragsverifizierung

Abfrage: "Is 0xdAC17F... an ERC20 contract?" Anwendungsfall: Token-Standards vor der Integration überprüfen

💸 Geldflussverfolgung

Abfrage: "Transaction history for 0xde0B... in last 30 days" Anwendungsfall: Wallet-Aktivitäten prüfen, verdächtige Überweisungen untersuchen

---

Einschränkungen

Bekannte Einschränkungen

• Transaktionsverlauf: Kann Lücken aufgrund von Synchronisierungsverzögerungen des öffentlichen BigQuery-Datensatzes aufweisen
• Datenumfang: Nur öffentliche Blockchain-Daten (keine privaten Transaktionen)
• Historische Daten: Beschränkt auf den Zeitrahmen des öffentlichen Ethereum-Datensatzes
• Echtzeit-Updates: Ca. 5 Minuten Verzögerung ab On-Chain-Finalität :::

---

API-Authentifizierung

API Key erhalten

1. Registrieren Sie sich unter vartovii.com
2. Navigieren Sie zu Einstellungen → API Keys
3. Erzeugen Sie einen neuen Key für den Forensischen Agent
4. Fügen Sie zu Anfragen hinzu: X-API-Key: YOUR_API_KEY

Öffentlicher Zugriff

Der Health-Check-Endpoint ist öffentlich (keine Authentifizierung erforderlich):

curl https://api.vartovii.com/api/forensic/health

---

Fehlerbehandlung

Häufige Fehler

Fehler	Ursache	Lösung
Invalid address format	Adresse beginnt nicht mit 0x	Stellen Sie sicher, dass die Adresse das Präfix 0x hat
BigQuery unavailable	Temporäres API-Problem	Versuchen Sie es nach 30 Sekunden erneut
Wallet not found	Adresse hat keine On-Chain-Aktivität	Verifizieren Sie, dass die Adresse korrekt ist
Rate limit exceeded	Zu viele Anfragen	Upgrade auf authentifizierte Stufe

---

Support

• Dokumentation: docs.vartovii.com
• Discord: discord.gg/vartovii
• Email: support@vartovii.com

---

Changelog

v1.1 — 5. März 2026

• ✅ Wallet-Endpunkt liefert jetzt Top-ERC20-Positionen (token_balances)
• ✅ Contract-Info-Endpunkt liefert Quellverifizierungs-Metadaten
• ✅ USD-Bewertungsweg wurde mit CoinGecko Retry/Throttle gehärtet

v1.0 — 23. Januar 2026

• ✅ Erstveröffentlichung mit Ethereum-Unterstützung
• ✅ AI Chat-Integration (Englisch + Ukrainisch)
• ✅ 4 Kern-Endpoints: Wallet, Transaktionen, Inhaber, Vertragsinformationen
• ✅ BigQuery Public Dataset-Integration