> ## 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.
# getBalance
> 제공된 Pubkey의 계정의 lamport 잔액을 반환합니다.
## 요청 매개변수
쿼리할 계정의 Pubkey(base-58 인코딩된 문자열)입니다.
요청에 대한 커밋 수준입니다.
* `processed`
* `confirmed`
* `finalized`
요청이 평가될 수 있는 최소 슬롯입니다.
## OpenAPI
````yaml ko/openapi/rpc-http/getBalance.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
다양한 최종성 보장을 위한 구성 가능한 커밋 수준을 통해 계정 SOL 잔액을 가져오는 빠르고 신뢰할 수 있는 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: 메인넷 RPC 엔드포인트
- url: https://devnet.helius-rpc.com
description: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getBalance
description: >
구성 가능한 최종 수준으로 모든 Solana 지갑 주소에 대한 기본 SOL 잔액을 검색합니다. 이 필수 API는
lamports(1 SOL = 1,000,000,000 lamports) 단위로 계정 잔액에 빠르게 접근할 수 있으며, 속도와
최종성 보장을 균형 있게 지원하기 위해 다양한 커밋 수준을 지원합니다. 지갑, 금융 애플리케이션, 거래 플랫폼 및 실시간으로
Solana 계정 잔액을 추적해야 하는 서비스에 매우 중요합니다.
operationId: getBalance
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC 프로토콜 버전입니다.
default: '2.0'
id:
type: string
description: 요청의 고유 식별자입니다.
example: '1'
default: '1'
method:
type: string
enum:
- getBalance
description: 호출할 RPC 메서드의 이름입니다.
default: getBalance
params:
type: array
description: 요청에 대한 매개변수입니다.
default:
- 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
items:
oneOf:
- type: string
description: 쿼리할 계정의 공개 키(base-58 인코딩 문자열)입니다.
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- type: object
description: 요청에 대한 추가 구성 옵션입니다.
properties:
commitment:
type: string
description: 요청에 대한 커밋 수준입니다.
enum:
- processed
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: 요청을 평가할 수 있는 최소 슬롯입니다.
example: 1
responses:
'200':
description: 성공적으로 계정 잔액을 조회했습니다.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
type: string
result:
type: object
properties:
context:
type: object
properties:
slot:
type: integer
description: 반환된 정보의 슬롯입니다.
example: 1
value:
type: integer
description: 계정 잔액(lamports)입니다.
example: 0
'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:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
message:
type: string
id:
type: string
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
귀하의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
받으실 수 있습니다.
````