USDT / USDC の入金と出金を監視
入金、店舗通知、出金追跡のために対応する USDT および USDC の送金を監視します。通知単体では最終的な決済を証明しません。
開発者と AI Agent 向け。API キーと独自の HTTPS 受信エンドポイントを用意し、アプリケーションでトークンコントラクトと金額を絞り込みます。
基本的な送金監視は利用可能です金額とトークンのフィルタリングは受信側で行います。サーバー側の条件、複数段階の確認、IM 通知は近日提供予定です。
開始前の準備
開発者と AI Agent は同じ接続手順を使用します。 BLOCKVECTRA_API_KEY を安全に設定し、curl と jq をインストールします。以下の対応範囲から CHAIN を選び、そのチェーンのトークンコントラクト、受取先、最小単位の整数金額を検証します。Push にはポート 443 の自前の HTTPS 受信エンドポイントが必要です。購読作成前に認証付きチェーン一覧、確認数範囲、halted 状態を確認してください。
プログラムによる登録ガイドを見る →取引所入金の検証
入金先の ERC-20 Transfer ログをポーリングします。信頼できる支払い設定から TOKEN_CONTRACT と RECIPIENT を設定し、FROM_BLOCK と TO_BLOCK をノードの対応範囲と公開上限内の十六進ブロック高に設定します。各範囲の処理後にのみ永続カーソルを進めます。
対応チェーン
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 @-検証する結果
コントラクト、受取先、整数金額を照合し、receipt と業務上の確認方針を検証してから入金を反映します。チェーン、transactionHash、logIndex で重複を排除し、再編照合用に blockHash を保存します。
完全なガイドを読む店舗への入金通知
RECIPIENT と RECEIVER_URL を設定し、チェーン既定の確認数で基本アドレス購読を作成します。返された secret を安全に保存します。applied_version >= change_version を待ち、applied_from_block を記録してから一致する活動を待ちます。
対応チェーン
- Arbitrum One — 現在実行可能
- Base — 現在実行可能
- BNB Smart Chain — 現在実行可能
- Ethereum — 現在実行可能
- Ethereum Sepolia — 現在実行可能
- HyperEVM — 現在実行可能
- Polygon — 現在実行可能
- Robinhood Chain — 現在実行可能
- Robinhood Chain Testnet — 現在実行可能
この例の CHAIN は、以下の現在実行可能なチェーンから選択してください
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"検証する結果
最初の一致イベントは、生 body の署名検証、トークン・受取先・整数金額の確認、イベント id による永続的な重複排除、受信側の 2xx 応答が完了して初めて成立します。購読の HTTP 201 は入金通知の受信ではありません。
完全なガイドを読む出金の追跡
TX_HASH を支払いシステムで送信済みのトランザクションに設定します。JSON-RPC で receipt を読み、receipt.blockNumber を現在の先頭と比較して、期待するトークン送金ログを照合します。
対応チェーン
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 @-検証する結果
null の receipt や pending の取引は入金を意味しません。receipt.status、トークンコントラクト、受取先、整数金額、確認方針を検証します。成功 receipt だけでは期待する送金を証明できません。
完全なガイドを読む確認と対応範囲の境界
N 回の確認はチェーンのファイナリティではありません。基本 Push にサーバー側の金額・トークンフィルターはなく、受信側で絞り込みます。コントラクト内部のネイティブ通貨送金は対象外です。Pending は入金ではありません。chain.reorg では置換ブロックを照合し、正規チェーンの置換イベントを冪等に処理します。 一部のチェーンではシステムトランザクションが対象外です。該当するチェーンのページを参照してください。
欠落の復旧と履歴の照合
Replay は保存された一致イベントのみ再送し、購読やアドレスの有効化前の履歴は補完しません。それ以前の区間や欠落には範囲を限定した RPC ポーリングを使います。チェーンごとにカーソルを保持し、完全なガイドに従って再編を照合します。
対応チェーン
必要に応じて以下のチェーンのインデックス済み ERC-20 送金を照会します。FROM_BLOCK と TO_BLOCK は対応範囲内の十進ブロック高に設定します。鮮度と対応範囲を確認し、next_cursor がなくなるまでページを取得します。各トークンコントラクト、受取先、整数金額を検証します。インデックスデータはファイナリティの証明ではありません。
対応チェーン
: "${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"料金と請求ルール
eth_getLogs メソッド重み:30 CU(1,000,000 リクエストあたり $3.00)。
サービスによって拒否されたリクエスト(ブロック範囲超過やレート制限など)は課金されません。請求ルールガイド または 全料金表 をご確認ください。
Webhook プッシュ
CU ウェイトは GET /v1/plans から取得します。自動再試行は無料です。
アカウントごとの UTC 日あたりの無料アドレス数: 1000
アカウントごとの UTC 日あたりの無料アドレス枠は、プランに関係なくすべてのサブスクリプショングループで共有されます。各グループについて、その日にオンラインだった間の最大アドレス数を数え、グループ ID の昇順に枠を割り当てます。同じアドレスが二つのグループにある場合は二回数えます。グループ内のチェーン数によってアドレス数が倍増することはありません。一日中オフラインまたは削除済みのグループは数えません。各グループの割り当て枠を差し引いた残りの数に、`push.address_day` CU ウェイト(`method_weights` に記載)を掛けます。現在設定されている枠はアドレス日課金と同じ料金ポリシーに基づきます。アカウントの容量制限でも、グループごとの個別枠でもありません。
| メソッド | 課金単位 | CU |
|---|---|---|
| push.address_day | 課金対象のアドレス日 | 33 |
| push.history | 成功した履歴リクエスト | 25 |
| push.log | 配信済みデータイベント | 150 |
| push.native_transfer | 配信済みデータイベント | 150 |
| push.token_transfer | 配信済みデータイベント | 150 |