本文へスキップ

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 を記録してから一致する活動を待ちます。

対応チェーン

この例の 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

決済監視を開始する