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

API Webhook блокчейну для активності гаманців та переказів токенів

Адресні Webhook надсилають перекази відстежуваних гаманців та відповідні логи контрактів на ваш HTTPS-приймач; перевіряйте підписи, дедуплікуйте події та обробляйте прогалини перед зарахуванням платежу.

Події до блоку активації адреси потребують окремого завантаження з історії; replay не може їх відновити. Внутрішні перекази нативної монети виключені. Кількість підтверджень має залишатися в межах діапазону кожної мережі з GET /v1/push/chains і рахується за блоками, а не за мітками safe або finalized.

Активність адрес, доставлена на ваш ендпоінт

Отримуйте 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.

Моніторинг платежів USDT / USDC

Перевірка, підтвердження та відновлення подій

  • Перевіряйте підпис HMAC-SHA256 для `webhook-id.webhook-timestamp.raw-body` за допомогою секрету вашої підписки перед обробкою подій; використовуйте вихідне тіло запиту (raw body) і не парсіть JSON попередньо.
  • Доставка здійснюється щонайменше один раз. Дедуплікуйте за id події та повертайте 2xx після надійного збереження результату обробки. Невдалі доставки повторюються, поки підписка онлайн, а події залишаються в межах вікна збереження.
  • Встановлюйте confirmations для кожної мережі в межах лімітів, повернутих GET /v1/push/chains. chain.reorg повідомляє про замінені блоки: позначайте старі події за ref, зберігайте автоматично повторно доставлені канонічні події та дедуплікуйте за id.
  • Replay повторно доставляє збережені збіги в доступному для відтворення діапазоні. Він не витягує активність, що відбулася до додавання адреси або мережі до підписки.

Ціни

У таблиці наведено ваги CU та безкоштовний ліміт адрес із GET /v1/plans. Події даних оплачуються за кожну доставку; автоматичні повторні спроби та керуючі події безкоштовні. Доставка через replay оплачується за тарифом події.

Webhook push

Ваги 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
Ціни

Підключіть ваш приймач