> ## 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.
# getLargestAccounts
> Trả về 20 tài khoản lớn nhất theo số dư lamport (kết quả có thể được lưu vào bộ nhớ đệm trong tối đa hai giờ).
## Tham số yêu cầu
Mức cam kết cho yêu cầu.
* `confirmed`
* `finalized`
Lọc kết quả theo loại tài khoản — tất cả tài khoản SOL đang lưu hành hoặc chỉ các tài khoản dự trữ đặc biệt không lưu hành.
* `circulating`
* `nonCirculating`
## OpenAPI
````yaml vi/openapi/rpc-http/getLargestAccounts.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API phân tích phân bổ tài sản để xác định và giám sát những người nắm giữ
SOL lớn nhất trên blockchain Solana, với các tùy chọn lọc dành cho tài khoản
lưu hành và tài khoản dự trữ.
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: getLargestAccounts
description: >
Truy xuất danh sách xếp hạng những người nắm giữ SOL lớn nhất trên
blockchain Solana.
API phân tích tài sản này cung cấp thông tin chuyên sâu về cách phân bổ
SOL bằng cách xác định
các tài khoản nắm giữ số dư token gốc lớn nhất. Trả về 20 tài khoản hàng
đầu
được xếp hạng theo số dư SOL, với các tùy chọn lọc giữa nguồn cung lưu
hành (tài khoản đang hoạt động)
và nguồn cung không lưu hành (tài khoản dự trữ). Đây là công cụ thiết
yếu cho các nhà nghiên cứu thị trường, nhà phân tích
kinh tế, người theo dõi cá voi, các nghiên cứu về mức độ tập trung tài
sản và ứng dụng giám sát những
người nắm giữ SOL lớn cùng tác động tiềm tàng của họ đến kinh tế token
và biến động thị trường.
operationId: getLargestAccounts
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
example: '2.0'
default: '2.0'
id:
type: string
description: Mã định danh duy nhất của yêu cầu.
example: '1'
default: '1'
method:
type: string
description: Tên của phương thức RPC cần gọi.
enum:
- getLargestAccounts
example: getLargestAccounts
default: getLargestAccounts
params:
type: array
description: Đối tượng cấu hình không bắt buộc để lọc tài khoản.
default: []
items:
type: object
properties:
commitment:
type: string
description: Mức cam kết của yêu cầu.
enum:
- confirmed
- finalized
example: finalized
filter:
type: string
description: >-
Lọc kết quả theo loại tài khoản — tất cả tài khoản SOL
đang lưu hành hoặc chỉ các tài khoản dự trữ đặc biệt
không lưu hành.
enum:
- circulating
- nonCirculating
example: circulating
responses:
'200':
description: Đã truy xuất thành công các tài khoản 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: Danh sách các tài khoản lớn nhất và số dư của chúng.
properties:
context:
type: object
description: Ngữ cảnh của phản hồi.
properties:
slot:
type: integer
description: Slot mà tại đó dữ liệu được truy xuất.
example: 54
value:
type: array
description: >-
20 tài khoản Solana lớn nhất được xếp hạng theo số dư
SOL, từ cao nhất đến thấp nhất.
items:
type: object
properties:
lamports:
type: integer
description: >-
Số dư SOL của tài khoản này tính bằng lamport (1
SOL = 1.000.000.000 lamport).
example: 999974
address:
type: string
description: >-
Địa chỉ ví Solana duy nhất của chủ tài khoản lớn
này.
example: 99P8ZgtJYe1buSK8JXkvpLh8xPsCFuLYhz9hQFNw93WJ
'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: Tham số không hợp lệ
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: Không được phép
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: Quá nhiều yêu cầu
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: Lỗi nội bộ
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: Dịch vụ không khả dụng
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: Hết thời gian chờ cổng kết nối
id: '1'
security:
- ApiKeyQuery: []
components:
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).
````