query-address-info
bởi binancequery-address-info là một skill Web3 dùng để kiểm tra lượng token đang nắm giữ theo một địa chỉ ví và chain được hỗ trợ. Skill này trả về tên token, ký hiệu, giá, mức thay đổi giá 24h và số lượng đang nắm giữ, rất hữu ích cho kiểm tra nhanh danh mục, thẩm định ví và theo dõi địa chỉ. Hãy dùng khi bạn cần một ảnh chụp số dư có cấu trúc rõ ràng, ít phải đoán mò hơn.
Skill này đạt 72/100, nghĩa là có thể đưa vào danh mục nhưng nên trình bày kèm lưu ý: nó cho agent một use case truy vấn ví rất rõ và một API cụ thể để gọi, nhưng repo vẫn để thiếu một số chi tiết quy trình nên người dùng có thể phải tự suy ra vài bước thực thi. Với người dùng thư mục skill, mức này đủ để cân nhắc cài đặt nếu họ cần một skill tra cứu địa chỉ on-chain tập trung, chứ chưa phải một workflow đầu-cuối được trau chuốt hoàn chỉnh.
- Ý định kích hoạt rất rõ cho các câu hỏi về số dư ví, lượng token nắm giữ, danh mục và vị thế tài sản.
- Có endpoint GET cụ thể kèm tham số bắt buộc và request headers, giúp agent có thể gọi trực tiếp.
- Không có dấu hiệu placeholder hay thử nghiệm, và phần nội dung đủ dày để cho thấy đây là API dùng thật.
- Repo chỉ cung cấp một file skill và không có script hỗ trợ, tài liệu tham chiếu hay rule đi kèm, nên xử lý trường hợp biên và kiểm tra hợp lệ chưa được mô tả kỹ.
- Ví dụ hiển thị bị cắt ngắn và phần mô tả khá ngắn, làm giảm độ rõ ràng khi người mới cần bắt đầu nhanh.
Tổng quan về skill query-address-info
query-address-info làm gì
Skill query-address-info lấy danh mục token mà một địa chỉ ví đang nắm giữ trên một chain được hỗ trợ. Skill này được thiết kế cho người dùng Web3 muốn xem nhanh trạng thái vị thế hiện tại của ví, bao gồm tên token, ký hiệu, giá, mức biến động giá 24 giờ và số lượng đang nắm giữ.
Skill này dành cho ai
Hãy dùng query-address-info cho các nhu cầu kiểm tra danh mục, thẩm định ví, theo dõi địa chỉ và phân tích on-chain nhẹ. Skill này hữu ích nhất khi bạn đã có sẵn địa chỉ và chain ID, và cần một snapshot số dư có cấu trúc thật nhanh.
Khi nào đây là lựa chọn phù hợp
Đây là lựa chọn tốt khi bạn cần một query-address-info guide thực dụng để trả lời câu hỏi “ví này hiện đang nắm giữ gì?”. Skill này kém phù hợp hơn nếu bạn cần lịch sử giao dịch, quy chiếu DeFi đầy đủ, kiểm kê NFT hoặc phân tích sâu vượt ra ngoài các vị thế token đang hoạt động.
Các điểm quyết định chính
Lý do chính để cài query-address-info là tốc độ: skill này giảm bớt phần đoán mò trong quy trình tra cứu địa chỉ và cho bạn thấy chính xác dạng request cần dùng. Hạn chế lớn nhất là phạm vi: skill chỉ tập trung vào token holdings của một địa chỉ và một chain cụ thể, nên bạn không nên kỳ vọng vào tổng hợp đa chain hay kế toán lịch sử.
Cách dùng skill query-address-info
Cài đặt và mở các file của skill
Với query-address-info install, hãy thêm skill từ binance/binance-skills-hub rồi đọc file entry của skill trước. Bắt đầu với SKILL.md, sau đó kiểm tra các file repository được liên kết nếu có. Trong repo này, skill là self-contained, nên SKILL.md là nguồn thông tin chuẩn quan trọng nhất.
Skill cần đầu vào gì
Để dùng query-address-info hiệu quả, hãy cung cấp:
- một địa chỉ ví, chẳng hạn địa chỉ
0x...kiểu EVM - một
chainIdđược hỗ trợ, chẳng hạn56cho BSC hoặc8453cho Base - một giá trị
offsetcho phân trang, thường là0ở trang đầu tiên
Một prompt yếu như “kiểm tra ví này” sẽ để lại quá nhiều mơ hồ. Một prompt mạnh hơn như “Dùng query-address-info cho địa chỉ 0x... trên chain 56, trả về các vị thế token đang hoạt động và lưu ý mọi tập trung số dư lớn” sẽ cung cấp đủ ngữ cảnh để skill trả kết quả đúng trọng tâm.
Quy trình thực tế để có kết quả tốt hơn
Dùng query-address-info usage theo 3 bước:
- Xác nhận chain và địa chỉ là đúng.
- Yêu cầu trang đầu tiên của holdings với
offset=0. - Nếu ví có nhiều tài sản, tiếp tục với các
offsettiếp theo để xem thêm vị thế.
Với các tác vụ phân tích, hãy yêu cầu model tóm tắt holdings theo mức tập trung token, mức độ tiếp xúc với stablecoin, hoặc các biến động giá đáng chú ý. Cách này biến một danh sách số dư thô thành một bản đọc ví hữu ích thay vì chỉ là một dump API.
Những file và chi tiết nên đọc trước
Nếu bạn đang điều chỉnh skill, hãy đọc các tham số request, headers và ví dụ request trong SKILL.md trước khi xây prompt hoặc tự động hóa. Những chi tiết này quan trọng vì endpoint yêu cầu đúng địa chỉ, chain ID và định dạng phân trang cụ thể, và việc nhập sai là nguyên nhân phổ biến nhất khiến kết quả trống hoặc gây hiểu nhầm.
FAQ về skill query-address-info
query-address-info chỉ dành cho địa chỉ Web3 thôi sao?
Đúng. Trường hợp sử dụng query-address-info for Web3 là trọng tâm thiết kế. Skill này dành cho địa chỉ ví on-chain và vị thế token, không phải email, hồ sơ sàn giao dịch hay dữ liệu danh tính off-chain.
Nó khác gì so với một prompt bình thường?
Một prompt bình thường có thể mô tả mục tiêu, nhưng query-address-info skill cung cấp quy trình chuẩn theo API cùng các đầu vào bắt buộc một cách chính xác. Điều đó thường giúp giảm lỗi định dạng, giảm qua lại chỉnh sửa và cho đầu ra đáng tin cậy hơn khi bạn cần xem holdings của ví thật nhanh.
Skill này có dễ dùng cho người mới không?
Có, nếu bạn đã biết địa chỉ ví và chain. Thách thức lớn nhất với người mới là chọn đúng chain ID và hiểu rằng skill này trả về các vị thế đang hoạt động, chứ không phải mọi loại dữ liệu tài sản mà một ví có thể có.
Khi nào tôi không nên dùng nó?
Không nên dùng query-address-info nếu bạn cần PnL lịch sử, truy vết giao dịch đầy đủ, tổng hợp danh mục đa chain hoặc phân tích NFT. Những việc đó cần công cụ và nguồn dữ liệu khác.
Cách cải thiện skill query-address-info
Cung cấp địa chỉ và chain sạch nhất có thể
Cách tốt nhất để cải thiện kết quả query-address-info là cung cấp một địa chỉ hợp lệ theo chuẩn checksum và đúng chain ID. Nếu một trong hai giá trị sai, đầu ra có thể không đầy đủ hoặc trỏ sang ngữ cảnh ví sai.
Hãy yêu cầu đúng loại phân tích bạn cần
Thay vì chỉ hỏi số dư, hãy nêu rõ quyết định bạn muốn đưa ra. Ví dụ: “Tóm tắt 5 holding lớn nhất theo giá trị”, “Gắn cờ các ví nặng stablecoin”, hoặc “Làm nổi bật các token có biến động mạnh trong 24h”. Làm vậy giúp skill biến danh sách vị thế thành đầu ra query-address-info guide hữu ích hơn.
Dùng phân trang có chủ đích
Những ví lớn có thể có nhiều vị thế hơn số lượng hiển thị trên một trang. Nếu phản hồi đầu tiên trông như bị thiếu, hãy tiếp tục với offset tiếp theo thay vì vội kết luận ví trống. Điều này đặc biệt quan trọng với trader active, LP và các ví nắm nhiều loại tài sản.
Kiểm tra các trường hợp biên trước khi hành động
Hãy để ý đến wrapped assets, token kém thanh khoản và các số dư có vẻ cũ. Nếu bạn dùng kết quả cho mục đích screening hoặc báo cáo, hãy đối chiếu các holding lớn nhất với chiến lược có khả năng của ví và chạy lại bằng prompt mới nếu đầu ra không khớp với chain hoặc địa chỉ kỳ vọng.