Pular para o conteúdo

Monitore depósitos e pagamentos de USDT / USDC

Monitore transferências compatíveis de USDT e USDC para depósitos, notificações a lojistas e pagamentos; uma notificação por si só não comprova a liquidação final.

Para desenvolvedores e AI Agents. Comece com sua chave API e seu receptor HTTPS; filtre contratos de tokens e valores na sua aplicação.

O monitoramento básico de transferências está disponível

A filtragem de valores e tokens é feita no seu receptor. Condições no servidor, confirmações em várias etapas e alertas de IM estarão disponíveis em breve.

Antes de começar

Desenvolvedores e AI Agent seguem o mesmo fluxo de integração. Configure BLOCKVECTRA_API_KEY com segurança e instale curl e jq. Escolha CHAIN na cobertura abaixo; verifique contrato do token, destinatário e valor inteiro na menor unidade. Push exige seu próprio receptor HTTPS na porta 443. Antes de criar a assinatura, confira a lista autenticada de redes, o intervalo de confirmações e o estado halted.

Veja o guia de cadastro programático →

Verificar depósitos em exchanges

Consulte logs ERC-20 Transfer do endereço de depósito. Defina TOKEN_CONTRACT e RECIPIENT a partir de configuração confiável; FROM_BLOCK e TO_BLOCK devem ser alturas hexadecimais dentro da cobertura do nó e do limite publicado. Avance o cursor persistente somente após processar 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 a verificar

Confira contrato, destinatário e valor inteiro; verifique o receipt e sua política de confirmações antes de creditar. Deduplicate por rede, transactionHash e logIndex; preserve blockHash para conciliar reorganizações.

Ler o guia completo

Receber avisos de pagamento para comerciantes

Defina RECIPIENT e RECEIVER_URL e crie uma assinatura básica de endereço com as confirmações padrão da rede. Guarde o secret com segurança. Aguarde applied_version >= change_version e registre applied_from_block antes de esperar atividade correspondente.

Redes compatíveis

Escolha CHAIN para este exemplo entre as redes disponíveis para execução abaixo

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 a verificar

O primeiro evento correspondente só conta após verificar a assinatura do body original, conferir token/destinatário/valor inteiro, deduplicar persistentemente por id e responder 2xx. HTTP 201 da assinatura não significa aviso de pagamento recebido.

Ler o guia completo

Acompanhar pagamentos enviados

Defina TX_HASH como uma transação já enviada pelo sistema de pagamentos. Leia seu receipt via JSON-RPC, compare receipt.blockNumber com a altura atual e confira os logs da transferência 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 a verificar

Um receipt null ou transação pending não significa pagamento recebido. Confira receipt.status, contrato do token, destinatário, valor inteiro e política de confirmações. Um receipt bem-sucedido não prova sozinho a transferência esperada.

Ler o guia completo

Limites de confirmação e cobertura

N confirmações não são finalidade da rede. Push básico não filtra valores ou tokens no servidor; filtre no receptor. Transferências de moeda nativa internas a contratos não são cobertas. Pending não é pagamento recebido. Concilie blocos substituídos em chain.reorg e processe substituições canônicas de forma idempotente. Algumas redes não cobrem transações do sistema; consulte a página da rede correspondente.

Recuperar lacunas e conciliar histórico

Replay reenvia apenas correspondências retidas; não recupera histórico anterior à ativação da assinatura ou do endereço. Use consultas RPC com intervalos limitados para períodos anteriores ou lacunas. Mantenha um cursor por rede e siga o guia completo para reorganizações.

Ler o guia completo

Opcionalmente, consulte transferências ERC-20 indexadas nas redes abaixo. FROM_BLOCK e TO_BLOCK devem ser alturas decimais dentro da cobertura indexada. Confira atualização e cobertura; siga next_cursor até o campo estar ausente. Verifique cada contrato, destinatário e valor inteiro; dados indexados não provam finalidade.

: "${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"
Ler o guia completo

Preços e regras de faturamento

Peso do método eth_getLogs: 30 CU ($3.00 por 1,000,000 de requisições).

Requisições rejeitadas pelo serviço (como intervalo de blocos excedido ou limite de taxa) não são faturadas. Veja o guia de faturamento ou a tabela de preços completa.

Notificações webhook

Pesos CU de GET /v1/plans. Tentativas automáticas são gratuitas.

Endereços gratuitos por conta e dia UTC: 1000

A franquia de endereços gratuitos por conta e dia UTC é compartilhada por todos os grupos de assinatura, independentemente do plano. Para cada grupo, conta-se o número máximo de endereços enquanto esteve online naquele dia; a franquia é distribuída em ordem crescente de ID do grupo. O mesmo endereço em dois grupos conta duas vezes; o número de chains de um grupo não multiplica sua quantidade de endereços. Um grupo offline ou excluído durante todo o dia não contribui para a contagem. Para cada grupo, a quantidade restante após descontar sua parte da franquia é multiplicada pelo peso CU `push.address_day` em `method_weights`. A franquia configurada atualmente vem da mesma política de preços usada na cobrança por endereço-dia; não é um limite de capacidade da conta nem uma franquia separada por grupo.

MétodoUnidade de cobrançaCU
push.address_dayDia de endereço faturável33
push.historyConsulta de histórico bem-sucedida25
push.logEvento de dados entregue150
push.native_transferEvento de dados entregue150
push.token_transferEvento de dados entregue150

Iniciar monitoramento