> ## 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

> Возвращает 20 крупнейших счетов для определенного типа SPL-токена.

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

<ParamField body="address" type="string" required>
  Адрес выпуска токена Solana, используемый для анализа счетов крупнейших держателей и структуры распределения.
</ParamField>

<ParamField body="commitment" type="string">
  Уровень подтверждения для запроса.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>


## OpenAPI

````yaml ru/openapi/rpc-http/getTokenLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API анализа концентрации токенов для выявления крупнейших держателей и
    отслеживания закономерностей распределения токенов в экосистеме блокчейна
    Solana.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Конечная точка RPC основной сети
  - url: https://devnet.helius-rpc.com
    description: Конечная точка RPC тестовой сети Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenLargestAccounts
      description: >
        Определяйте и анализируйте крупнейших держателей любого SPL-токена
        Solana с подробной информацией о балансах.

        Этот мощный API распределения токенов предоставляет данные о
        закономерностях концентрации токенов, 

        выявляя крупнейших держателей («китов») и их относительные позиции. Он
        незаменим для анализа рынка,

        аудита распределения токенов, взаимодействия с инвесторами и
        отслеживания управления DAO. API автоматически

        возвращает адреса, отсортированные по балансу в порядке убывания, с
        правильным форматированием десятичных разрядов

        для немедленной интеграции в аналитические панели и инструменты
        мониторинга.
      operationId: getTokenLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: Версия протокола JSON-RPC.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Уникальный идентификатор запроса.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenLargestAccounts
                  description: Имя вызываемого метода RPC.
                  example: getTokenLargestAccounts
                  default: getTokenLargestAccounts
                params:
                  type: array
                  description: >-
                    Параметры запроса крупнейших счетов токена для указанного
                    адреса выпуска.
                  default:
                    - he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Адрес выпуска токена Solana, для которого нужно
                          проанализировать счета крупнейших держателей и
                          закономерности распределения.
                        example: he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                      - type: object
                        description: Объект конфигурации.
                        properties:
                          commitment:
                            type: string
                            description: Уровень подтверждения для запроса.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
      responses:
        '200':
          description: Крупнейшие счета токена успешно получены.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Версия протокола JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Идентификатор, соответствующий запросу.
                    example: '1'
                  result:
                    type: object
                    description: Контекст и сведения о счетах токена.
                    properties:
                      context:
                        type: object
                        description: Контекст ответа.
                        properties:
                          slot:
                            type: integer
                            description: Слот, в котором были получены данные.
                            example: 1114
                      value:
                        type: array
                        description: Список счетов токена с их балансами.
                        items:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                Адрес кошелька Solana, на котором хранится
                                значительная часть предложения токена.
                              example: FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r
                            amount:
                              type: string
                              description: >-
                                Необработанный баланс токенов на счете этого
                                крупного держателя без форматирования десятичных
                                разрядов.
                              example: '771'
                            decimals:
                              type: integer
                              description: >-
                                Количество десятичных разрядов, заданное токеном
                                для правильного представления баланса.
                              example: 2
                            uiAmount:
                              type: number
                              description: >-
                                Удобочитаемый баланс токенов этого крупного
                                держателя с правильным форматированием
                                десятичных разрядов (устарело).
                              example: 7.71
                              deprecated: true
                            uiAmountString:
                              type: string
                              description: >-
                                Каноническое строковое представление баланса
                                токенов этого крупного держателя с десятичными
                                разрядами.
                              example: '7.71'
              examples:
                tokenResponse:
                  $ref: '#/components/examples/tokenLargestAccountsResponse'
        '400':
          description: >-
            Неверный запрос — недопустимые параметры или некорректная структура
            запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Недопустимые параметры
                id: '1'
        '401':
          description: Не авторизовано — ключ API недействителен или отсутствует.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Не авторизовано
                id: '1'
        '429':
          description: Слишком много запросов — превышено ограничение частоты запросов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Слишком много запросов
                id: '1'
        '500':
          description: Внутренняя ошибка сервера — на сервере произошла ошибка.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Внутренняя ошибка
                id: '1'
        '503':
          description: Сервис недоступен — сервис временно недоступен.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Сервис недоступен
                id: '1'
        '504':
          description: Истекло время ожидания шлюза — время ожидания запроса истекло.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Истекло время ожидания шлюза
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  examples:
    tokenLargestAccountsResponse:
      value:
        jsonrpc: '2.0'
        id: '1'
        result:
          context:
            slot: 1114
          value:
            - address: FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r
              amount: '771'
              decimals: 2
              uiAmount: 7.71
              uiAmountString: '7.71'
            - address: BnsywxTcaYeNUtzrPxQUvzAWxfzZe3ZLUJ4wMMuLESnu
              amount: '229'
              decimals: 2
              uiAmount: 2.29
              uiAmountString: '2.29'
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Версия протокола JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Код ошибки.
              example: -32602
            message:
              type: string
              description: Сообщение об ошибке.
            data:
              type: object
              description: Дополнительные данные об ошибке.
        id:
          type: string
          description: Идентификатор, соответствующий запросу.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ваш ключ API Helius. Его можно бесплатно получить в [панели
        управления](https://dashboard.helius.dev/api-keys).

````

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