> ## 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
> 랩포트 잔액에 따라 가장 큰 20개 계정을 반환합니다(결과는 최대 두 시간까지 캐시될 수 있음).
## 요청 매개변수
요청에 대한 최종 확정성(커밋 수준)입니다.
* `confirmed`
* `finalized`
계정 유형별로 결과를 필터링합니다 - 유통 중인 모든 SOL 계정 또는 특별한 비유통 예비 계정만 필터링할 수 있습니다.
* `circulating`
* `nonCirculating`
## OpenAPI
````yaml ko/openapi/rpc-http/getLargestAccounts.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: Mainnet RPC 엔드포인트
- url: https://devnet.helius-rpc.com
description: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getLargestAccounts
description: >
Solana 블록체인에서 가장 큰 SOL 보유자의 순위 리스트를 가져옵니다.
이 부의 분석 API는 가장 중요한 네이티브 토큰 잔액을 보유한 계정을 식별하여 SOL 배포에 대한 통찰력을 제공합니다.
SOL 잔액에 따라 순위가 매겨진 상위 20개 계정을 반환하며, 순환 공급(활성 계정)과 비순환 공급(예비 계정) 간의 필터링
옵션을 제공합니다.
시장 연구원, 경제 분석가, 고래 감시자, 부 집중 연구 및 주요 SOL 보유자와 그들의 토큰 경제 및 시장 이동에 대한 잠재적
영향을 모니터링하는 애플리케이션에 필수적입니다.
operationId: getLargestAccounts
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전입니다.
enum:
- '2.0'
example: '2.0'
default: '2.0'
id:
type: string
description: 요청에 대한 고유 식별자입니다.
example: '1'
default: '1'
method:
type: string
description: 호출할 RPC 메서드의 이름입니다.
enum:
- getLargestAccounts
example: getLargestAccounts
default: getLargestAccounts
params:
type: array
description: 계정을 필터링하기 위한 선택적 구성 개체입니다.
default: []
items:
type: object
properties:
commitment:
type: string
description: 요청에 대한 커밋 수준입니다.
enum:
- confirmed
- finalized
example: finalized
filter:
type: string
description: >-
계정 유형별로 결과를 필터링합니다 - 모든 순환 SOL 계정 또는 특별한 비순환 예비 계정만을
기준으로.
enum:
- circulating
- nonCirculating
example: circulating
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: 54
value:
type: array
description: >-
SOL 잔액에 따라 순위가 매겨진 상위 20개의 Solana 계정으로, 가장 높은 것부터 가장
낮은 것까지 나열됩니다.
items:
type: object
properties:
lamports:
type: integer
description: 이 계정의 SOL 잔액입니다. 1 SOL = 1,000,000,000 lamports.
example: 999974
address:
type: string
description: 이 주요 계정 보유자의 고유한 Solana 지갑 주소입니다.
example: 99P8ZgtJYe1buSK8JXkvpLh8xPsCFuLYhz9hQFNw93WJ
'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:
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)에서 무료로
얻을 수 있습니다.
````