> ## 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.
# getSupply
> getSupply trả về nguồn cung SOL hiện tại của Solana — tổng lượng, lượng đang lưu hành và lượng không lưu hành tính bằng lamport, kèm theo các tài khoản dự trữ không lưu hành tùy chọn.
## Tham số yêu cầu
Mức cam kết cho yêu cầu.
* `confirmed`
* `finalized`
* `processed`
Tùy chọn loại trừ danh sách chi tiết các tài khoản dự trữ SOL không lưu hành để nhận phản hồi nhanh hơn.
## OpenAPI
````yaml vi/openapi/rpc-http/getSupply.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API phân tích nguồn cung SOL gốc để giám sát tổng lượng lưu hành, kinh tế
học token và các chỉ số phân phối 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: getSupply
description: >
Truy xuất các chỉ số toàn diện về nguồn cung và phân phối token SOL gốc
của Solana.
API kinh tế học token thiết yếu này cung cấp thông tin chi tiết về nguồn
cung token đang lưu hành
và không lưu hành, giúp theo dõi sự phân phối SOL trên toàn hệ sinh
thái. Dữ liệu bao gồm tổng
nguồn cung SOL, số liệu lưu hành hiện tại, token dự trữ và danh sách các
tài khoản nắm giữ
token không lưu hành. Đây là dữ liệu quan trọng đối với các nhà phân
tích tài chính, nhà nghiên cứu kinh tế học token,
công cụ theo dõi thị trường và các ứng dụng cần số liệu chính xác về
nguồn cung token gốc
cũng như mô hình phân phối của Solana.
operationId: getSupply
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:
- getSupply
description: Tên của phương thức RPC cần gọi.
example: getSupply
default: getSupply
params:
type: array
description: Đối tượng cấu hình không bắt buộc.
default: []
items:
type: object
properties:
commitment:
type: string
description: Mức cam kết cho yêu cầu.
enum:
- confirmed
- finalized
- processed
example: finalized
excludeNonCirculatingAccountsList:
type: boolean
description: >-
Tùy chọn loại trừ danh sách chi tiết các tài khoản dự
trữ SOL không lưu hành để nhận phản hồi nhanh hơn.
example: true
responses:
'200':
description: Đã truy xuất thành công thông tin nguồn cung.
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: Ngữ cảnh và thông tin chi tiết về nguồn cung.
properties:
context:
type: object
description: Ngữ cảnh của phản hồi.
properties:
slot:
type: integer
description: Slot mà dữ liệu được truy xuất.
example: 1114
value:
type: object
description: Thông tin chi tiết về nguồn cung.
properties:
total:
type: integer
description: >-
Tổng nguồn cung SOL hiện có (tính bằng lamport),
bao gồm cả token đang lưu hành và bị khóa.
example: 1016000
circulating:
type: integer
description: >-
Lượng SOL (tính bằng lamport) hiện đang lưu hành
và có thể được công chúng sử dụng.
example: 16000
nonCirculating:
type: integer
description: >-
Lượng SOL (tính bằng lamport) được giữ trong các
tài khoản dự trữ và hiện không có sẵn trong lưu
thông.
example: 1000000
nonCirculatingAccounts:
type: array
description: >-
Danh sách địa chỉ ví Solana đang giữ token SOL
không lưu hành trong quỹ dự trữ.
items:
type: string
example:
- FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
- 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
- 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
- BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
examples:
default:
$ref: '#/components/examples/getSupplyResponse'
'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 có
định dạng sai.
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:
getSupplyResponse:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 1114
value:
total: 1016000
circulating: 16000
nonCirculating: 1000000
nonCirculatingAccounts:
- FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
- 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
- 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
- BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
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).
````