Passer au contenu

Suivre les dépôts et paiements sortants USDT / USDC

Suivez les transferts USDT et USDC pris en charge pour les dépôts, les notifications marchands et les paiements ; une notification seule n’établit pas le règlement final.

Pour les développeurs et les AI Agents. Commencez avec votre clé API et votre récepteur HTTPS ; filtrez les contrats de tokens et les montants dans votre application.

La surveillance de base des transferts est disponible

Le filtrage des montants et des tokens se fait dans votre récepteur. Les conditions côté serveur, les confirmations en plusieurs étapes et les alertes IM seront bientôt disponibles.

Avant de commencer

Les développeurs et les AI Agent suivent le même processus d’intégration. Configurez BLOCKVECTRA_API_KEY de façon sûre et installez curl et jq. Choisissez CHAIN dans la couverture ci-dessous ; vérifiez le contrat du token, le destinataire et le montant entier en unités minimales. Push nécessite votre propre récepteur HTTPS sur le port 443. Avant de créer l’abonnement, vérifiez la liste authentifiée, la plage de confirmations et l’état halted.

Voir le guide d'inscription programmatique →

Vérifier les dépôts sur les plateformes d’échange

Interrogez les logs ERC-20 Transfer de l’adresse de dépôt. Définissez TOKEN_CONTRACT et RECIPIENT à partir d’une configuration fiable ; FROM_BLOCK et TO_BLOCK sont des hauteurs hexadécimales dans la couverture du nœud et la limite publiée. Avancez le curseur persistant uniquement après traitement de chaque intervalle.

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

Résultat à vérifier

Vérifiez contrat, destinataire et montant entier, puis le receipt et votre politique de confirmations avant de créditer. Dédupliquez par chaîne, transactionHash et logIndex ; conservez blockHash pour rapprocher les réorganisations.

Lire le guide complet

Recevoir les avis de paiement des commerçants

Définissez RECIPIENT et RECEIVER_URL, puis créez un abonnement d’adresse de base avec les confirmations par défaut. Conservez le secret de manière sûre. Attendez applied_version >= change_version et notez applied_from_block avant d’attendre une activité correspondante.

Chaînes prises en charge

Choisissez CHAIN pour cet exemple parmi les chaînes actuellement utilisables ci-dessous

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"

Résultat à vérifier

Le premier événement correspondant compte après vérification de la signature du body brut, contrôle du token/destinataire/montant entier, déduplication persistante par id et réponse 2xx du récepteur. HTTP 201 de l’abonnement n’est pas un avis de paiement reçu.

Lire le guide complet

Suivre les paiements sortants

Définissez TX_HASH comme une transaction déjà envoyée par votre système de paiement. Lisez son receipt via JSON-RPC, comparez receipt.blockNumber à la tête actuelle et rapprochez les logs du transfert attendu.

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

Résultat à vérifier

Un receipt null ou une transaction pending ne signifie pas un paiement reçu. Vérifiez receipt.status, contrat du token, destinataire, montant entier et politique de confirmations. Un receipt réussi ne prouve pas seul le transfert attendu.

Lire le guide complet

Limites des confirmations et de la couverture

N confirmations ne sont pas la finalité de la chaîne. Push de base n’a pas de filtres de montant ou de token côté serveur ; filtrez dans le récepteur. Les transferts de monnaie native internes aux contrats ne sont pas couverts. Pending n’est pas un paiement reçu. Rapprochez les blocs remplacés lors de chain.reorg et traitez les remplacements canoniques de façon idempotente. Certaines chaînes ne couvrent pas les transactions système ; consultez la page de la chaîne correspondante.

Récupérer les lacunes et rapprocher l’historique

Replay renvoie uniquement les correspondances conservées ; il ne récupère pas l’historique antérieur à l’activation de l’abonnement ou de l’adresse. Utilisez des requêtes RPC bornées pour ces intervalles ou lacunes. Gardez un curseur par chaîne et suivez le guide complet pour les réorganisations.

Lire le guide complet

Vous pouvez consulter les transferts ERC-20 indexés sur les chaînes ci-dessous. FROM_BLOCK et TO_BLOCK sont des hauteurs décimales dans la couverture indexée. Vérifiez fraîcheur et couverture et suivez next_cursor jusqu’à son absence. Vérifiez contrat, destinataire et montant entier ; les données indexées ne prouvent pas la finalité.

: "${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"
Lire le guide complet

Tarification et règles de facturation

Poids de méthode eth_getLogs : 30 CU ($3.00 pour 1,000,000 de requêtes).

Les requêtes rejetées par le service (intervalle de blocs dépassé ou limitation de débit) ne sont pas facturées. Consultez le guide de facturation ou la grille tarifaire complète.

Notifications webhook

Poids CU issus de GET /v1/plans. Les nouvelles tentatives automatiques sont gratuites.

Adresses gratuites par compte et par jour UTC : 1000

Le quota gratuit d’adresses par compte et par jour UTC est partagé par tous les groupes d’abonnement, quel que soit le forfait. Pour chaque groupe, on compte son nombre maximal d’adresses pendant ses périodes en ligne ce jour-là ; le quota est réparti par ID de groupe croissant. Une même adresse dans deux groupes compte deux fois ; le nombre de chaînes d’un groupe ne multiplie pas son nombre d’adresses. Un groupe hors ligne ou supprimé toute la journée ne contribue pas au décompte. Pour chaque groupe, le nombre restant après déduction de sa part du quota est multiplié par le poids CU `push.address_day` dans `method_weights`. Le quota actuellement configuré provient de la même politique tarifaire que la facturation des adresses-jours ; ce n’est ni une limite de capacité du compte ni un quota distinct par groupe.

MéthodeUnité de facturationCU
push.address_dayJour d’adresse facturable33
push.historyRequête d’historique réussie25
push.logÉvénement de données livré150
push.native_transferÉvénement de données livré150
push.token_transferÉvénement de données livré150

Démarrer le suivi