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

> Retorna as 20 maiores contas de um tipo específico de Token SPL.

## Parâmetros da Requisição

<ParamField body="address" type="string" required>
  Endereço de token mint Solana para analisar contas de maiores detentores e padrões de distribuição.
</ParamField>

<ParamField body="commitment" type="string">
  O nível de commitment para a requisição.

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


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getTokenLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de análise de concentração de tokens para identificar grandes detentores
    e rastrear padrões de distribuição de tokens no ecossistema da blockchain
    Solana.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC da Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC do Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenLargestAccounts
      description: >-
        Identifique e analise os maiores detentores de qualquer token SPL Solana
        com informações detalhadas de saldo. Esta poderosa API de distribuição
        de tokens fornece insights sobre padrões de concentração de tokens,
        revelando grandes detentores ("baleias") e suas posições relativas.
        Essencial para análise de mercado, auditorias de distribuição de tokens,
        relações com investidores e acompanhamento de governança DAO. Retorna
        automaticamente endereços ordenados por saldo em ordem decrescente com
        formatação decimal adequada para integração imediata em painéis de
        análise e ferramentas de monitoramento.
      operationId: getTokenLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: A versão do protocolo JSON-RPC.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Um identificador único para a solicitação.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenLargestAccounts
                  description: O nome do método RPC a ser invocado.
                  example: getTokenLargestAccounts
                  default: getTokenLargestAccounts
                params:
                  type: array
                  description: >-
                    Parâmetros para consultar as maiores contas de tokens para
                    uma mint específica.
                  default:
                    - he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Endereço de mint do token Solana para análise das
                          maiores contas detentoras e padrões de distribuição.
                        example: he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                      - type: object
                        description: Objeto de configuração.
                        properties:
                          commitment:
                            type: string
                            description: O nível de compromisso para a solicitação.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
      responses:
        '200':
          description: As maiores contas de tokens foram recuperadas com sucesso.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: A versão do protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador correspondente à solicitação.
                    example: '1'
                  result:
                    type: object
                    description: Detalhes de contexto e contas de token.
                    properties:
                      context:
                        type: object
                        description: Contexto da resposta.
                        properties:
                          slot:
                            type: integer
                            description: Slot no qual os dados foram buscados.
                            example: 1114
                      value:
                        type: array
                        description: Lista de contas de token com seus saldos.
                        items:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                Endereço da carteira Solana que detém uma parte
                                significativa do fornecimento de tokens.
                              example: FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r
                            amount:
                              type: string
                              description: >-
                                Saldo bruto de tokens desta conta principal sem
                                formatação decimal.
                              example: '771'
                            decimals:
                              type: integer
                              description: >-
                                Número de casas decimais definidas pelo token
                                para representação adequada do saldo.
                              example: 2
                            uiAmount:
                              type: number
                              description: >-
                                Saldo de token legível por humanos desta conta
                                principal com formatação decimal adequada
                                (obsoleto).
                              example: 7.71
                              deprecated: true
                            uiAmountString:
                              type: string
                              description: >-
                                Representação canônica em string do saldo de
                                tokens desta conta principal com casas decimais.
                              example: '7.71'
              examples:
                tokenResponse:
                  $ref: '#/components/examples/tokenLargestAccountsResponse'
        '400':
          description: >-
            Solicitação Inválida - Parâmetros de solicitação inválidos ou
            solicitação malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parâmetros inválidos
                id: '1'
        '401':
          description: Não autorizado - Chave de API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Não autorizado
                id: '1'
        '429':
          description: Muitas Solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Muitas solicitações
                id: '1'
        '500':
          description: Erro Interno do Servidor - Ocorreu um erro no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Erro interno
                id: '1'
        '503':
          description: Serviço Indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Serviço indisponível
                id: '1'
        '504':
          description: Tempo de Espera do Gateway - A solicitação excedeu o tempo limite.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tempo limite do gateway
                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: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código de erro.
              example: -32602
            message:
              type: string
              description: A mensagem de erro.
            data:
              type: object
              description: Dados adicionais sobre o erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave de API Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````