Zum Inhalt springen

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ügbar

Beträ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.

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 lesen

Hä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

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 lesen

Auszahlungen 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.

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 lesen

Bestä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.

Vollständige Anleitung lesen

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.

: "${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"
Vollständige Anleitung lesen

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.

MethodeAbrechnungseinheitCU
push.address_dayAbrechenbarer Adresstag33
push.historyErfolgreiche Verlaufsabfrage25
push.logZugestelltes Datenereignis150
push.native_transferZugestelltes Datenereignis150
push.token_transferZugestelltes Datenereignis150

Zahlungsüberwachung