지갑 활동과 토큰 전송을 위한 블록체인 Webhook API

주소 Webhook은 감시 대상 지갑의 전송과 일치하는 컨트랙트 로그를 HTTPS 수신 엔드포인트로 전송합니다. 결제 입금 처리 전에 서명 검증, 중복 제거 및 누락을 처리하세요.

주소 적용 시작 블록 이전의 이벤트는 별도로 백필해야 하며 replay로 복구할 수 없습니다. 내부 네이티브 전송은 포함되지 않습니다. 확인 수는 GET /v1/push/chains가 반환하는 체인별 범위 내에서 지정하며, safe 또는 finalized 태그가 아닌 블록 수로 계산합니다.

API 키 발급 Webhook 연동 가이드(영어)

주소 활동을 수신 엔드포인트로 전달

native.transfer는 최상위 트랜잭션의 네이티브 코인 전송을, token.transfer는 ERC-20, ERC-721, ERC-1155 전송을 전달합니다. 다른 로그는 발행 컨트랙트 또는 topics[1]–topics[3]에 감시 주소가 있으면 log로 전달됩니다.

GET /v1/push/chains는 현재 지원하는 체인과 확인 수 범위를 반환합니다. 구독 체인을 선택하기 전에 API key로 조회하세요.

하나의 구독으로 여러 체인을 지원하며 수신 URL은 하나입니다. 개발자와 AI Agent는 동일한 용량 옵션과 요금을 이용합니다.

셀프서비스

구독당 최대 1,000,000개 주소. 가입 후 바로 이용할 수 있습니다.

표준 사용량 요금

엔터프라이즈

구독당 10,000,000 / 100,000,000개 주소.

활성화 문의

두 옵션 모두 동일한 주소일 및 전달된 이벤트 단가를 적용합니다.

지갑과 컨트랙트 활동 활용

지갑 활동

지갑 주소를 감시하고 네이티브 코인과 토큰의 입출금 이벤트를 받으세요.

스테이블코인 입금

ERC-20 USDT / USDC 전송을 받은 뒤 토큰 컨트랙트, 수신 주소, 정수 금액을 검증하고 입금을 처리하세요.

컨트랙트 이벤트

컨트랙트 주소의 로그나 topics[1]–topics[3]에 감시 주소가 포함된 로그를 받으세요.

NFT 전송

token_id로 ERC-721 및 ERC-1155 전송을 처리하세요. 일괄 전송에는 batch_index도 포함됩니다.

USDT / USDC 입금 모니터링

이벤트 검증, 확인 및 복구

이벤트를 처리하기 전에 구독 시크릿으로 `webhook-id.webhook-timestamp.raw-body`의 HMAC-SHA256 서명을 검증하세요. 먼저 JSON을 파싱하지 말고 원본 요청 본문을 사용하세요.
이벤트는 최소 한 번 전달됩니다. 이벤트 id로 중복을 제거하고 처리 결과를 영구 저장한 후 2xx를 반환하세요. 구독이 online 상태이고 이벤트가 보존 기간 안에 있으면 실패한 전달을 재시도합니다.
GET /v1/push/chains의 범위 내에서 체인별 confirmations를 설정하세요. chain.reorg는 전달된 블록의 교체를 알립니다. ref로 이전 이벤트를 표시하고, 자동 재전달된 정규 체인 이벤트를 보관하며 id로 중복을 제거하세요.
Replay는 재전송 가능한 범위의 저장된 일치 이벤트를 다시 전달합니다. 주소나 체인을 구독에 추가하기 전의 활동은 가져오지 않습니다.

요금

표의 CU 가중치와 무료 주소 할당량은 GET /v1/plans에서 가져옵니다. 데이터 이벤트는 전달별로 과금하며 자동 재시도와 제어 이벤트는 무료입니다. replay 재전송에는 이벤트 요금이 적용됩니다.

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

요금

수신 엔드포인트 연결

Webhook 연동 가이드(영어)스테이블코인 입금 가이드(영어)API 키 발급