Wallet API đang ở giai đoạn Beta. Các endpoint và định dạng phản hồi có thể thay đổi.
Tổng quan
Endpoint Wallet Funding Source xác định ai đã cấp vốn ban đầu cho một ví Solana bằng cách phân tích giao dịch chuyển SOL đến đầu tiên của ví đó. Endpoint này hữu ích cho việc định danh, tuân thủ, tìm hiểu mối quan hệ giữa các ví và xác định những ví được cấp vốn từ sàn giao dịch. Tên và danh mục của bên cấp vốn lấy từ cùng hệ thống định danh mà endpoint Identity sử dụng. Vì vậy, khi bên cấp vốn là một thực thể đã biết, phản hồi sẽ trực tiếp cung cấp nhãn và danh mục dễ đọc. Endpoint này yêu cầu gói trả phí. Các yêu cầu sử dụng khóa API của gói Free sẽ trả về403 Forbidden. Xem Yêu cầu về gói để biết bảng phạm vi hỗ trợ đầy đủ.
Khi nào nên sử dụng
Sử dụng Wallet Funding Source API để:- Định danh ví: theo dõi nguồn cấp vốn cho các ví mới.
- Phát hiện sàn giao dịch: xác định các ví được cấp vốn trực tiếp từ sàn giao dịch tập trung.
- Tuân thủ và AML: đánh dấu các ví được thực thể đã biết cấp vốn để kiểm tra tuân thủ.
- Phát hiện bot: xác định các cụm bot được cấp vốn từ cùng một nguồn.
- Phân tích airdrop: theo dõi những ví đã nhận vốn ban đầu từ một dự án.
- Phát hiện Sybil: tìm các cụm ví được cùng một địa chỉ cấp vốn.
Bắt đầu nhanh
Tra cứu nguồn cấp vốn cơ bản
Tìm hiểu ai đã cấp vốn cho một ví:- JavaScript
- Python
- cURL
Định dạng phản hồi
Phản hồi thành công mô tả giao dịch chuyển SOL đến đầu tiên của ví:Ghi chú về các trường
funder: địa chỉ đã gửi giao dịch chuyển SOL đầu tiên đến ví này.funderName: tên dễ đọc nếu bên cấp vốn là một thực thể đã biết (ví dụ: sàn giao dịch, giao thức); nếu không thì lànull.funderType: danh mục của bên cấp vốn (ví dụ:exchange,defi-protocol); lànullnếu không có trong cơ sở dữ liệu định danh.mint: địa chỉ đúc token (So11111111111111111111111111111111111111111đối với SOL).symbol: ký hiệu token (luôn làSOLđối với giao dịch cấp vốn).amount: lượng SOL ban đầu đã nhận (dạng dễ đọc, ví dụ:0.05SOL).amountRaw: số lượng thô tính bằng lamport dưới dạng chuỗi (ví dụ:"50000000"tương ứng với 0,05 SOL).decimals: số chữ số thập phân của token (9 đối với SOL).date: chuỗi ngày được định dạng theo ISO 8601 (ví dụ:"2024-01-01T00:00:00.000Z").signature: chữ ký giao dịch của lần chuyển tiền cấp vốn.timestamp: dấu thời gian Unix (tính bằng giây) khi ví được cấp vốn.slot: số slot Solana khi giao dịch cấp vốn được xác nhận.explorerUrl: liên kết trực tiếp để xem giao dịch trên Orb.
Trường hợp sử dụng
Phát hiện ví được cấp vốn từ sàn giao dịch
Xác định các ví được cấp vốn trực tiếp từ sàn giao dịch tập trung:Tìm cụm ví (phát hiện Sybil)
Xác định các nhóm ví được cấp vốn từ cùng một nguồn:Theo dõi người nhận airdrop
Phân tích nguồn gốc của những người nhận airdrop:Xây dựng dòng thời gian của ví
Tạo dòng thời gian bắt đầu từ lúc ví được tạo:Chấm điểm rủi ro tuân thủ
Gán điểm rủi ro dựa trên nguồn cấp vốn:Theo dõi định danh
Theo dõi những nguồn đang tạo ra nhiều ví mới nhất:Loại bên cấp vốn
TrườngfunderType cho biết danh mục của ví đã cấp vốn cho địa chỉ. Hệ thống hỗ trợ tất cả giá trị trong Danh mục định danh.
Supported funder types
Supported funder types
Các loại bên cấp vốn phổ biến:
Danh sách đầy đủ bao gồm: Airdrop, Cơ quan có thẩm quyền, Cầu nối chuỗi chéo, Sòng bạc & cờ bạc, DAO, DeFi, DePIN, Sàn giao dịch tập trung, Kẻ khai thác/Lừa đảo/Tấn công, Phí, Gây quỹ, Trò chơi, Phân phối khối Genesis, Quản trị, Tin tặc, Jito, Người có ảnh hưởng chính, Nhà tạo lập thị trường, Memecoin, Đa chữ ký, NFT, Nguồn cung không lưu hành, Oracle, Khác, Thanh toán, AMM độc quyền, Restaking, Kẻ rút thanh khoản, Kẻ lừa đảo, Thư rác, Nhóm staking, Hệ thống, Công cụ, Ứng dụng/Bot giao dịch, Công ty giao dịch, Gửi giao dịch, Ngân quỹ, Trình xác thực, Kho lưu trữ và X402.Xem phần Danh mục định danh để biết danh sách đầy đủ kèm mô tả.
Phương pháp hay nhất
- Xử lý phản hồi 404. Những ví chưa từng nhận SOL sẽ trả về mã 404. Đây là hành vi bình thường đối với ví mới tạo nhưng chưa được cấp vốn.
- Kết hợp với Identity API. Phản hồi bao gồm
funderNamevàfunderType, nhưng bạn có thể gọi endpoint Identity cho địa chỉfunderđể biết thêm chi tiết. - Lưu dữ liệu cấp vốn vào bộ nhớ đệm. Nguồn cấp vốn của ví không bao giờ thay đổi. Hãy lưu vĩnh viễn dữ liệu này vào bộ nhớ đệm để tránh gọi API nhiều lần.
- Kiểm tra tuổi ví để có thêm ngữ cảnh.
timestampcho biết thời điểm ví được cấp vốn lần đầu. Kết hợp tuổi ví với nguồn cấp vốn để có ngữ cảnh rõ hơn.
Lỗi thường gặp
Giới hạn
- Endpoint này chỉ theo dõi giao dịch chuyển SOL đầu tiên đến một ví.
- Nếu ví được tạo thông qua airdrop hoặc quá trình khởi tạo chương trình mà không có giao dịch chuyển SOL, ví đó sẽ không có dữ liệu cấp vốn.
- Nguồn cấp vốn đại diện cho bên cấp vốn trực tiếp, không nhất thiết là nguồn tiền cuối cùng.
- Dữ liệu lịch sử chỉ khả dụng đối với các ví được tạo sau khi tính năng này được triển khai.
Bước tiếp theo
Wallet Identity
Phân giải địa chỉ bên cấp vốn thành nhãn, danh mục và các thẻ đầy đủ.
Wallet API Overview
Tất cả endpoint của Wallet API và các quy ước dùng chung.
API Reference
Lược đồ yêu cầu và phản hồi cho thao tác tra cứu nguồn cấp vốn.