监控 USDT / USDC 充值与出款
监控受支持的 USDT 与 USDC 转账,用于充值核验、商户通知和出款追踪;通知本身不证明最终结算。
面向开发者与 AI Agent。先准备 API key 与自有 HTTPS 接收端,在应用中筛选代币合约与金额。
基础转账监控已可用金额与代币筛选在你的接收端执行。服务端条件、多阶段确认与 IM 提醒即将推出。
开始前的准备
开发者与 AI Agent 使用同一套接入流程。 安全设置 BLOCKVECTRA_API_KEY,安装 curl 和 jq。从下方任务支持范围选择 CHAIN,核验该链代币合约、收款方及最小单位的整数金额。Push 需要自有 HTTPS 接收端与 443 端口;创建订阅前核对认证链目录、确认数范围和 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 @-需要核验的结果
receipt 为 null 或交易处于 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(每 100 万次请求 $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 |