Перейти до основного вмісту

🔍 Forensic Agent

Інтелект на основі ШІ для розслідування гаманців, транзакцій та смарт-контрактів Ethereum у блокчейні.

Огляд​

Forensic Agent забезпечує аналітику блокчейну в реальному часі за допомогою Google BigQuery та Gemini AI. Запитуйте дані з блокчейну, використовуючи природну мову або прямі виклики API.

Ключові особливості​

✅ Перевірка балансу гаманця — Запит ETH-холдингів для будь-якої адреси ✅ Історія транзакцій — Відстежуйте рух коштів та активність гаманця ✅ Аналіз власників токенів — Визначте концентрацію та розподіл "китів" ✅ Верифікація смарт-контрактів — Перевіряйте типи контрактів (ERC20, ERC721) ✅ Інтеграція чату зі ШІ — Запити природною мовою англійською та українською

Як використовувати​

Через чат зі ШІ (Рекомендовано)​

Задавайте питання природною мовою:

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 контрактом?

Через API​

1. Перевірити баланс гаманця​

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"}'

Response:

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "eth_balance": 32.111223478,
  "found": true,
  "chain": "ethereum"
}

2. Отримати історію транзакцій​

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
  }'

Response:

{
  "address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
  "transactions": [
    {
      "hash": "0x...",
      "from": "0x...",
      "to": "0x...",
      "value_eth": 10.5,
      "timestamp": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 10
}

3. Отримати власників токенів​

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
  }'

Response:

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

4. Отримати інформацію про контракт​

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"}'

Response:

{
  "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "found": true,
  "is_erc20": true,
  "is_erc721": false,
  "deployed_at": "2017-11-28T00:41:21+00:00",
  "has_bytecode": true
}

Технічні деталі​

Джерело даних​

  • Провайдер: Google BigQuery Public Datasets
  • Набір даних: bigquery-public-data.crypto_ethereum
  • Частота оновлення: Майже в реальному часі (~5 хвилин затримки)

Підтримувані мережі​

  • ✅ Ethereum (Mainnet)
  • 🔜 Arbitrum (Скоро в Q2 2026)
  • 🔜 Solana (через Helius API)

Обмеження швидкості​

  • Безкоштовний рівень: 10 запитів/день (Публічний API)
  • Аутентифікований: Необмежено (потрібен API key)
  • Чат зі ШІ: Включено в ліміти чату

Варіанти використання​

🕵️ Розслідування гаманців​

Запит: "Check balance for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" Варіант використання: Перевірка холдингів командного гаманця, відстеження рухів китів

📊 Аналіз розподілу токенів​

Запит: "Show top 20 holders of USDT" Варіант використання: Оцінка ризику токеноміки, виявлення концентрації

🔐 Верифікація контракту​

Запит: "Is 0xdAC17F... an ERC20 contract?" Варіант використання: Перевірка стандартів токенів перед інтеграцією

💸 Відстеження руху коштів​

Запит: "Transaction history for 0xde0B... in last 30 days" Варіант використання: Аудит активності гаманця, розслідування підозрілих переказів

Обмеження​

Відомі обмеження
  • Історія транзакцій: Можуть бути прогалини через затримки синхронізації публічного набору даних BigQuery
  • Обсяг даних: Лише публічні дані блокчейну (без приватних транзакцій)
  • Історичні дані: Обмежено часовими рамками публічного набору даних Ethereum
  • Оновлення в реальному часі: Затримка близько 5 хвилин від фіналізації в мережі :::

Аутентифікація API​

Отримання API Key​

  1. Зареєструйтесь на vartovii.com
  2. Перейдіть до Settings → API Keys
  3. Згенеруйте новий ключ для Forensic Agent
  4. Додайте до запитів: X-API-Key: YOUR_API_KEY

Публічний доступ​

Ендпоінт перевірки працездатності є публічним (аутентифікація не потрібна):

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

Обробка помилок​

Поширені помилки​

ПомилкаПричинаРішення
Invalid address formatАдреса не починається з 0xПереконайтеся, що адреса має префікс 0x
BigQuery unavailableТимчасова проблема APIПовторіть спробу через 30 секунд
Wallet not foundАдреса не має активності в мережіПеревірте правильність адреси
Rate limit exceededЗабагато запитівОновіть до аутентифікованого рівня

Підтримка​

Журнал змін​

v1.0 — 23 січня 2026​

  • ✅ Початковий реліз з підтримкою Ethereum
  • ✅ Інтеграція чату зі ШІ (англійська + українська)
  • ✅ 4 основні ендпоінти: гаманець, транзакції, холдери, інформація про контракт
  • ✅ Інтеграція публічного набору даних BigQuery