본문으로 건너뛰기

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

결제 모니터링 시작