Zum Hauptinhalt springen

🔍 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-Beständen für jede 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 Vertragstypen (ERC20, ERC721)
✅ 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,
  "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": [
    {
      "hash": "0x...",
      "from": "0x...",
      "to": "0x...",
      "value_eth": 10.5,
      "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.195e+16
    }
  ],
  "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
}

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​

FehlerUrsacheLösung
Invalid address formatAdresse beginnt nicht mit 0xStellen Sie sicher, dass die Adresse das Präfix 0x hat
BigQuery unavailableTemporäres API-ProblemVersuchen Sie es nach 30 Sekunden erneut
Wallet not foundAdresse hat keine On-Chain-AktivitätVerifizieren Sie, dass die Adresse korrekt ist
Rate limit exceededZu viele AnfragenUpgrade auf authentifizierte Stufe

Support​

Changelog​

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