Saltar al contenido

API Webhook de blockchain para actividad de wallets y transferencias de tokens

Los Webhooks de direcciones envían las transferencias de wallets vigiladas y los logs de contratos coincidentes a tu receptor HTTPS; verifica firmas, deduplica eventos y gestiona brechas antes de acreditar un pago.

Los eventos anteriores al bloque de activación de una dirección requieren una recuperación histórica aparte; replay no los recupera. Se excluyen las transferencias nativas internas. Las confirmaciones deben estar dentro del rango de cada cadena en GET /v1/push/chains y cuentan bloques, no etiquetas safe o finalized.

Actividad de direcciones enviada a tu endpoint

native.transfer entrega transferencias de moneda nativa en transacciones de nivel superior; token.transfer entrega transferencias ERC-20, ERC-721 y ERC-1155. log entrega otros logs cuyo contrato emisor o topics[1]–topics[3] contienen una dirección observada.

GET /v1/push/chains devuelve las cadenas compatibles actualmente y sus límites de confirmaciones. Consúltalo con tu API key antes de elegir las cadenas de una suscripción.

Una suscripción cubre varias cadenas con una URL de recepción. Los desarrolladores y AI Agents tienen las mismas opciones de capacidad y precios.

Autoservicio

Hasta 1,000,000 direcciones por suscripción. Disponible al registrarte.

Tarifas estándar por uso

Empresas

10,000,000 / 100,000,000 direcciones por suscripción.

Contáctanos para activar

Ambos niveles usan las mismas tarifas por dirección-día y evento entregado.

Usa la actividad de wallets y contratos

Actividad de wallets

Observa direcciones de wallets para recibir entradas y salidas de moneda nativa y tokens.

Pagos con stablecoins

Recibe transferencias ERC-20 de USDT / USDC y valida el contrato del token, destinatario e importe entero antes de acreditar un pago.

Eventos de contratos

Observa un contrato para recibir sus logs, o recibe logs con una dirección observada en topics[1]–topics[3].

Transferencias NFT

Procesa transferencias ERC-721 y ERC-1155 con token_id y, para transferencias por lotes, batch_index.

Monitoreo de pagos en USDT / USDC

Verifica, confirma y recupera eventos

  • Verifica la firma HMAC-SHA256 sobre `webhook-id.webhook-timestamp.raw-body` con el secreto de la suscripción antes de procesar eventos; usa el cuerpo original de la petición y no parsees el JSON antes.
  • La entrega es al menos una vez. Elimina duplicados por id de evento y devuelve 2xx tras guardar el resultado del procesamiento. Las entregas fallidas se reintentan mientras la suscripción está online y los eventos están dentro del periodo de retención.
  • Configura confirmations por cadena dentro de los límites de GET /v1/push/chains. chain.reorg indica bloques reemplazados: marca los eventos anteriores por ref, conserva los eventos canónicos reenviados automáticamente y elimina duplicados por id.
  • Replay vuelve a entregar coincidencias almacenadas dentro del rango reproducible. No recupera actividad anterior a la incorporación de una dirección o cadena a la suscripción.

Precios

La tabla muestra los pesos CU y el cupo gratuito de direcciones de GET /v1/plans. Los eventos de datos se cobran por entrega; los reintentos automáticos y los eventos de control son gratuitos. Las entregas por replay se cobran a la tarifa del evento.

Notificaciones webhook

Pesos CU de GET /v1/plans. Los reintentos automáticos son gratuitos.

Direcciones gratuitas por cuenta y día UTC: 1000

El cupo de direcciones gratuitas por cuenta y día UTC se comparte entre todos los grupos de suscripción, independientemente del plan. Para cada grupo se cuenta su máximo de direcciones mientras estuvo en línea ese día; el cupo se asigna por ID de grupo en orden ascendente. La misma dirección en dos grupos cuenta dos veces; el número de cadenas de un grupo no multiplica su número de direcciones. Un grupo desconectado o eliminado durante todo el día no aporta direcciones al recuento. Para cada grupo, el número restante tras descontar su parte del cupo se multiplica por el peso CU `push.address_day` de `method_weights`. El cupo configurado actualmente procede de la misma política de precios utilizada para el cargo por dirección-día; no es un límite de capacidad de la cuenta ni un cupo independiente por grupo.

MétodoUnidad de facturaciónCU
push.address_dayDía de dirección facturable33
push.historyConsulta de historial correcta25
push.logEvento de datos entregado150
push.native_transferEvento de datos entregado150
push.token_transferEvento de datos entregado150
Precios

Conecta tu receptor