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ılabilirTutar 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.
Desteklenen zincirler
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
- Arbitrum One — Şu anda çalıştırılabilir
- Base — Şu anda çalıştırılabilir
- BNB Smart Chain — Şu anda çalıştırılabilir
- Ethereum — Şu anda çalıştırılabilir
- Ethereum Sepolia — Şu anda çalıştırılabilir
- HyperEVM — Şu anda çalıştırılabilir
- Polygon — Şu anda çalıştırılabilir
- Robinhood Chain — Şu anda çalıştırılabilir
- Robinhood Chain Testnet — Şu anda çalıştırılabilir
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.
Desteklenen zincirler
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 okuyunOnay 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.
Desteklenen zincirler
İ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.
Desteklenen zincirler
: "${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"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öntem | Faturalama birimi | CU |
|---|---|---|
| push.address_day | Faturalanabilir adres-gün | 33 |
| push.history | Başarılı geçmiş isteği | 25 |
| push.log | Teslim edilen veri olayı | 150 |
| push.native_transfer | Teslim edilen veri olayı | 150 |
| push.token_transfer | Teslim edilen veri olayı | 150 |