> ## 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 renvoie chaque compte de jeton SPL détenu par un portefeuille Solana, filtré par mint ou programme de jeton, avec des synchronisations incrémentielles changedSinceSlot.
**Nouvelle fonctionnalité** : `getTokenAccountsByOwner` prend désormais en charge le paramètre `changedSinceSlot` pour des mises à jour incrémentielles. Lorsqu'il est spécifié, la méthode ne renvoie que les comptes de jetons qui ont été modifiés à partir du numéro de slot donné. Cela est idéal pour suivre les changements de solde de jetons et les mises à jour de portefeuille.
## Paramètres de requête
Adresse du portefeuille Solana (pubkey) du propriétaire du compte pour interroger les avoirs en jetons, sous forme de chaîne encodée en base-58.
Adresse de mint du jeton Solana spécifique pour récupérer uniquement les comptes pour un jeton ou un NFT particulier.
ID de programme de jeton Solana spécifique (typiquement programme SPL Token) qui a créé les comptes de jetons.
Le niveau d'engagement pour la requête.
* `confirmed`
* `finalized`
* `processed`
Le slot minimum auquel la requête peut être évaluée.
Demander une tranche des données du compte.
Nombre d'octets à retourner.
Décalage en octets à partir duquel commencer la lecture.
Format d'encodage pour les données de compte.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Retourner uniquement les comptes qui ont été modifiés à partir de ce numéro de slot. Utile pour les mises à jour incrémentielles.
## OpenAPI
````yaml fr/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de découverte de comptes de tokens Solana complet pour récupérer les
soldes de tokens SPL, les NFT et autres possessions de tokens associées à
toute adresse de portefeuille sur la 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: Point de terminaison RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Point de terminaison RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenAccountsByOwner
description: >
Récupère tous les comptes de tokens SPL détenus par une adresse de
portefeuille Solana spécifique avec des options de filtrage puissantes.
Cette API essentielle permet aux développeurs de découvrir des
possessions complètes de tokens, y compris les tokens fongibles et les
NFT,
avec la possibilité de filtrer par frappes de tokens spécifiques ou de
limiter aux comptes créés par des programmes de tokens particuliers.
Supporte les données analysées pour des informations de tokens lisibles
par l'homme, y compris les soldes, les décimales et le statut de
propriété.
Critique pour les portefeuilles, les suiveurs de portefeuille et les
applications DeFi qui ont besoin de données complètes sur les
possessions de tokens.
operationId: getTokenAccountsByOwner
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La version du protocole JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identifiant unique pour la requête.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenAccountsByOwner
description: Le nom de la méthode RPC à invoquer.
example: getTokenAccountsByOwner
default: getTokenAccountsByOwner
params:
type: array
description: >-
Paramètres pour interroger les comptes de tokens détenus par
une clé publique spécifique.
default:
- A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- encoding: jsonParsed
items:
oneOf:
- type: string
description: >-
Adresse du portefeuille Solana (clé publique) du
propriétaire du compte pour lequel interroger les
possessions de tokens, sous forme de chaîne encodée en
base-58.
example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
- type: object
description: >-
Configuration du filtre pour affiner les comptes de
tokens par adresse de frappe ou ID de programme.
properties:
mint:
type: string
description: >-
Adresse de frappe spécifique d'un token Solana
pour récupérer uniquement les comptes pour un
token ou un NFT particulier.
example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
programId:
type: string
description: >-
ID de programme de token Solana spécifique
(généralement programme de token SPL) qui a créé
les comptes de token.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
- type: object
description: Objet de configuration avec des champs optionnels.
properties:
commitment:
type: string
description: Le niveau d'engagement pour la requête.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
Le slot minimum auquel la requête peut être
évaluée.
example: 1000
dataSlice:
type: object
description: Demander une tranche des données du compte.
properties:
length:
type: integer
description: Nombre d'octets à retourner.
example: 10
offset:
type: integer
description: >-
Décalage en octets à partir duquel commencer
la lecture.
example: 0
encoding:
type: string
description: Format d'encodage pour les données du compte.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: jsonParsed
changedSinceSlot:
type: integer
description: >-
Retourner uniquement les comptes qui ont été
modifiés à ce slot ou après. Utile pour les mises
à jour incrémentielles.
example: 464175999
responses:
'200':
description: Récupération réussie des comptes de tokens par propriétaire.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La version du protocole JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identifiant correspondant à la requête.
example: '1'
result:
type: object
description: Contexte et détails du compte.
properties:
context:
type: object
description: Contexte de la réponse.
properties:
apiVersion:
type: string
description: Version de l'API.
example: 2.0.15
slot:
type: integer
description: Slot dans lequel les données ont été récupérées.
example: 341197933
value:
type: array
description: Liste des comptes de tokens.
items:
type: object
properties:
pubkey:
type: string
description: >-
Pubkey du compte sous forme de chaîne encodée en
base-58.
example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
account:
type: object
description: Détails du compte de tokens.
properties:
lamports:
type: integer
description: Nombre de lamports assignés au compte.
example: 2039280
owner:
type: string
description: >-
Pubkey du programme auquel ce compte a été
assigné.
example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
data:
type: object
description: Données d'état du token associées au compte.
properties:
program:
type: string
description: Nom du programme.
example: spl-token
parsed:
type: object
description: Données du token analysées.
properties:
info:
type: object
description: Informations sur le compte de token.
properties:
isNative:
type: boolean
description: >-
Indique si le compte détient du SOL
natif.
example: false
mint:
type: string
description: Pubkey de la frappe du token.
example: >-
2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
owner:
type: string
description: Pubkey du propriétaire du compte.
example: >-
A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
state:
type: string
description: État du compte de token.
example: initialized
tokenAmount:
type: object
description: Détails du montant du token.
properties:
amount:
type: string
description: Solde brut sans décimales.
example: '420000000000000'
decimals:
type: integer
description: Nombre de décimales.
example: 6
uiAmount:
type: number
description: Solde au format convivial.
example: 420000000
uiAmountString:
type: string
description: Solde sous forme de chaîne.
example: '420000000'
space:
type: integer
description: Espace alloué pour le compte.
example: 165
executable:
type: boolean
description: Indique si le compte contient un programme.
example: false
rentEpoch:
type: integer
description: >-
Époque à laquelle le compte devra payer le
loyer.
example: 18446744073709552000
space:
type: integer
description: Taille des données du compte.
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: >-
Requête incorrecte - Paramètres de requête invalides ou requête
malformée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Non autorisé - Clé API invalide ou manquante.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Trop de requêtes - Limite de débit dépassée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: >-
Erreur interne du serveur - Une erreur s'est produite sur le
serveur.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Service indisponible - Le service est temporairement indisponible.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Délai d'attente de la passerelle - La requête a expiré.
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: La version du protocole JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Le code d'erreur.
example: -32602
message:
type: string
description: Le message d'erreur.
data:
type: object
description: Données supplémentaires sur l'erreur.
id:
type: string
description: Identifiant correspondant à la requête.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement dans le
[tableau de bord](https://dashboard.helius.dev/api-keys).
````