> ## 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.
# getTokenAccountsByOwner
> 토큰 소유자별 모든 SPL 토큰 계정을 반환합니다.
**새 기능**: `getTokenAccountsByOwner` 이제 점진적 업데이트를 위한 `changedSinceSlot` 매개변수를 지원합니다. 지정된 경우, 메서드는 주어진 슬롯 번호에서 변경된 토큰 계정만 반환합니다. 이는 토큰 잔액 변화 및 포트폴리오 업데이트 추적에 이상적입니다.
## 요청 매개변수
토큰 보유를 조회할 계정 소유자의 Solana 지갑 주소(pubkey)로, base-58로 인코딩된 문자열입니다.
특정 토큰 또는 NFT에 대한 계정만 검색하려는 Solana 토큰 민트 주소입니다.
토큰 계정을 생성한 특정 Solana 토큰 프로그램 ID(일반적으로 SPL 토큰 프로그램)입니다.
요청에 대한 커밋먼트 레벨입니다.
* `confirmed`
* `finalized`
* `processed`
요청을 평가할 수 있는 최소 슬롯입니다.
계정의 데이터에서 슬라이스를 요청합니다.
반환할 바이트 수입니다.
읽기를 시작할 바이트 오프셋입니다.
계정 데이터의 인코딩 형식입니다.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
이 슬롯 번호에서 변경된 계정만 반환합니다. 점진적 업데이트에 유용합니다.
## OpenAPI
````yaml ko/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Solana 블록체인의 모든 지갑 주소와 관련된 SPL 토큰 잔액, NFT 및 기타 토큰 보유를 검색하기 위한 종합적인 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: getTokenAccountsByOwner
description: |-
특정 Solana 지갑 주소가 소유한 모든 SPL 토큰 계정을 강력한 필터링 옵션으로 검색합니다.
이 필수 API는 개발자가 대체 가능한 토큰과 NFT를 포함한 전체 토큰 보유를 발견할 수 있도록 하며,
특정 토큰 민트로 필터링하거나 특정 토큰 프로그램에 의해 생성된 계정으로 제한할 수 있는 기능을 제공합니다.
균형, 소수점, 소유권 상태를 포함한 사람이 읽을 수 있는 토큰 정보를 지원하는 구문 분석된 데이터를 제공합니다.
지갑, 포트폴리오 추적기 및 포괄적인 토큰 보유 데이터를 필요로 하는 DeFi 애플리케이션에 중요합니다.
operationId: getTokenAccountsByOwner
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:
- getTokenAccountsByOwner
description: 호출할 RPC 메서드의 이름입니다.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: 특정 공개 키가 소유한 토큰 계정을 쿼리하기 위한 매개변수입니다.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
기록될 토큰 보유에 대한 계정 소유자의 Solana 지갑 주소(pubkey)로 base-58로
인코딩된 문자열입니다.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: 민트 주소나 프로그램 ID별로 토큰 계정을 분류하는 필터 구성입니다.
properties:
mint:
type: string
description: >-
특정 토큰이나 NFT에 대해서만 계정을 검색하기 위한 특정 Solana 토큰 민트
주소입니다.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
토큰 계정을 생성한 특정 Solana 토큰 프로그램 ID(일반적으로 SPL 토큰
프로그램)입니다.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: 선택적 필드를 가진 구성 객체입니다.
properties:
commitment:
type: string
description: 요청에 대한 커밋 수준입니다.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: 요청이 평가될 수 있는 최소 슬롯입니다.
example: 1000
dataSlice:
type: object
description: 계정의 데이터 일부를 요청합니다.
properties:
length:
type: integer
description: 반환할 바이트 수입니다.
example: 10
offset:
type: integer
description: 시작할 바이트 오프셋입니다.
example: 0
encoding:
type: string
description: 계정 데이터의 인코딩 형식입니다.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: 이 슬롯 번호에서 수정된 계정만 반환합니다. 증분 업데이트에 유용합니다.
example: 464175999
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:
apiVersion:
type: string
description: API 버전입니다.
example: 2.0.15
slot:
type: integer
description: 데이터가 가져온 슬롯입니다.
example: 341197933
value:
type: array
description: 토큰 계정 목록입니다.
items:
type: object
properties:
pubkey:
type: string
description: base-58로 인코딩된 문자열로서의 계정 Pubkey입니다.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: 토큰 계정 세부 정보입니다.
properties:
lamports:
type: integer
description: 계정에 지정된 램포트 수입니다.
example: 2039280
owner:
type: string
description: 이 계정에 할당된 프로그램의 Pubkey입니다.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: 계정에 연결된 토큰 상태 데이터입니다.
properties:
program:
type: string
description: 프로그램 이름입니다.
example: spl-token
parsed:
type: object
description: 구문 분석된 토큰 데이터입니다.
properties:
info:
type: object
description: 토큰 계정 정보입니다.
properties:
isNative:
type: boolean
description: 계정이 원래의 SOL을 보유하는지 여부를 나타냅니다.
example: false
mint:
type: string
description: 토큰 민트의 Pubkey입니다.
example: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: 계정 소유자의 Pubkey입니다.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: 토큰 계정 상태입니다.
example: initialized
tokenAmount:
type: object
description: 토큰 양 세부 정보입니다.
properties:
amount:
type: string
description: 소수점 없이 원시 균형입니다.
example: '420000000000000'
decimals:
type: integer
description: 소수점 수입니다.
example: 6
uiAmount:
type: number
description: 사용자 친화적인 형식의 균형입니다.
example: 420000000
uiAmountString:
type: string
description: 문자열로서의 균형입니다.
example: '420000000'
space:
type: integer
description: 계정에 할당된 공간입니다.
example: 165
executable:
type: boolean
description: 계정에 프로그램이 포함되어 있는지 여부를 나타냅니다.
example: false
rentEpoch:
type: integer
description: 계정이 다음에 임대료를 지불할 시점의 에포크입니다.
example: 18446744073709552000
space:
type: integer
description: 계정의 데이터 크기입니다.
example: 165
example:
jsonrpc: '2.0'
id: '1'
result:
context:
apiVersion: 2.0.15
slot: 341197933
value:
- pubkey: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
lamports: 2039280
owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
program: spl-token
parsed:
info:
isNative: false
mint: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state: initialized
tokenAmount:
amount: '420000000000000'
decimals: 6
uiAmount: 420000000
uiAmountString: '420000000'
space: 165
executable: false
rentEpoch: 18446744073709552000
space: 165
'400':
description: 잘못된 요청 - 잘못된 요청 매개변수 또는 잘못된 요청입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: 잘못된 매개변수
id: '1'
'401':
description: 권한 없음 - 잘못된 API 키 또는 누락된 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)에서 무료로
받을 수 있습니다.
````