Активность кошельков
Отслеживайте адреса кошельков и получайте входящие и исходящие переводы нативной монеты и токенов.
Blockchain Webhook API для активности кошельков и переводов токенов
Адресные вебхуки отправляют переводы отслеживаемых кошельков и совпадающие логи контрактов на ваш HTTPS-приёмник; проверяйте подписи, дедуплицируйте события и обрабатывайте пропуски до зачисления платежа.
События до блока активации адреса нужно запрашивать отдельно из истории; replay их не восстанавливает. Внутренние переводы нативной монеты не включены. Число подтверждений должно быть в диапазоне каждой сети из GET /v1/push/chains и считается по блокам, а не по меткам safe или finalized.
Доставка активности адресов на ваш endpoint
native.transfer доставляет переводы нативной монеты в транзакциях верхнего уровня; token.transfer — переводы ERC-20, ERC-721 и ERC-1155. log доставляет другие логи, в которых отслеживаемый адрес является контрактом-источником или указан в topics[1]–topics[3].
GET /v1/push/chains возвращает поддерживаемые сейчас сети и допустимое число подтверждений. Выполните запрос с API key перед выбором сетей подписки.
Одна подписка охватывает несколько сетей с одним URL для получения событий. Разработчики и AI Agent имеют одинаковые варианты ёмкости и цены.
- Самообслуживание
До 1,000,000 адресов на подписку. Доступно после регистрации.
Стандартные тарифы по использованию
- Корпоративный
10,000,000 / 100,000,000 адресов на подписку.
Свяжитесь с нами для подключения
Для обоих вариантов действуют одинаковые тарифы за адрес-день и доставленное событие.
Используйте активность кошельков и контрактов
Платежи в стейблкоинах
Получайте переводы ERC-20 USDT / USDC и проверяйте контракт токена, получателя и целочисленную сумму перед зачислением платежа.
События контрактов
Отслеживайте адрес контракта для получения его логов или получайте логи с отслеживаемым адресом в topics[1]–topics[3].
Переводы NFT
Обрабатывайте переводы ERC-721 и ERC-1155 по token_id, а пакетные переводы — также по batch_index.
Проверка, подтверждение и восстановление событий
- Перед обработкой событий проверьте HMAC-SHA256 подпись для `webhook-id.webhook-timestamp.raw-body` с помощью секрета подписки; используйте исходное тело запроса и не парсите JSON предварительно.
- Доставка выполняется как минимум один раз. Удаляйте дубликаты по id события и возвращайте 2xx после надежного сохранения результата обработки. Неудачная доставка повторяется, пока подписка online и события находятся в пределах срока хранения.
- Задайте confirmations для каждой сети в пределах из GET /v1/push/chains. chain.reorg уведомляет о замене доставленных блоков: пометьте старые события по ref, сохраните автоматически повторно доставленные события канонической цепочки и удалите дубликаты по id.
- Replay повторно доставляет сохранённые совпадения в доступном диапазоне. Активность до добавления адреса или сети в подписку не извлекается.
Цены
Таблица показывает веса CU и бесплатную квоту адресов из GET /v1/plans. События данных оплачиваются за доставку; автоматические повторы и управляющие события бесплатны. Доставка через replay оплачивается по тарифу события.
Webhook-уведомления
Стоимость в CU из GET /v1/plans. Автоматические повторные попытки бесплатны.
Бесплатные адреса на аккаунт за сутки UTC: 1000
Бесплатная квота адресов на аккаунт за сутки UTC распределяется между всеми группами подписок независимо от тарифа. Для каждой группы учитывается максимальное число адресов за время, когда она была онлайн в эти сутки; квота выделяется в порядке возрастания ID групп. Один адрес в двух группах учитывается дважды; число цепей в группе не умножает число её адресов. Группа, которая все сутки была офлайн или удалена, не участвует в подсчёте. Для каждой группы оставшееся после вычета её доли квоты число умножается на вес CU `push.address_day` в `method_weights`. Текущая настроенная квота берётся из той же ценовой политики, что и плата за адресо-дни; это не ограничение ёмкости аккаунта и не отдельная квота для каждой группы.
| Метод | Единица тарификации | CU |
|---|---|---|
| push.address_day | Оплачиваемый адрес-день | 33 |
| push.history | Успешный запрос истории | 25 |
| push.log | Доставленное событие данных | 150 |
| push.native_transfer | Доставленное событие данных | 150 |
| push.token_transfer | Доставленное событие данных | 150 |