Chuyển đến nội dung chính

API Webhook blockchain cho hoạt động ví và chuyển token

Webhook địa chỉ gửi các giao dịch chuyển tiền của ví được theo dõi và log hợp đồng khớp đến đầu nhận HTTPS; xác minh chữ ký, loại bỏ trùng lặp sự kiện và xử lý khoảng trống trước khi ghi nhận thanh toán.

Sự kiện trước khối có hiệu lực của địa chỉ cần được truy vấn lịch sử riêng; replay không khôi phục được chúng. Không bao gồm chuyển coin gốc nội bộ. Số xác nhận phải nằm trong phạm vi của từng chuỗi do GET /v1/push/chains trả về và được tính theo số khối, không theo nhãn safe hoặc finalized.

Gửi hoạt động địa chỉ đến endpoint của bạn

native.transfer gửi giao dịch chuyển đồng gốc ở cấp cao nhất; token.transfer gửi chuyển ERC-20, ERC-721 và ERC-1155. log gửi các log khác có địa chỉ theo dõi là hợp đồng phát log hoặc nằm trong topics[1]–topics[3].

GET /v1/push/chains trả về các chuỗi hiện được hỗ trợ và giới hạn số xác nhận. Gọi với API key trước khi chọn chuỗi cho đăng ký.

Một đăng ký bao phủ nhiều chuỗi với một URL nhận. Nhà phát triển và AI Agent có cùng lựa chọn dung lượng và giá.

Tự phục vụ

Tối đa 1,000,000 địa chỉ cho mỗi đăng ký. Dùng ngay sau khi tạo tài khoản.

Đơn giá tiêu chuẩn theo mức sử dụng

Doanh nghiệp

10,000,000 / 100,000,000 địa chỉ cho mỗi đăng ký.

Liên hệ để kích hoạt

Cả hai lựa chọn dùng cùng đơn giá địa chỉ-ngày và sự kiện đã giao.

Sử dụng hoạt động ví và hợp đồng

Hoạt động ví

Theo dõi địa chỉ ví để nhận sự kiện chuyển đồng gốc và token vào hoặc ra.

Thanh toán stablecoin

Nhận chuyển ERC-20 USDT / USDC, rồi kiểm tra hợp đồng token, địa chỉ nhận và số tiền nguyên trước khi ghi nhận thanh toán.

Sự kiện hợp đồng

Theo dõi địa chỉ hợp đồng để nhận log của nó, hoặc nhận log chứa địa chỉ theo dõi trong topics[1]–topics[3].

Chuyển NFT

Xử lý chuyển ERC-721 và ERC-1155 bằng token_id và batch_index với chuyển theo lô.

Giám sát thanh toán USDT / USDC

Xác minh, xác nhận và khôi phục sự kiện

  • Xác minh chữ ký HMAC-SHA256 trên `webhook-id.webhook-timestamp.raw-body` bằng bí mật của đăng ký trước khi xử lý sự kiện; sử dụng nội dung yêu cầu gốc và không phân tích cú pháp JSON trước.
  • Sự kiện được gửi ít nhất một lần. Loại trùng theo id sự kiện và trả về 2xx sau khi lưu bền vững kết quả xử lý. Yêu cầu gửi thất bại được thử lại khi đăng ký online và sự kiện còn trong thời hạn lưu giữ.
  • Đặt confirmations cho từng chuỗi trong giới hạn của GET /v1/push/chains. chain.reorg thông báo các khối đã gửi bị thay thế: đánh dấu sự kiện cũ theo ref, giữ các sự kiện của chuỗi chính được tự động gửi lại và loại trùng theo id.
  • Replay gửi lại sự kiện khớp đã lưu trong khoảng có thể phát lại. Nó không lấy hoạt động trước khi địa chỉ hoặc chuỗi được thêm vào đăng ký.

Bảng giá

Bảng lấy trọng số CU và hạn mức địa chỉ miễn phí từ GET /v1/plans. Sự kiện dữ liệu tính phí theo lần gửi; thử lại tự động và sự kiện điều khiển miễn phí. Gửi lại qua replay tính phí theo giá sự kiện.

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_dayNgày địa chỉ tính phí33
push.historyYêu cầu lịch sử thành công25
push.logSự kiện dữ liệu đã gửi150
push.native_transferSự kiện dữ liệu đã gửi150
push.token_transferSự kiện dữ liệu đã gửi150
Bảng giá

Kết nối endpoint nhận