Документация API

Введение

API Chain Monitor позволяет управлять мониторами кошельков и получать уведомления о транзакциях в реальном времени для Ethereum, BSC, Polygon, Avalanche и Fantom. Создайте API ключ в Панель → API и используйте его для серверных запросов.

• • REST JSON API с предсказуемыми URL ресурсов
• • Ethereum, BSC, Polygon, Avalanche, Fantom
• • Уведомления по webhook в реальном времени

Аутентификация

Используйте Bearer токен. Создайте API ключ в Панель → API и передайте его в заголовке Authorization.

Authorization: Bearer api_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Храните API ключ в безопасности. Не публикуйте его и не добавляйте в репозиторий. При компрометации — смените ключ в панели.

Обработка ошибок

API использует стандартные HTTP-коды ответов.

Мониторы кошельков

Мониторы — это адреса блокчейна, которые вы мониторите. У каждого есть сеть, токены, минимальная сумма и опциональный URL webhook.

Получите networkUuid и tokenUuids из GET /public/networks (без авторизации). Используйте network.id и token.id из ответа.

• GET /v1/wallets

  Возвращает все мониторы кошельков вашего аккаунта.

  curl -X GET "https://api.chain-monitor.online/v1/wallets" \
    -H "Authorization: Bearer api_key_xxx"

• POST /v1/wallets

  Добавить новый кошелёк для мониторинга.

  curl -X POST "https://api.chain-monitor.online/v1/wallets" \
    -H "Authorization: Bearer api_key_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
      "networkUuid": "UUID_FROM_GET_PUBLIC_NETWORKS",
      "tokenUuids": ["TOKEN_UUID_FROM_NETWORK"],
      "minAmount": "100",
      "webhookUrl": "https://your-app.com/webhook",
      "notifySettings": { "webhook": true, "telegram": false }
    }'

• PATCH /v1/wallets/:id

  Изменить настройки: токены, минимальная сумма, URL webhook.

• DELETE /v1/wallets/:id

  Удалить монитор кошелька. Связанные данные удаляются.

• POST /v1/wallets/:id/toggle

  Включить или приостановить мониторинг кошелька.

Уведомления

Список и детали доставки уведомлений (webhook, Telegram и т.д.).

Требует JWT (сессия в панели). Недоступно с API ключом.

• GET /notifications

  Список с пагинацией и фильтрами: limit, offset, status, channel, networkSlug.

  curl -X GET "https://api.chain-monitor.online/notifications?limit=25&offset=0" \
    -H "Authorization: Bearer JWT_TOKEN"

• GET /notifications/:id

  Получить одно уведомление по ID.

Публичные (без авторизации)

• GET /public/networks — GET /public/networks — активные сети и токены (без авторизации).
• GET /public/pack-credits — GET /public/pack-credits — доступные пакеты кредитов (без авторизации).

Webhooks

Когда транзакция совпадает с вашим монитором (сеть, токен, минимальная сумма), мы отправляем POST-запрос на ваш webhook URL. В теле передаются данные транзакции (txHash, network, direction, asset, amount, from, to, timestamp). При необходимости проверяйте подпись запроса по заголовку.

{
  "eventType": "transaction_detected",
  "userId": "uuid",
  "correlationId": "tx-0x...-timestamp",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "txHash": "0x...",
    "network": "Ethereum",
    "blockNumber": 19485738,
    "direction": "in",
    "asset": "USDT",
    "amount": "250.00",
    "from": "0x...",
    "to": "0x...",
    "timestamp": "2024-01-15T10:30:00Z",
    "txHashLink": "https://etherscan.io/tx/0x...",
    "fromLink": "https://etherscan.io/address/0x...",
    "toLink": "https://etherscan.io/address/0x..."
  }
}

Контакты

Нужна помощь? Используйте страницу контактов для вопросов по интеграции и поддержке.

Email: support@chain-monitor.online