> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Как использовать getTokenLargestAccounts

> Изучите сценарии использования getTokenLargestAccounts, примеры кода, параметры запроса, структуру ответа и рекомендации.

Метод RPC [`getTokenLargestAccounts`](https://www.helius.dev/docs/api-reference/rpc/http/gettokenlargestaccounts) возвращает список из 20 крупнейших счетов токенов для указанного минта SPL-токена. Он позволяет анализировать распределение токенов и выявлять крупнейших держателей определенного токена.

## Распространенные сценарии использования

* **Анализ распределения токенов:** Определение того, как предложение токена распределено между его держателями.
* **Выявление китов:** Поиск счетов, на которых хранятся значительные объемы определенного токена.
* **Исследование рынка:** Оценка концентрации владения токеном.
* **Отображение крупнейших держателей:** Вывод списка крупнейших счетов в обозревателе токенов или на панели мониторинга.

## Параметры запроса

1. **`mintAddress`** (строка, обязательный): Публичный ключ минта токена в кодировке base58, для которого требуется найти крупнейшие счета.

2. **`options`** (объект, необязательный): Необязательный объект конфигурации, который может включать:
   * **`commitment`** (строка, необязательный): Задает [уровень подтверждения](https://www.helius.dev/blog/solana-commitment-levels) для запроса (например, `"finalized"`, `"confirmed"`, `"processed"`).

## Структура ответа

Поле `result.value` в ответе JSON-RPC представляет собой массив, содержащий до 20 объектов. Каждый объект соответствует одному из крупнейших счетов токенов и содержит следующие поля:

* **`address`** (строка): Публичный ключ счета токенов в кодировке base58.
* **`amount`** (строка): Исходный баланс счета токенов в виде строки. Это значение не скорректировано с учетом количества десятичных знаков.
* **`decimals`** (u8): Количество десятичных знаков, заданное для этого минта токена.
* **`uiAmount`** (число | null): Баланс токенов в виде числа с плавающей запятой, скорректированный с учетом количества десятичных знаков. Это поле может быть устаревшим или менее надежным; рекомендуется использовать `uiAmountString`.
* **`uiAmountString`** (строка): Баланс токенов в виде строки, скорректированный с учетом количества десятичных знаков. Это наиболее удобное для пользователя представление баланса.

**Пример ответа:**

```json theme={"system"}
{
  "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
}
```

## Примеры кода

<CodeGroup>
  ```bash cURL theme={"system"}
  # 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>
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  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);
  ```
</CodeGroup>

## Рекомендации разработчикам

* **Фиксированный лимит:** Этот метод всегда возвращает до 20 крупнейших счетов. Он не поддерживает пагинацию или запрос более 20 счетов.
* **Точность данных:** Данные отражают состояние реестра в слоте, определенном указанным уровнем подтверждения.
* **Привязка к конкретному минту токена:** Результаты относятся только к одному минту токена, указанному в запросе.
* **Производительность:** Это целевой запрос, который обычно выполняется быстро. Однако следует избегать слишком частого опроса.

Это руководство поможет использовать метод RPC `getTokenLargestAccounts` для поиска основных держателей любого SPL-токена в Solana.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.