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 disponibleLe 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.
Chaînes prises en charge
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 completRecevoir 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
- Arbitrum One — Exécutable maintenant
- Base — Exécutable maintenant
- BNB Smart Chain — Exécutable maintenant
- Ethereum — Exécutable maintenant
- Ethereum Sepolia — Exécutable maintenant
- HyperEVM — Exécutable maintenant
- Polygon — Exécutable maintenant
- Robinhood Chain — Exécutable maintenant
- Robinhood Chain Testnet — Exécutable maintenant
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 completSuivre 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.
Chaînes prises en charge
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 completLimites 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.
Chaînes prises en charge
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é.
Chaînes prises en charge
: "${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"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éthode | Unité de facturation | CU |
|---|---|---|
| push.address_day | Jour d’adresse facturable | 33 |
| push.history | Requête d’historique réussie | 25 |
| 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 |