> ## 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
> 현재 공급에 대한 정보를 반환합니다.
## 요청 매개변수
요청에 대한 커밋 수준입니다.
* `confirmed`
* `finalized`
* `processed`
더 빠른 응답을 위해 비유통 SOL 예비 계정의 세부 목록을 제외하는 옵션입니다.
## OpenAPI
````yaml ko/openapi/rpc-http/getSupply.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Solana 블록체인 생태계 전반에 걸쳐 총 유통량, 토큰 경제, 배포 메트릭을 모니터링하기 위한 네이티브 SOL 공급 분석
API입니다.
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: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getSupply
description: |
Solana의 네이티브 SOL 토큰 공급 및 배포에 대한 포괄적인 메트릭을 검색합니다.
이 필수적인 토크노믹스 API는 생태계 전반에 걸쳐 SOL 분포를 추적하는 데 있어 유통 및 비유통
토큰 공급에 대한 세부적인 분석을 제공합니다. 데이터에는 총 SOL
공급량, 실시간 유통 수치, 예비 중인 토큰,
비유통 토큰을 보유한 계정 목록이 포함됩니다. 금융 분석가, 토큰 경제 연구원,
시장 추적자 및 Solana의 네이티브 토큰
공급 및 배포 패턴에 대한 정확한 메트릭이 필요한 애플리케이션에 중요합니다.
operationId: getSupply
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:
- getSupply
description: 호출할 RPC 메서드의 이름입니다.
example: getSupply
default: getSupply
params:
type: array
description: 옵션 구성 객체입니다.
default: []
items:
type: object
properties:
commitment:
type: string
description: 요청에 대한 커밋 수준입니다.
enum:
- confirmed
- finalized
- processed
example: finalized
excludeNonCirculatingAccountsList:
type: boolean
description: 빠른 응답을 위해 비유통 SOL 예비 계정의 세부 목록을 제외하는 옵션입니다.
example: true
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: object
description: 공급 세부정보입니다.
properties:
total:
type: integer
description: 순환 중인 것과 잠긴 토큰을 포함하여 존재하는 총 SOL 공급량 (람포트 단위)입니다.
example: 1016000
circulating:
type: integer
description: 현재 순환 중이며 공공 사용이 가능한 SOL 양 (람포트 단위)입니다.
example: 16000
nonCirculating:
type: integer
description: 현재 순환 중이지 않으며 예비 계정에 보유된 SOL 양 (람포트 단위)입니다.
example: 1000000
nonCirculatingAccounts:
type: array
description: 비유통 SOL 토큰을 예비로 보유한 Solana 지갑 주소 목록입니다.
items:
type: string
example:
- FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
- 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
- 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
- BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
examples:
default:
$ref: '#/components/examples/getSupplyResponse'
'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:
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: 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: >-
당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
받을 수 있습니다.
````