Skip to main content
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í:

Đị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í:
Nếu ví chưa từng nhận SOL, API sẽ trả về mã 404:

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à null nế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.05 SOL).
  • 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ường funderType 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.
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 funderName và 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. timestamp cho 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.