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

> Trả về 20 tài khoản lớn nhất của một loại token SPL cụ thể.

## Tham số yêu cầu

<ParamField body="address" type="string" required>
  Địa chỉ mint token Solana cần phân tích để xác định các tài khoản nắm giữ nhiều nhất và mô hình phân phối.
</ParamField>

<ParamField body="commitment" type="string">
  Mức commitment cho yêu cầu.

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


## OpenAPI

````yaml vi/openapi/rpc-http/getTokenLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API phân tích mức độ tập trung token để xác định các chủ sở hữu lớn và theo
    dõi mô hình phân phối token trên toàn hệ sinh thái 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: Điểm cuối RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Điểm cuối RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenLargestAccounts
      description: >
        Xác định và phân tích các chủ sở hữu lớn nhất của bất kỳ token SPL
        Solana nào cùng thông tin chi tiết về số dư.

        API phân phối token mạnh mẽ này cung cấp thông tin chuyên sâu về các mô
        hình tập trung token, 

        tiết lộ các chủ sở hữu lớn ("cá voi") và vị thế tương đối của họ. Đây là
        công cụ thiết yếu cho hoạt động phân tích thị trường,

        kiểm toán phân phối token, quan hệ nhà đầu tư và theo dõi quản trị DAO.
        API tự động

        trả về các địa chỉ được sắp xếp theo số dư giảm dần với định dạng thập
        phân phù hợp

        để tích hợp ngay vào các bảng điều khiển phân tích và công cụ giám sát.
      operationId: getTokenLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: Phiên bản giao thức JSON-RPC.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Mã định danh duy nhất cho yêu cầu.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenLargestAccounts
                  description: Tên của phương thức RPC cần gọi.
                  example: getTokenLargestAccounts
                  default: getTokenLargestAccounts
                params:
                  type: array
                  description: >-
                    Các tham số để truy vấn những tài khoản token lớn nhất của
                    một mint cụ thể.
                  default:
                    - he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Địa chỉ mint token Solana cần phân tích để xác định
                          các tài khoản chủ sở hữu lớn nhất và mô hình phân
                          phối.
                        example: he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
                      - type: object
                        description: Đối tượng cấu hình.
                        properties:
                          commitment:
                            type: string
                            description: Mức cam kết cho yêu cầu.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
      responses:
        '200':
          description: Đã truy xuất thành công các tài khoản token lớn nhất.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Phiên bản giao thức JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Mã định danh khớp với yêu cầu.
                    example: '1'
                  result:
                    type: object
                    description: Thông tin chi tiết về ngữ cảnh và tài khoản token.
                    properties:
                      context:
                        type: object
                        description: Ngữ cảnh của phản hồi.
                        properties:
                          slot:
                            type: integer
                            description: Slot nơi dữ liệu được truy xuất.
                            example: 1114
                      value:
                        type: array
                        description: Danh sách các tài khoản token cùng số dư tương ứng.
                        items:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                Địa chỉ ví Solana nắm giữ một phần đáng kể nguồn
                                cung token.
                              example: FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r
                            amount:
                              type: string
                              description: >-
                                Số dư token thô của tài khoản chủ sở hữu lớn
                                này, chưa áp dụng định dạng thập phân.
                              example: '771'
                            decimals:
                              type: integer
                              description: >-
                                Số chữ số thập phân do token xác định để biểu
                                diễn số dư chính xác.
                              example: 2
                            uiAmount:
                              type: number
                              description: >-
                                Số dư token dễ đọc của chủ sở hữu lớn này với
                                định dạng thập phân phù hợp (đã ngừng dùng).
                              example: 7.71
                              deprecated: true
                            uiAmountString:
                              type: string
                              description: >-
                                Biểu diễn chuỗi chuẩn của số dư token thuộc chủ
                                sở hữu lớn này với các chữ số thập phân.
                              example: '7.71'
              examples:
                tokenResponse:
                  $ref: '#/components/examples/tokenLargestAccountsResponse'
        '400':
          description: >-
            Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
            định dạng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Hết thời gian chờ cổng kết nối - Yêu cầu đã hết thời gian chờ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                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: Phiên bản giao thức JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Mã lỗi.
              example: -32602
            message:
              type: string
              description: Thông báo lỗi.
            data:
              type: object
              description: Dữ liệu bổ sung về lỗi.
        id:
          type: string
          description: Mã định danh khớp với yêu cầu.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        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](https://dashboard.helius.dev/api-keys).

````