Saltar al contenido

Monitorea depósitos y pagos de USDT / USDC

Monitorea transferencias admitidas de USDT y USDC para depósitos, notificaciones a comercios y pagos; una notificación por sí sola no establece la liquidación definitiva.

Para desarrolladores y AI Agents. Empieza con tu clave API y tu receptor HTTPS; filtra contratos de tokens e importes en tu aplicación.

La monitorización básica de transferencias está disponible

El filtrado de importes y tokens se ejecuta en tu receptor. Las condiciones del servidor, las confirmaciones en varias etapas y las alertas de IM estarán disponibles próximamente.

Antes de empezar

Los desarrolladores y los AI Agent siguen el mismo proceso de integración. Configura BLOCKVECTRA_API_KEY de forma segura e instala curl y jq. Elige CHAIN de la cobertura indicada; verifica el contrato del token, el destinatario y el importe entero en unidades mínimas. Push requiere tu propio receptor HTTPS en el puerto 443. Antes de crear la suscripción, revisa la lista autenticada de cadenas, el rango de confirmaciones y el estado halted.

Ver la guía de registro programático →

Verificar depósitos de exchanges

Consulta los logs ERC-20 Transfer de la dirección de depósito. Define TOKEN_CONTRACT y RECIPIENT con una configuración fiable; FROM_BLOCK y TO_BLOCK deben ser alturas hexadecimales dentro de la cobertura del nodo y el límite publicado. Avanza el cursor persistente solo tras procesar cada intervalo.

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 @-

Resultado que debes verificar

Comprueba contrato, destinatario e importe entero; verifica el receipt y tu política de confirmaciones antes de abonar. Deduplica por cadena, transactionHash y logIndex; conserva blockHash para conciliar reorganizaciones.

Leer la guía completa

Recibir avisos de cobro para comercios

Define RECIPIENT y RECEIVER_URL y crea una suscripción básica por dirección con las confirmaciones predeterminadas. Guarda el secret de forma segura. Espera a applied_version >= change_version y registra applied_from_block antes de esperar actividad coincidente.

Cadenas compatibles

Elige CHAIN para este ejemplo entre las cadenas actualmente disponibles que se indican a continuación

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"

Resultado que debes verificar

El primer evento coincidente cuenta solo tras verificar la firma del body original, comprobar token/destinatario/importe entero, deduplicar de forma persistente por id y devolver 2xx. El HTTP 201 de la suscripción no es una notificación de cobro recibida.

Leer la guía completa

Seguir pagos salientes

Define TX_HASH como una transacción ya enviada por tu sistema de pagos. Lee su receipt con JSON-RPC, compara receipt.blockNumber con la cabecera actual y concilia los logs de la transferencia esperada.

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 @-

Resultado que debes verificar

Un receipt null o una transacción pending no equivale a un pago recibido. Verifica receipt.status, contrato del token, destinatario, importe entero y política de confirmaciones. Un receipt exitoso por sí solo no prueba la transferencia esperada.

Leer la guía completa

Límites de confirmación y cobertura

N confirmaciones no son finalidad de la cadena. Push básico no filtra importes ni tokens en el servidor; filtra en tu receptor. No cubre transferencias de moneda nativa internas a contratos. Pending no es un pago recibido. Concilia los bloques sustituidos en chain.reorg y procesa los reemplazos canónicos de forma idempotente. Algunas cadenas excluyen las transacciones del sistema de su cobertura; consulta la página de la cadena correspondiente.

Recuperar lagunas y conciliar el historial

Replay solo reenvía coincidencias conservadas; no recupera historial anterior a la activación de la suscripción o dirección. Usa consultas RPC acotadas para esos intervalos o lagunas. Mantén un cursor por cadena y concilia reorganizaciones con la guía completa.

Leer la guía completa

Opcionalmente, consulta transferencias ERC-20 indexadas en las cadenas siguientes. FROM_BLOCK y TO_BLOCK deben ser alturas decimales dentro de la cobertura indexada. Comprueba actualidad y cobertura, y sigue next_cursor hasta que falte. Verifica contrato, destinatario e importe entero; los datos indexados no prueban finalidad.

: "${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"
Leer la guía completa

Precios y reglas de facturación

Peso del método eth_getLogs: 30 CU ($3.00 por 1,000,000 de solicitudes).

Las solicitudes rechazadas por el servicio (como rango de bloques excesivo o límite de tasa) no se facturan. Consulta la guía de facturación o la tabla de precios completa.

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

Comenzar monitoreo