> ## 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
> 특정 SPL 토큰 유형의 가장 큰 계정 20개를 반환합니다.
## 요청 매개변수
가장 큰 보유 계정과 분포 패턴을 분석하기 위한 Solana 토큰 민트 주소입니다.
요청에 대한 커밋 수준입니다.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml ko/openapi/rpc-http/getTokenLargestAccounts.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: Solana 블록체인 생태계 내 주요 보유자를 식별하고 토큰 분배 패턴을 추적하기 위한 토큰 집중도 분석 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: getTokenLargestAccounts
description: |
상세한 잔고 정보를 통해 Solana SPL 토큰의 최대 보유자를 식별하고 분석합니다.
이 강력한 토큰 분배 API는 토큰 집중 패턴에 대한 통찰력을 제공하여
주요 보유자("고래") 및 그 상대적 위치를 나타냅니다.
시장 분석, 토큰 분배 감사, 투자자 관계, 그리고 DAO 거버넌스 추적에 필수적입니다.
잔액에 따라 내림차순으로 정렬된 주소를 적절한 소수점 형식으로
자동으로 반환하여 바로 분석 대시보드와 모니터링 도구에 통합할 수 있습니다.
operationId: getTokenLargestAccounts
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:
- getTokenLargestAccounts
description: 호출할 RPC 메서드의 이름입니다.
example: getTokenLargestAccounts
default: getTokenLargestAccounts
params:
type: array
description: 특정 민트에 대한 최대 토큰 계정을 조회하기 위한 매개변수입니다.
default:
- he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
items:
oneOf:
- type: string
description: 최대 보유자 계정 및 분배 패턴을 분석할 Solana 토큰 민트 주소입니다.
example: he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A
- type: object
description: 구성 객체입니다.
properties:
commitment:
type: string
description: 요청에 대한 커밋 수준입니다.
enum:
- confirmed
- finalized
- processed
example: finalized
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: array
description: 잔액이 포함된 토큰 계정 목록입니다.
items:
type: object
properties:
address:
type: string
description: 토큰 공급의 상당 부분을 보유한 Solana 지갑 주소입니다.
example: FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r
amount:
type: string
description: 소수점 형식 없이 이 주요 보유자 계정의 원시 토큰 잔액입니다.
example: '771'
decimals:
type: integer
description: 적절한 잔액 표시를 위해 토큰에 의해 정의된 소수 자릿수입니다.
example: 2
uiAmount:
type: number
description: >-
적절한 소수점 형식으로 이 주요 보유자의 사람이 읽을 수 있는 토큰 잔액입니다
(사용되지 않음).
example: 7.71
deprecated: true
uiAmountString:
type: string
description: 소수점을 포함한 이 주요 보유자의 토큰 잔액의 표준 문자열 표현입니다.
example: '7.71'
examples:
tokenResponse:
$ref: '#/components/examples/tokenLargestAccountsResponse'
'400':
description: 잘못된 요청 - 요청 매개변수가 유효하지 않거나 요청이 잘못되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 인증되지 않음 - API 키가 유효하지 않거나 누락되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: 요청이 너무 많음 - 할당량을 초과했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: 서비스 불가 - 서비스가 일시적으로 사용 불가입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: 게이트웨이 타임아웃 - 요청 시간이 초과되었습니다.
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: 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)에서 무료로 받을
수 있습니다.
````