getTokenAccountsByOwnerV2
getTokenAccountsByOwnerV2 là phiên bản nâng cao của getTokenAccountsByOwner, hỗ trợ phân trang bằng con trỏ và cập nhật changedSinceSlot cho các danh mục token Solana lớn.
Tổng quan
getTokenAccountsByOwnerV2 là phiên bản nâng cao của phương thức getTokenAccountsByOwner tiêu chuẩn, được thiết kế riêng để truy vấn hiệu quả các danh mục token và xử lý các ví nắm giữ lượng lớn token. Phương thức này bổ sung tính năng phân trang dựa trên con trỏ và khả năng cập nhật tăng dần.
- Phân trang dựa trên con trỏ: Cấu hình giới hạn từ 1 đến 10.000 tài khoản token cho mỗi yêu cầu
- Cập nhật tăng dần: Sử dụng
changedSinceSlotđể chỉ tìm nạp các tài khoản token mới được sửa đổi gần đây - Khả năng mở rộng danh mục: Xử lý hiệu quả các ví có hàng nghìn tài khoản token
- Khả năng tương thích ngược: Hỗ trợ tất cả tham số và bộ lọc hiện có của
getTokenAccountsByOwner withContexttùy chọn:truethêmslotvàapiVersionvàoresult.context; nếu bỏ qua hoặc đặt thànhfalsethì chúng sẽ không được đưa vào
Lợi ích chính
Large Portfolios
Real-time Tracking
changedSinceSlot để cập nhật tăng dầnwithContext (tùy chọn)
Giá trị Boolean trong đối tượng cấu hình (params[2]). Chỉ cấu trúc của result thay đổi, còn bộ lọc, giới hạn và cách phân trang không thay đổi. Nếu bỏ qua hoặc đặt thành false: result.value là mảng tài khoản token. Nếu đặt thành true: result.context cùng với result.value dưới dạng đối tượng (accounts, paginationKey). Nếu xử lý cả hai trường hợp, hãy phân nhánh theo Array.isArray(result.value).
Các phương pháp hay nhất khi phân trang
Truy vấn danh mục cơ bản
Cập nhật danh mục tăng dần
Hỗ trợ chương trình token
Di chuyển từ getTokenAccountsByOwner
Việc di chuyển rất đơn giản — chỉ cần thêm các tham số phân trang vào truy vấn hiện có:Các phương thức liên quan
getTokenAccountsByOwner
getProgramAccountsV2
Tham số yêu cầu
confirmedfinalizedprocessed
true, trả về result.context (siêu dữ liệu ảnh chụp nhanh: slot, apiVersion) và lồng
accounts cùng paginationKey bên trong result.value dưới dạng đối tượng. Khi là false
hoặc bị bỏ qua, result.value là mảng tài khoản token của trang này, với paginationKey
nằm trong result. Áp dụng cùng bộ lọc và giới hạn.base58base64base64+zstdjsonParsed
Ủy quyền
Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong bảng điều khiển.
Nội dung
Phiên bản giao thức JSON-RPC.
2.0 "2.0"
Mã định danh duy nhất cho yêu cầu.
"1"
Tên của phương thức RPC cần gọi.
getTokenAccountsByOwnerV2 "getTokenAccountsByOwnerV2"
Các tham số để truy vấn những tài khoản token được phân trang thuộc sở hữu của một khóa công khai cụ thể.
Địa chỉ ví Solana (pubkey) của chủ sở hữu tài khoản cần truy vấn tài sản token, dưới dạng chuỗi được mã hóa base-58.
"A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd"
Phản hồi
Đã truy xuất thành công các tài khoản token được phân trang theo chủ sở hữu.
Phiên bản giao thức JSON-RPC.
2.0 "2.0"
Mã định danh khớp với yêu cầu.
"1"
Các tài khoản token được phân trang khi withContext là false hoặc bị bỏ qua. Khớp với cấu trúc quen thuộc, trong đó danh sách tài khoản là một mảng tại result.value (không được lồng trong accounts).
- không có withContext
- có withContext