Мониторинг депозитов и выплат USDT / USDC
Отслеживайте поддерживаемые переводы USDT и USDC для депозитов, уведомлений продавцов и выплат; само по себе уведомление не означает окончательный расчёт.
Для разработчиков и AI Agent. Начните с API-ключа и своего HTTPS-обработчика; фильтруйте контракты токенов и суммы в приложении.
Базовый мониторинг переводов доступенФильтрация сумм и токенов выполняется в вашем обработчике. Серверные условия, несколько этапов подтверждения и IM-уведомления появятся скоро.
Перед началом
Разработчики и AI Agent используют одинаковый процесс подключения. Безопасно задайте BLOCKVECTRA_API_KEY и установите curl и jq. Выберите CHAIN из покрытия ниже; проверьте контракт токена, получателя и целую сумму в минимальных единицах. Для Push нужен собственный HTTPS-приёмник на порту 443. Перед созданием подписки проверьте авторизованный список сетей, диапазон подтверждений и состояние halted.
Руководство по программной регистрации →Проверка биржевых депозитов
Опрашивайте логи ERC-20 Transfer для адреса депозита. Задайте TOKEN_CONTRACT и RECIPIENT из доверенной конфигурации; FROM_BLOCK и TO_BLOCK — шестнадцатеричные высоты в пределах покрытия узла и опубликованного лимита. Продвигайте постоянный курсор только после обработки каждого диапазона.
Поддерживаемые сети
set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TOKEN_CONTRACT:?}" "${RECIPIENT:?}"
: "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
TOPIC_TO="0x000000000000000000000000${RECIPIENT#0x}"
jq -n --arg token "$TOKEN_CONTRACT" --arg to "$TOPIC_TO" \
--arg from "$FROM_BLOCK" --arg end "$TO_BLOCK" \
'{jsonrpc:"2.0",id:1,method:"eth_getLogs",params:[{address:$token,
fromBlock:$from,toBlock:$end,topics:[
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",null,$to]}]}' |
curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-Результат для проверки
Сверьте контракт, получателя и целую сумму; проверьте receipt и политику подтверждений перед зачислением. Удаляйте дубликаты по сети, transactionHash и logIndex; сохраняйте blockHash для сверки реорганизаций.
Открыть полное руководствоУведомления о платежах для продавцов
Задайте RECIPIENT и RECEIVER_URL и создайте базовую подписку на адрес с подтверждениями сети по умолчанию. Безопасно сохраните secret. Дождитесь applied_version >= change_version и запишите applied_from_block, затем ожидайте подходящую активность.
Поддерживаемые сети
- Arbitrum One — Доступно для выполнения
- Base — Доступно для выполнения
- BNB Smart Chain — Доступно для выполнения
- Ethereum — Доступно для выполнения
- Ethereum Sepolia — Доступно для выполнения
- HyperEVM — Доступно для выполнения
- Polygon — Доступно для выполнения
- Robinhood Chain — Доступно для выполнения
- Robinhood Chain Testnet — Доступно для выполнения
Выберите CHAIN для этого примера из доступных для выполнения сетей ниже
set -euo pipefail
umask 077
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${RECEIVER_URL:?}"
PUSH_URL='https://api.blockvectra.com/v1/push'
curl --fail-with-body -sS "$PUSH_URL/chains" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" > push-chains.json
jq -e --arg chain "$CHAIN" 'any(.chains[]; .chain == $chain and .halted == false)' push-chains.json
jq -n --arg url "$RECEIVER_URL" --arg chain "$CHAIN" \
'{url: $url, chains: {($chain): {}}}' > create.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-H 'Content-Type: application/json' -d @create.json > subscription.json
SUBSCRIPTION_ID=$(jq -er '.id' subscription.json)
jq -n --arg recipient "$RECIPIENT" '{addresses: [$recipient]}' > addresses.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID/addresses/add" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-H 'Content-Type: application/json' -d @addresses.json > address-change.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID" \
-H "x-api-key: $BLOCKVECTRA_API_KEY"Результат для проверки
Первое подходящее событие засчитывается после проверки подписи исходного body, проверки токена/получателя/целой суммы, постоянной дедупликации по id и ответа 2xx приёмника. HTTP 201 подписки не означает получение уведомления о платеже.
Открыть полное руководствоОтслеживание выплат
Задайте TX_HASH транзакции, уже отправленной платёжной системой. Прочитайте receipt через JSON-RPC, сравните receipt.blockNumber с текущей вершиной и сверьте ожидаемые логи перевода токена.
Поддерживаемые сети
set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TX_HASH:?}"
jq -n --arg hash "$TX_HASH" \
'{jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[$hash]}' |
curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-Результат для проверки
receipt null или транзакция pending не означает получение платежа. Проверьте receipt.status, контракт токена, получателя, целую сумму и политику подтверждений. Успешный receipt сам по себе не доказывает ожидаемый перевод.
Открыть полное руководствоГраницы подтверждений и покрытия
N подтверждений не являются финальностью сети. Базовый Push не фильтрует суммы или токены на сервере; фильтруйте в приёмнике. Внутренние переводы нативной монеты в контрактах не покрываются. Pending не означает получение платежа. При chain.reorg сверяйте заменённые блоки и идемпотентно обрабатывайте канонические замены. Некоторые сети не покрывают системные транзакции; см. страницу соответствующей сети.
Восстановление пропусков и сверка истории
Replay повторно отправляет только сохранённые совпадения; история до активации подписки или адреса не восстанавливается. Для ранних интервалов и пропусков используйте ограниченный RPC-опрос. Ведите курсор по каждой сети и сверяйте реорганизации по полному руководству.
Поддерживаемые сети
Дополнительно можно запросить индексированные ERC-20 переводы в сетях ниже. FROM_BLOCK и TO_BLOCK — десятичные высоты в пределах индексированного покрытия. Проверяйте актуальность и покрытие, следуйте next_cursor до отсутствия поля. Проверяйте контракт, получателя и целую сумму; индексированные данные не доказывают финальность.
Поддерживаемые сети
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
curl --fail-with-body -sS --get \
"https://api.blockvectra.com/v1/data/$CHAIN/addresses/$RECIPIENT/transfers" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
--data-urlencode 'standard=erc20' --data-urlencode 'direction=in' \
--data-urlencode "from_block=$FROM_BLOCK" --data-urlencode "to_block=$TO_BLOCK"Тарифы и правила биллинга
Вес метода eth_getLogs: 30 CU ($3.00 за 1,000,000 запросов).
Запросы, отклоненные сервисом (например, при превышении диапазона блоков или лимита запросов), не тарифицируются. См. правила биллинга или полный тарифный план.
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 |