Giám sát nạp tiền và chi trả USDT / USDC
Giám sát các chuyển khoản USDT và USDC được hỗ trợ cho nạp tiền, thông báo người bán và chi trả; thông báo riêng lẻ không cấu thành quyết toán cuối cùng.
Dành cho nhà phát triển và AI Agent. Bắt đầu với khóa API và bộ nhận HTTPS của bạn; lọc hợp đồng token và số tiền trong ứng dụng.
Giám sát chuyển tiền cơ bản đã khả dụngViệc lọc số tiền và token được thực hiện tại bộ nhận của bạn. Điều kiện phía máy chủ, xác nhận nhiều giai đoạn và cảnh báo IM sẽ sớm ra mắt.
Trước khi bắt đầu
Nhà phát triển và AI Agent sử dụng cùng quy trình tích hợp. Đặt BLOCKVECTRA_API_KEY an toàn, cài curl và jq. Chọn CHAIN từ phạm vi bên dưới; kiểm tra hợp đồng token, người nhận và số tiền nguyên theo đơn vị nhỏ nhất. Push cần bộ nhận HTTPS của bạn qua HTTPS port 443. Trước khi tạo đăng ký, kiểm tra danh sách chuỗi có xác thực, khoảng số xác nhận và trạng thái halted.
Xem hướng dẫn đăng ký tự động (programmatic) →Xác minh tiền nạp sàn
Thăm dò log ERC-20 Transfer của địa chỉ nạp. Đặt TOKEN_CONTRACT và RECIPIENT từ cấu hình đáng tin; FROM_BLOCK và TO_BLOCK là độ cao khối hệ thập lục phân trong phạm vi nút và giới hạn công bố. Chỉ tiến con trỏ bền vững sau khi xử lý từng khoảng.
Chuỗi được hỗ trợ
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 @-Kết quả cần xác minh
Đối chiếu hợp đồng, người nhận và số tiền nguyên; kiểm tra receipt và chính sách xác nhận trước khi ghi có. Loại trùng theo chuỗi, transactionHash và logIndex; giữ blockHash để đối chiếu tái tổ chức.
Đọc hướng dẫn đầy đủNhận thông báo thu tiền cho người bán
Đặt RECIPIENT và RECEIVER_URL, tạo đăng ký địa chỉ cơ bản với số xác nhận mặc định của chuỗi. Lưu secret an toàn. Đợi applied_version >= change_version và ghi applied_from_block trước khi chờ hoạt động khớp.
Chuỗi được hỗ trợ
- Arbitrum One — Hiện có thể thực thi
- Base — Hiện có thể thực thi
- BNB Smart Chain — Hiện có thể thực thi
- Ethereum — Hiện có thể thực thi
- Ethereum Sepolia — Hiện có thể thực thi
- HyperEVM — Hiện có thể thực thi
- Polygon — Hiện có thể thực thi
- Robinhood Chain — Hiện có thể thực thi
- Robinhood Chain Testnet — Hiện có thể thực thi
Chọn CHAIN cho ví dụ này từ các chuỗi hiện có thể thực thi bên dưới
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"Kết quả cần xác minh
Sự kiện khớp đầu tiên chỉ hoàn thành sau khi xác minh chữ ký body gốc, kiểm tra token/người nhận/số tiền nguyên, loại trùng bền vững theo id và bộ nhận trả 2xx. HTTP 201 của đăng ký không phải thông báo thu tiền đã nhận.
Đọc hướng dẫn đầy đủTheo dõi chi trả
Đặt TX_HASH thành giao dịch hệ thống thanh toán đã gửi. Đọc receipt bằng JSON-RPC, so sánh receipt.blockNumber với đầu chuỗi hiện tại và đối chiếu log chuyển token dự kiến.
Chuỗi được hỗ trợ
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 @-Kết quả cần xác minh
receipt null hoặc giao dịch pending không phải tiền đã nhận. Kiểm tra receipt.status, hợp đồng token, người nhận, số tiền nguyên và chính sách xác nhận. receipt thành công tự nó không chứng minh chuyển tiền dự kiến.
Đọc hướng dẫn đầy đủGiới hạn xác nhận và phạm vi
N xác nhận không phải tính chung cuộc của chuỗi. Push cơ bản không lọc số tiền hoặc token phía máy chủ; lọc ở bộ nhận. Không hỗ trợ chuyển coin gốc nội bộ hợp đồng. Pending không phải tiền đã nhận. Đối chiếu khối thay thế khi chain.reorg và xử lý sự kiện chuẩn thay thế theo tính lũy đẳng. Một số chuỗi không bao phủ giao dịch hệ thống; xem trang của chuỗi tương ứng.
Khôi phục khoảng trống và đối chiếu lịch sử
Replay chỉ gửi lại sự kiện khớp còn lưu; không bổ sung lịch sử trước khi đăng ký hoặc địa chỉ có hiệu lực. Dùng thăm dò RPC có giới hạn cho khoảng trước đó hoặc khoảng trống. Giữ con trỏ theo chuỗi và đối chiếu tái tổ chức theo hướng dẫn đầy đủ.
Chuỗi được hỗ trợ
Có thể truy vấn chuyển ERC-20 được lập chỉ mục trên các chuỗi bên dưới. FROM_BLOCK và TO_BLOCK là độ cao khối thập phân trong phạm vi chỉ mục. Kiểm tra độ mới và phạm vi, theo next_cursor tới khi trường không còn. Xác minh hợp đồng, người nhận và số tiền nguyên; dữ liệu chỉ mục không chứng minh tính chung cuộc.
Chuỗi được hỗ trợ
: "${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"Quy tắc giá và thanh toán
Trọng số phương thức eth_getLogs: 30 CU ($3.00 trên 1,000,000 yêu cầu).
Các yêu cầu bị dịch vụ từ chối (như vượt quá khoảng khối hoặc giới hạn tốc độ) không bị tính phí. Xem hướng dẫn quy tắc thanh toán hoặc bảng giá đầy đủ.
Thông báo webhook
Trọng số CU từ GET /v1/plans. Thử lại tự động miễn phí.
Địa chỉ miễn phí mỗi tài khoản mỗi ngày UTC: 1000
Hạn mức địa chỉ miễn phí mỗi tài khoản mỗi ngày UTC được chia sẻ giữa tất cả các nhóm đăng ký, bất kể gói dịch vụ. Với mỗi nhóm, tính số địa chỉ tối đa trong thời gian trực tuyến của ngày đó; phân bổ hạn mức theo ID nhóm tăng dần. Cùng một địa chỉ trong hai nhóm được tính hai lần; số chuỗi trong nhóm không nhân số địa chỉ. Nhóm ngoại tuyến hoặc đã bị xóa suốt cả ngày không đóng góp vào số đếm. Với mỗi nhóm, số còn lại sau khi trừ phần hạn mức được phân bổ được nhân với trọng số CU `push.address_day` trong `method_weights`. Hạn mức cấu hình hiện tại đến từ cùng chính sách giá dùng cho phí địa chỉ-ngày; đây không phải giới hạn dung lượng tài khoản hay hạn mức riêng cho từng nhóm.
| Phương thức | Đơn vị tính phí | CU |
|---|---|---|
| push.address_day | Ngày địa chỉ tính phí | 33 |
| push.history | Yêu cầu lịch sử thành công | 25 |
| push.log | Sự kiện dữ liệu đã gửi | 150 |
| push.native_transfer | Sự kiện dữ liệu đã gửi | 150 |
| push.token_transfer | Sự kiện dữ liệu đã gửi | 150 |