İçeriğe atla

USDT / USDC Yatırmalarını ve Ödemelerini İzleyin

Yatırma işlemleri, satıcı bildirimleri ve ödemeler için desteklenen USDT ve USDC transferlerini izleyin; tek başına bildirim nihai ödeme mutabakatını kanıtlamaz.

Geliştiriciler ve AI Agent için. API anahtarınız ve kendi HTTPS alıcınızla başlayın; token sözleşmelerini ve tutarları uygulamanızda filtreleyin.

Temel transfer izleme kullanılabilir

Tutar ve token filtreleme alıcınızda yapılır. Sunucu tarafı koşullar, çok aşamalı onaylar ve IM uyarıları yakında sunulacak.

Başlamadan önce

Geliştiriciler ve AI Agent aynı entegrasyon akışını kullanır. BLOCKVECTRA_API_KEY değerini güvenle ayarlayın, curl ve jq kurun. Aşağıdaki kapsamdan CHAIN seçin; token sözleşmesini, alıcıyı ve en küçük birimdeki tam sayı tutarı doğrulayın. Push için 443 portunda kendi HTTPS alıcınız gerekir. Abonelik oluşturmadan önce kimlik doğrulamalı zincir listesini, onay aralığını ve halted durumunu kontrol edin.

Programatik kayıt rehberini görün →

Borsa yatırımlarını doğrulayın

Yatırım adresinin ERC-20 Transfer günlüklerini sorgulayın. TOKEN_CONTRACT ve RECIPIENT değerlerini güvenilir yapılandırmadan alın; FROM_BLOCK ve TO_BLOCK, düğüm kapsamı ve yayımlanan sınır içinde onaltılık blok yükseklikleri olmalıdır. Kalıcı imleci yalnızca her aralığı işledikten sonra ilerletin.

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

Doğrulanacak sonuç

Sözleşme, alıcı ve tam sayı tutarı eşleştirin; hesaba geçmeden önce receipt ve onay politikanızı doğrulayın. Zincir, transactionHash ve logIndex ile tekilleştirin; yeniden düzenleme kontrolü için blockHash saklayın.

Tam kılavuzu okuyun

İş yeri ödeme bildirimleri alın

RECIPIENT ve RECEIVER_URL ayarlayın; zincirin varsayılan onaylarıyla temel adres aboneliği oluşturun. Dönen secret değerini güvenle saklayın. applied_version >= change_version olmasını bekleyip applied_from_block kaydedin, ardından eşleşen etkinliği bekleyin.

Desteklenen zincirler

Bu örnek için CHAIN değerini aşağıdaki şu anda çalıştırılabilir zincirlerden seçin

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"

Doğrulanacak sonuç

İlk eşleşen olay ancak ham body imza doğrulaması, token/alıcı/tam sayı tutar kontrolü, id ile kalıcı tekilleştirme ve alıcının 2xx yanıtından sonra tamamlanır. Abonelik HTTP 201 yanıtı, ödeme bildiriminin teslim edildiği anlamına gelmez.

Tam kılavuzu okuyun

Çıkış ödemelerini izleyin

TX_HASH değerini ödeme sisteminizin zaten gönderdiği işleme ayarlayın. JSON-RPC ile receipt okuyun; receipt.blockNumber ile güncel başlığı karşılaştırıp beklenen token transfer günlüklerini kontrol edin.

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

Doğrulanacak sonuç

null receipt veya pending işlem ödeme alındığı anlamına gelmez. receipt.status, token sözleşmesi, alıcı, tam sayı tutar ve onay politikasını doğrulayın. Başarılı receipt tek başına beklenen transferi kanıtlamaz.

Tam kılavuzu okuyun

Onay ve kapsam sınırları

N onay zincir kesinliği değildir. Temel Push sunucuda tutar veya token filtrelemez; alıcınızda filtreleyin. Sözleşme içi yerel coin transferleri kapsanmaz. Pending ödeme alındığı anlamına gelmez. chain.reorg durumunda değişen blokları karşılaştırıp kanonik yenilerini idempotent işleyin. Bazı zincirlerde sistem işlemleri kapsam dışındadır; ilgili zincir sayfasına bakın.

Boşlukları kurtarın ve geçmişi uzlaştırın

Replay yalnızca saklanan eşleşmeleri yeniden gönderir; abonelik veya adres etkinleşmeden önceki geçmişi tamamlamaz. Önceki aralıklar veya boşluklar için sınırlı RPC sorgulaması kullanın. Zincir başına imleç tutun ve tam kılavuzla yeniden düzenlemeleri kontrol edin.

Tam kılavuzu okuyun

İsteğe bağlı olarak aşağıdaki zincirlerde indekslenmiş ERC-20 transferlerini sorgulayın. FROM_BLOCK ve TO_BLOCK indeks kapsamındaki ondalık blok yükseklikleri olmalıdır. Güncellik ve kapsamı kontrol edin; next_cursor alanı kaybolana kadar sayfalayın. Her sözleşme, alıcı ve tam sayı tutarı doğrulayın; indeks verisi kesinlik kanıtı değildir.

: "${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"
Tam kılavuzu okuyun

Fiyatlandırma ve Faturalandırma Kuralları

eth_getLogs yöntem ağırlığı: 30 CU (1,000,000 istek başına $3.00).

Hizmet tarafından reddedilen istekler (örneğin blok aralığı aşımı veya hız sınırı) faturalandırılmaz. Faturalandırma kuralları rehberi veya tüm fiyatlandırma tablosu sayfasına bakın.

Webhook bildirimleri

CU ağırlıkları GET /v1/plans üzerinden alınır. Otomatik yeniden denemeler ücretsizdir.

Hesap başına UTC günü başına ücretsiz adres: 1000

Hesap başına UTC günü başına ücretsiz adres kotası, plandan bağımsız olarak tüm abonelik grupları tarafından paylaşılır. Her grup için o gün çevrimiçi olduğu süredeki en yüksek adres sayısı alınır; kota, grup kimliği artan sırada dağıtılır. Aynı adres iki grupta iki kez sayılır; gruptaki zincir sayısı adres sayısını katlamaz. Gün boyunca çevrimdışı veya silinmiş bir grup sayıma katkıda bulunmaz. Her grup için kota payı çıkarıldıktan sonra kalan sayı, `push.address_day` CU ağırlığı (`method_weights` içinde belirtilen) ile çarpılır. Mevcut yapılandırılmış kota, adres-gün ücretiyle aynı fiyatlandırma politikasından gelir; hesap kapasitesi sınırı veya grup başına ayrı bir kota değildir.

YöntemFaturalama birimiCU
push.address_dayFaturalanabilir adres-gün33
push.historyBaşarılı geçmiş isteği25
push.logTeslim edilen veri olayı150
push.native_transferTeslim edilen veri olayı150
push.token_transferTeslim edilen veri olayı150

İzlemeye Başlayın