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á disponibleEl 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.
Cadenas compatibles
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 completaRecibir 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
- Arbitrum One — Se puede ejecutar ahora
- Base — Se puede ejecutar ahora
- BNB Smart Chain — Se puede ejecutar ahora
- Ethereum — Se puede ejecutar ahora
- Ethereum Sepolia — Se puede ejecutar ahora
- HyperEVM — Se puede ejecutar ahora
- Polygon — Se puede ejecutar ahora
- Robinhood Chain — Se puede ejecutar ahora
- Robinhood Chain Testnet — Se puede ejecutar ahora
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 completaSeguir 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.
Cadenas compatibles
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 completaLí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.
Cadenas compatibles
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.
Cadenas compatibles
: "${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"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étodo | Unidad de facturación | CU |
|---|---|---|
| push.address_day | Día de dirección facturable | 33 |
| push.history | Consulta de historial correcta | 25 |
| push.log | Evento de datos entregado | 150 |
| push.native_transfer | Evento de datos entregado | 150 |
| push.token_transfer | Evento de datos entregado | 150 |