> ## 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
> getTokenAccountsByOwner mengembalikan setiap akun SPL Token yang dimiliki oleh dompet Solana, yang difilter berdasarkan mint atau program token, dengan sinkronisasi inkremental changedSinceSlot.
**Fitur Baru**: `getTokenAccountsByOwner` kini mendukung parameter `changedSinceSlot` untuk pembaruan inkremental. Jika ditentukan, metode ini hanya mengembalikan akun token yang telah diubah pada atau setelah nomor slot yang diberikan. Fitur ini ideal untuk melacak perubahan saldo token dan pembaruan portofolio.
## Parameter Permintaan
Alamat dompet Solana (pubkey) milik pemilik akun yang kepemilikan tokennya ingin dikueri, sebagai string yang dienkode dengan base-58.
Alamat mint token Solana tertentu untuk mengambil hanya akun milik token atau NFT tertentu.
ID program token Solana tertentu (biasanya program SPL Token) yang membuat akun token tersebut.
Tingkat komitmen untuk permintaan.
* `confirmed`
* `finalized`
* `processed`
Slot minimum tempat permintaan dapat dievaluasi.
Meminta sebagian data akun.
Jumlah byte yang akan dikembalikan.
Offset byte tempat pembacaan dimulai.
Format pengodean untuk data akun.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Hanya kembalikan akun yang diubah pada atau setelah nomor slot ini. Berguna untuk pembaruan inkremental.
## OpenAPI
````yaml id/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API komprehensif untuk menemukan akun token Solana guna mengambil saldo
token SPL, NFT, dan kepemilikan token lainnya yang terkait dengan alamat
dompet apa pun di blockchain Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountsByOwner
description: >
Ambil semua akun token SPL yang dimiliki oleh alamat dompet Solana
tertentu dengan opsi pemfilteran yang andal.
API penting ini memungkinkan pengembang menemukan seluruh kepemilikan
token, termasuk token fungibel dan NFT,
dengan kemampuan untuk memfilter berdasarkan mint token tertentu atau
membatasi hasil pada akun yang dibuat oleh program token tertentu.
Mendukung data yang telah diurai untuk informasi token yang mudah
dibaca, termasuk saldo, jumlah desimal, dan status kepemilikan.
Sangat penting untuk dompet, pelacak portofolio, dan aplikasi DeFi yang
memerlukan data kepemilikan token yang komprehensif.
operationId: getTokenAccountsByOwner
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Versi protokol JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Pengidentifikasi unik untuk permintaan.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountsByOwner
description: Nama metode RPC yang akan dipanggil.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: >-
Parameter untuk mengueri akun token yang dimiliki oleh kunci
publik tertentu.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Alamat dompet Solana (pubkey) milik pemilik akun yang
kepemilikan tokennya akan dikueri, sebagai string yang
dikodekan dalam base-58.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Konfigurasi filter untuk mempersempit akun token
berdasarkan alamat mint atau ID program.
properties:
mint:
type: string
description: >-
Alamat mint token Solana tertentu untuk hanya
mengambil akun bagi token atau NFT tertentu.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
ID program token Solana tertentu (biasanya program
Token SPL) yang membuat akun token.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objek konfigurasi dengan bidang opsional.
properties:
commitment:
type: string
description: Tingkat komitmen untuk permintaan.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: Slot minimum tempat permintaan dapat dievaluasi.
example: 1000
dataSlice:
type: object
description: Minta sebagian data akun.
properties:
length:
type: integer
description: Jumlah byte yang akan dikembalikan.
example: 10
offset:
type: integer
description: Offset byte untuk mulai membaca.
example: 0
encoding:
type: string
description: Format pengodean untuk data Akun.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: >-
Hanya kembalikan akun yang diubah pada atau
setelah nomor slot ini. Berguna untuk pembaruan
inkremental.
example: 464175999
responses:
'200':
description: Berhasil mengambil akun token berdasarkan pemilik.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Pengidentifikasi yang cocok dengan permintaan.
example: '1'
result:
type: object
description: Konteks dan detail akun.
properties:
context:
type: object
description: Konteks respons.
properties:
apiVersion:
type: string
description: Versi API.
example: 2.0.15
slot:
type: integer
description: Slot tempat data diambil.
example: 341197933
value:
type: array
description: Daftar akun token.
items:
type: object
properties:
pubkey:
type: string
description: >-
Pubkey akun sebagai string yang dikodekan dalam
base-58.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Detail akun token.
properties:
lamports:
type: integer
description: Jumlah lamport yang dialokasikan ke akun.
example: 2039280
owner:
type: string
description: Pubkey program tempat akun ini dialokasikan.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: Data status token yang terkait dengan akun.
properties:
program:
type: string
description: Nama program.
example: spl-token
parsed:
type: object
description: Data token yang telah diurai.
properties:
info:
type: object
description: Informasi akun token.
properties:
isNative:
type: boolean
description: >-
Menunjukkan apakah akun menyimpan SOL
native.
example: false
mint:
type: string
description: Pubkey mint token.
example: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: Pubkey pemilik akun.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: Status akun token.
example: initialized
tokenAmount:
type: object
description: Detail jumlah token.
properties:
amount:
type: string
description: Saldo mentah tanpa desimal.
example: '420000000000000'
decimals:
type: integer
description: Jumlah tempat desimal.
example: 6
uiAmount:
type: number
description: >-
Saldo dalam format yang mudah dibaca
pengguna.
example: 420000000
uiAmountString:
type: string
description: Saldo sebagai string.
example: '420000000'
space:
type: integer
description: Ruang yang dialokasikan untuk akun.
example: 165
executable:
type: boolean
description: Menunjukkan apakah akun berisi program.
example: false
rentEpoch:
type: integer
description: >-
Epoch saat akun harus membayar sewa
berikutnya.
example: 18446744073709552000
space:
type: integer
description: Ukuran data akun.
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: >-
Permintaan Buruk - Parameter permintaan tidak valid atau permintaan
salah format.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Tidak Diotorisasi - Kunci API tidak valid atau tidak ada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Terlalu Banyak Permintaan - Batas laju terlampaui.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Kesalahan Server Internal - Terjadi kesalahan pada server.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Layanan Tidak Tersedia - Layanan untuk sementara tidak tersedia.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Batas Waktu Gateway - Waktu permintaan habis.
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
description: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Kode kesalahan.
example: -32602
message:
type: string
description: Pesan kesalahan.
data:
type: object
description: Data tambahan tentang kesalahan.
id:
type: string
description: Pengidentifikasi yang cocok dengan permintaan.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Kunci API Helius Anda. Anda bisa mendapatkannya secara gratis di
[dasbor](https://dashboard.helius.dev/api-keys).
````