USDT / USDC-Einzahlungen und Auszahlungen überwachen
Überwachen Sie unterstützte USDT- und USDC-Transfers für Einzahlungen, Händlerbenachrichtigungen und Auszahlungen; eine Benachrichtigung allein stellt keine endgültige Abrechnung dar.
Für Entwickler und AI Agents. Starte mit deinem API-Schlüssel und deinem HTTPS-Empfänger; filtere Token-Verträge und Beträge in deiner Anwendung.
Grundlegende Transferüberwachung ist verfügbarBeträge und Token werden in deinem Empfänger gefiltert. Serverseitige Bedingungen, mehrere Bestätigungsstufen und IM-Benachrichtigungen folgen in Kürze.
Vor dem Start
Entwickler und AI Agent nutzen denselben Integrationsablauf. Setze BLOCKVECTRA_API_KEY sicher und installiere curl und jq. Wähle CHAIN aus der Abdeckung unten; prüfe Tokenvertrag, Empfänger und ganzzahligen Betrag in kleinsten Einheiten. Push benötigt deinen eigenen HTTPS-Empfänger auf Port 443. Prüfe vor dem Anlegen die authentifizierte Chain-Liste, den Bestätigungsbereich und halted.
Leitfaden zur programmatischen Registrierung ansehen →Börseneinzahlungen prüfen
Frage ERC-20 Transfer-Logs für die Einzahlungsadresse ab. Setze TOKEN_CONTRACT und RECIPIENT aus vertrauenswürdiger Konfiguration; FROM_BLOCK und TO_BLOCK sind hexadezimale Blockhöhen innerhalb der Node-Abdeckung und des veröffentlichten Limits. Aktualisiere den dauerhaften Cursor erst nach Verarbeitung jedes Bereichs.
Unterstützte Chains
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 @-Zu prüfendes Ergebnis
Prüfe Vertrag, Empfänger und ganzzahligen Betrag sowie receipt und deine Bestätigungspolitik vor der Gutschrift. Dedupliziere nach Chain, transactionHash und logIndex; speichere blockHash zum Abgleich von Reorganisationen.
Vollständige Anleitung lesenHändler-Zahlungsbenachrichtigungen empfangen
Setze RECIPIENT und RECEIVER_URL und erstelle ein einfaches Adressabonnement mit den Standardbestätigungen der Chain. Speichere das secret sicher. Warte auf applied_version >= change_version und notiere applied_from_block, bevor du passende Aktivität erwartest.
Unterstützte Chains
- Arbitrum One — Derzeit ausführbar
- Base — Derzeit ausführbar
- BNB Smart Chain — Derzeit ausführbar
- Ethereum — Derzeit ausführbar
- Ethereum Sepolia — Derzeit ausführbar
- HyperEVM — Derzeit ausführbar
- Polygon — Derzeit ausführbar
- Robinhood Chain — Derzeit ausführbar
- Robinhood Chain Testnet — Derzeit ausführbar
Wähle CHAIN für dieses Beispiel aus den unten aufgeführten, derzeit ausführbaren Chains
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"Zu prüfendes Ergebnis
Das erste passende Ereignis zählt erst nach Signaturprüfung des ursprünglichen body, Token-/Empfänger-/Ganzzahlbetragsprüfung, dauerhafter Deduplizierung nach id und einer 2xx-Antwort des Empfängers. HTTP 201 beim Anlegen ist keine zugestellte Zahlungsbenachrichtigung.
Vollständige Anleitung lesenAuszahlungen verfolgen
Setze TX_HASH auf eine bereits von deinem Zahlungssystem übermittelte Transaktion. Lies das receipt mit JSON-RPC, vergleiche receipt.blockNumber mit dem aktuellen Head und prüfe die erwarteten Token-Transfer-Logs.
Unterstützte Chains
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 @-Zu prüfendes Ergebnis
Ein null-receipt oder eine pending-Transaktion bedeutet keinen Zahlungseingang. Prüfe receipt.status, Tokenvertrag, Empfänger, ganzzahligen Betrag und Bestätigungspolitik. Ein erfolgreiches receipt allein beweist den erwarteten Transfer nicht.
Vollständige Anleitung lesenBestätigungs- und Abdeckungsgrenzen
N Bestätigungen sind keine Chain-Finalität. Einfaches Push bietet keine serverseitigen Betrags- oder Tokenfilter; filtere im Empfänger. Vertragsinterne native Transfers sind nicht abgedeckt. Pending ist kein Zahlungseingang. Gleiche bei chain.reorg ersetzte Blöcke ab und verarbeite kanonische Ersetzungen idempotent. Einige Chains decken Systemtransaktionen nicht ab; siehe die jeweilige Chain-Seite.
Lücken schließen und Historie abgleichen
Replay sendet nur gespeicherte Treffer erneut; es ergänzt keine Historie vor Aktivierung des Abonnements oder der Adresse. Nutze begrenztes RPC-Polling für frühere Intervalle oder Lücken. Führe je Chain einen Cursor und gleiche Reorganisationen gemäß vollständiger Anleitung ab.
Unterstützte Chains
Optional kannst du indexierte ERC-20-Transfers auf den folgenden Chains abfragen. FROM_BLOCK und TO_BLOCK sind dezimale Blockhöhen innerhalb der Indexabdeckung. Prüfe Aktualität und Abdeckung und folge next_cursor bis das Feld fehlt. Prüfe Tokenvertrag, Empfänger und ganzzahligen Betrag; Indexdaten beweisen keine Finalität.
Unterstützte Chains
: "${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"Preise und Abrechnungsregeln
eth_getLogs Methodengewicht: 30 CU ($3.00 pro 1,000,000 Anfragen).
Vom Dienst abgelehnte Anfragen (z. B. zu großer Blockbereich oder Ratenlimit) werden nicht berechnet. Siehe Abrechnungsregeln oder vollständige Preistabelle.
Webhook-Push
CU-Gewichte aus GET /v1/plans. Automatische Wiederholungen sind kostenlos.
Kostenlose Adressen pro Konto und UTC-Tag: 1000
Das kostenlose Adresskontingent pro Konto und UTC-Tag wird unabhängig vom Tarif von allen Abonnementgruppen geteilt. Für jede Gruppe zählt die maximale Adressanzahl während ihrer Online-Zeit an diesem Tag; das Kontingent wird in aufsteigender Gruppen-ID-Reihenfolge verteilt. Dieselbe Adresse in zwei Gruppen zählt zweimal; die Anzahl der Chains einer Gruppe vervielfacht ihre Adressanzahl nicht. Eine Gruppe, die den gesamten Tag offline oder gelöscht ist, trägt nichts bei. Für jede Gruppe wird die nach Abzug ihres Kontingentanteils verbleibende Anzahl mit dem CU-Gewicht `push.address_day` in `method_weights` multipliziert. Das aktuell konfigurierte Kontingent stammt aus derselben Preispolitik wie die Adresstaggebühr; es ist weder ein Kapazitätslimit des Kontos noch ein separates Kontingent pro Gruppe.
| Methode | Abrechnungseinheit | CU |
|---|---|---|
| push.address_day | Abrechenbarer Adresstag | 33 |
| push.history | Erfolgreiche Verlaufsabfrage | 25 |
| push.log | Zugestelltes Datenereignis | 150 |
| push.native_transfer | Zugestelltes Datenereignis | 150 |
| push.token_transfer | Zugestelltes Datenereignis | 150 |