> ## 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.
# getTokenAccountBalance
> SPL 토큰 계정의 토큰 잔액을 반환합니다.
## 요청 매개변수
솔라나 SPL 토큰 계정 주소로, base-58로 인코딩된 문자열 형태로 잔액 정보를 조회합니다.
요청에 대한 커밋 수준.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml ko/openapi/rpc-http/getTokenAccountBalance.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
펑기블 토큰 및 NFT 잔액에 접근하기 위한 빠르고 신뢰할 수 있는 Solana SPL 토큰 잔액 검색 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: getTokenAccountBalance
description: >
올바른 소수점 형식을 사용하여 Solana 토큰 계정에서 SPL 토큰 잔액을 검색합니다.
이 필수 API는 펑기블 토큰 잔액, NFT 보유량 및 기타 SPL 토큰 데이터에 대한 액세스를 제공하며, 정확한 표시를 위한
토큰별 소수 자릿수를 지원합니다.
지갑, DeFi 애플리케이션, 거래소 및 사용자에게 토큰 잔액을 표시해야 하는 서비스에 필수적인 사람이 읽을 수 있는 금액과 함께
원시 및 형식화된 잔액을 모두 반환합니다.
operationId: getTokenAccountBalance
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:
- getTokenAccountBalance
description: 호출할 RPC 메서드의 이름입니다.
example: getTokenAccountBalance
default: getTokenAccountBalance
params:
type: array
description: 토큰 계정 잔액을 쿼리하기 위한 매개변수입니다.
default:
- 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
items:
oneOf:
- type: string
description: >-
잔액 정보를 쿼리하기 위한 Solana SPL 토큰 계정 주소로, base-58로 인코딩된
문자열입니다.
example: 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa
- 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: object
description: 토큰 계정 잔액 세부 정보입니다.
properties:
amount:
type: string
description: 소수점 형식이 없는 문자열 정수로 표현된 원시 Solana 토큰 잔액입니다.
example: '9864'
decimals:
type: integer
description: 올바른 표시 형식을 위한 토큰의 발행에서 정의한 소수 자릿수입니다.
example: 2
uiAmount:
type: number
description: 올바른 소수점 형식의 사람이 읽을 수 있는 Solana 토큰 잔액(사용 중단됨)입니다.
example: 98.64
uiAmountString:
type: string
description: 올바른 소수 자릿수로 토큰 잔액의 정식 문자열 표현입니다.
example: '98.64'
examples:
default:
$ref: '#/components/examples/getTokenAccountBalanceResponse'
'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:
getTokenAccountBalanceResponse:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 1114
value:
amount: '9864'
decimals: 2
uiAmount: 98.64
uiAmountString: '98.64'
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)에서 무료로
받을 수 있습니다.
````