Cách sử dụng getTokenLargestAccounts

​

Các trường hợp sử dụng phổ biến

• Phân tích sự phân bổ token: Tìm hiểu cách nguồn cung của một token được phân bổ giữa những người nắm giữ.
• Xác định cá voi: Tìm các tài khoản nắm giữ lượng lớn một token cụ thể.
• Nghiên cứu thị trường: Đánh giá mức độ tập trung quyền sở hữu token.
• Hiển thị những người nắm giữ hàng đầu: Hiển thị danh sách các tài khoản lớn nhất trong trình khám phá token hoặc bảng điều khiển.

​

Tham số yêu cầu

1. mintAddress (chuỗi, bắt buộc): Khóa công khai được mã hóa base-58 của mint token mà bạn muốn tìm các tài khoản lớn nhất.
2. options (đối tượng, không bắt buộc): Đối tượng cấu hình không bắt buộc, có thể bao gồm:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức độ cam kết cho truy vấn (ví dụ: "finalized", "confirmed", "processed").

​

Cấu trúc phản hồi

• address (chuỗi): Khóa công khai được mã hóa base-58 của tài khoản token.
• amount (chuỗi): Số dư thô của tài khoản token, ở dạng chuỗi. Giá trị này chưa được điều chỉnh theo số chữ số thập phân.
• decimals (u8): Số chữ số thập phân được xác định cho mint token này.
• uiAmount (số | null): Số dư token ở dạng số dấu phẩy động, đã được điều chỉnh theo số chữ số thập phân. Trường này có thể đã lỗi thời hoặc kém tin cậy hơn; nên ưu tiên uiAmountString.
• uiAmountString (chuỗi): Số dư token ở dạng chuỗi, đã được điều chỉnh theo số chữ số thập phân. Đây là cách biểu diễn số dư thân thiện nhất với người dùng.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 123456789 },
    "value": [
      {
        "address": "TokenAccountPubkey1...",
        "amount": "1000000000000", // e.g., 1,000,000 tokens with 6 decimals
        "decimals": 6,
        "uiAmount": 1000000.0,
        "uiAmountString": "1000000.0"
      },
      {
        "address": "TokenAccountPubkey2...",
        "amount": "500000000000",  // e.g., 500,000 tokens with 6 decimals
        "decimals": 6,
        "uiAmount": 500000.0,
        "uiAmountString": "500000.0"
      }
      // ... up to 18 more accounts
    ]
  },
  "id": 1
}

​

Ví dụ mã

# Replace <TOKEN_MINT_PUBKEY> with the actual mint address
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenLargestAccounts",
    "params": [
      "<TOKEN_MINT_PUBKEY>"
    ]
  }' \
  <YOUR_RPC_URL>

# Example with commitment level
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenLargestAccounts",
    "params": [
      "<TOKEN_MINT_PUBKEY>",
      { "commitment": "confirmed" }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection, PublicKey } = require('@solana/web3.js');

async function getLargestTokenHolders(mintAddress) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const mintPublicKey = new PublicKey(mintAddress);

  try {
    const largestAccounts = await connection.getTokenLargestAccounts(mintPublicKey);
    console.log(`Largest accounts for mint ${mintAddress}:`);
    largestAccounts.value.forEach(account => {
      console.log(`  Address: ${account.address}`);
      console.log(`    UI Amount: ${account.uiAmountString}`);
      console.log(`    Raw Amount: ${account.amount}`);
      console.log(`    Decimals: ${account.decimals}`);
    });
    // For full details:
    // console.log(JSON.stringify(largestAccounts, null, 2));
  } catch (error) {
    console.error(`Error fetching largest token accounts for mint ${mintAddress}:`, error);
  }
}

// Replace with the actual token mint public key you want to query
const exampleTokenMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'; // USDC mint
getLargestTokenHolders(exampleTokenMint);

// Example with a different mint (e.g., Raydium)
// const raydiumMint = '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R';
// getLargestTokenHolders(raydiumMint);

​

Mẹo dành cho nhà phát triển

• Giới hạn cố định: Phương thức này luôn trả về tối đa 20 tài khoản lớn nhất. Phương thức không hỗ trợ phân trang hoặc yêu cầu nhiều hơn 20 tài khoản.
• Độ chính xác của dữ liệu: Dữ liệu phản ánh trạng thái của sổ cái tại slot được xác định theo mức độ cam kết đã chỉ định.
• Theo từng mint token: Kết quả chỉ áp dụng cho một mint token duy nhất được cung cấp trong yêu cầu.
• Hiệu suất: Đây là truy vấn có mục tiêu cụ thể và thường có hiệu suất tốt. Tuy nhiên, nên tránh thăm dò quá thường xuyên.