> ## 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.
# getCompressedTokenAccountsByOwner
> Retourne les comptes de tokens compressés détenus par un certain compte.
## Paramètres de requête
Curseur de pagination pour récupérer des ensembles subséquents de comptes de tokens compressés dans des portefeuilles Solana avec de grandes possessions
Nombre maximum de comptes de tokens compressés à retourner par requête (pour la pagination)
Filtrer les comptes de tokens compressés par une adresse de mint de token Solana spécifique
Une clé publique Solana représentée comme une chaîne base58 pour les adresses de comptes et de portefeuilles.
## OpenAPI
````yaml fr/openapi/zk-compression/getCompressedTokenAccountsByOwner.yaml POST /
openapi: 3.0.3
info:
title: API de portefeuille de tokens compressés Solana
description: >
Indexeur avancé de Solana pour les comptes de tokens compressés utilisant la
technologie de compression d'état pour un stockage et une récupération des
tokens efficaces et économiques.
Cette API fournit un accès optimisé aux tokens et NFT compressés de Solana,
permettant des économies de coûts allant jusqu'à 1000x tout en maintenant
une sécurité totale et une compatibilité avec l'écosystème de tokens Solana.
Idéal pour les applications de portefeuille, les marchés et les dApps basés
sur des tokens
nécessitant une gestion efficace du portefeuille pour les actifs compressés.
license:
name: Apache-2.0
version: 0.50.0
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:
/:
summary: getCompressedTokenAccountsByOwner
post:
description: >
Récupérer tous les comptes de tokens compressés appartenant à une
adresse de portefeuille Solana spécifique.
Ce point de terminaison de portefeuille fournit des données complètes
sur les stocks de tokens SPL compressés et de NFT avec
des économies de coûts significatives grâce à la technologie de
compression d'état de Solana. Filtrer les résultats par adresse de
menthe,
paginer efficacement au travers de grandes collections et accéder à des
données de compte détaillées avec une vérification complète de la
propriété.
Principaux avantages :
- Réduction des coûts de stockage sur chaîne pour les comptes de tokens
(jusqu'à 1000x économies)
- Prise en charge des intégrations de portefeuille à grande échelle avec
pagination efficace
- Compatibilité avec le standard de token SPL de Solana et les NFT
compressés
- Filtrage spécifique à la menthe pour des requêtes de tokens ciblées
- Données complètes des comptes de tokens, y compris les soldes, les
délégués et les états
operationId: getCompressedTokenAccountsByOwner
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: La version du protocole JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Un identifiant pour identifier la requête.
default: '1'
method:
type: string
description: Le nom de la méthode à invoquer.
enum:
- getCompressedTokenAccountsByOwner
default: getCompressedTokenAccountsByOwner
params:
type: object
required:
- owner
properties:
cursor:
allOf:
- $ref: '#/components/schemas/Base58String'
nullable: true
description: >-
Curseur de pagination pour récupérer des ensembles
subséquents de comptes de tokens compressés dans les
portefeuilles Solana avec de grandes possessions
limit:
allOf:
- $ref: '#/components/schemas/Limit'
nullable: true
description: >-
Nombre maximum de comptes de tokens compressés à
retourner par requête (pour la pagination)
mint:
allOf:
- $ref: '#/components/schemas/SerializablePubkey'
nullable: true
description: >-
Filtrer les comptes de tokens compressés par adresse de
menthe de token Solana spécifique
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
L'adresse de portefeuille Solana qui possède les comptes
de tokens compressés à récupérer
additionalProperties: false
required: true
responses:
'200':
description: >-
Comptes de tokens compressés récupérés avec succès depuis la
blockchain Solana pour le propriétaire de portefeuille spécifié
content:
application/json:
schema:
type: object
required:
- context
- value
properties:
context:
$ref: '#/components/schemas/Context'
value:
$ref: '#/components/schemas/TokenAccountList'
additionalProperties: false
'400':
description: >-
Mauvaise requête - Paramètres de requête invalides ou requête mal
formé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 taux 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:
Base58String:
type: string
description: >-
Une chaîne encodée en base 58 utilisée pour les adresses et identifiants
Solana.
default: 3J98t1WpEZ73CNm
example: 3J98t1WpEZ73CNm
Limit:
type: integer
format: int64
minimum: 0
description: >-
Nombre maximum de comptes de tokens compressés à retourner dans une
seule requête
SerializablePubkey:
type: string
description: >-
Une clé publique Solana représentée comme une chaîne base58 pour les
adresses de compte et portefeuilles.
default: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
example: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
Context:
type: object
required:
- slot
properties:
slot:
type: integer
default: 100
example: 100
description: Slot actuel de la blockchain Solana pour cette réponse
TokenAccountList:
type: object
required:
- items
properties:
cursor:
$ref: '#/components/schemas/Base58String'
description: >-
Curseur de pagination pour récupérer le prochain ensemble de comptes
de tokens compressés dans les requêtes ultérieures
items:
type: array
items:
$ref: '#/components/schemas/TokenAcccount'
description: >-
Tableau des comptes de tokens compressés possédés par l'adresse de
portefeuille Solana spécifiée
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'
TokenAcccount:
type: object
required:
- account
- tokenData
properties:
account:
$ref: '#/components/schemas/Account'
description: >-
Informations sur le compte compressé pour le compte de token sur
Solana, y compris la position dans l'arbre et les données de
vérification
tokenData:
$ref: '#/components/schemas/TokenData'
description: >-
Données spécifiques au token, y compris le solde, la menthe, le
propriétaire et le statut de délégation
additionalProperties: false
Account:
type: object
required:
- hash
- owner
- lamports
- tree
- leafIndex
- seq
- slotCreated
properties:
address:
$ref: '#/components/schemas/SerializablePubkey'
description: L'adresse unique du compte compressé sur Solana
data:
$ref: '#/components/schemas/AccountData'
description: Données de compte stockées dans un format compressé sur Solana
hash:
$ref: '#/components/schemas/Hash'
description: >-
Hash cryptographique des données du compte compressé pour
vérification
lamports:
$ref: '#/components/schemas/UnsignedInteger'
description: Solde en lamports associé au compte compressé
leafIndex:
$ref: '#/components/schemas/UnsignedInteger'
description: >-
Position d'index dans l'arbre de merkle où le compte compressé est
stocké
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: Programme Solana qui possède ce compte compressé
seq:
$ref: '#/components/schemas/UnsignedInteger'
description: >-
Numéro de séquence pour le suivi des mises à jour du compte
compressé
slotCreated:
$ref: '#/components/schemas/UnsignedInteger'
description: Slot de la blockchain Solana lors de la création du compte compressé
tree:
$ref: '#/components/schemas/SerializablePubkey'
description: Adresse de l'arbre de merkle contenant ce compte compressé
additionalProperties: false
TokenData:
type: object
required:
- mint
- owner
- amount
- state
properties:
amount:
$ref: '#/components/schemas/UnsignedInteger'
description: Montant du solde de tokens détenu dans ce compte de token compressé
delegate:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
Adresse de délégué optionnelle autorisée à effectuer des opérations
sur ce compte de token compressé
mint:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
L'adresse de menthe de token SPL Solana à laquelle ce compte de
token compressé appartient
owner:
$ref: '#/components/schemas/SerializablePubkey'
description: >-
L'adresse de portefeuille Solana qui possède ce compte de token
compressé
state:
$ref: '#/components/schemas/AccountState'
description: État actuel du compte de token compressé (initialisé ou gelé)
tlv:
$ref: '#/components/schemas/Base64String'
description: >-
Données encodées optionnelles type-longueur-valeur pour des
informations de compte de token étendues
AccountData:
type: object
required:
- discriminator
- data
- dataHash
properties:
data:
$ref: '#/components/schemas/Base64String'
description: Données encodées en Base64 du compte Solana compressé
dataHash:
$ref: '#/components/schemas/Hash'
description: >-
Hash des données du compte compressé pour vérification de
l'intégrité
discriminator:
$ref: '#/components/schemas/UnsignedInteger'
description: Identifiant pour le type de compte dans le programme Solana
additionalProperties: false
Hash:
type: string
description: >-
Un hash cryptographique de 32 octets représenté comme une chaîne base58
pour la vérification des données Solana.
example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
UnsignedInteger:
type: integer
default: 100
example: 100
description: >-
Valeur entière non négative utilisée pour les montants de tokens,
numéros de séquence et autres valeurs numériques
AccountState:
type: string
enum:
- initialized
- frozen
description: État actuel du compte de token compressé (initialisé ou gelé)
Base64String:
type: string
description: >-
Une chaîne encodée en base 64 pour stocker des données binaires dans les
comptes Solana compressés.
default: SGVsbG8sIFdvcmxkIQ==
example: SGVsbG8sIFdvcmxkIQ==
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).
````