> ## 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. # getEncryptedUtxosByTags > Récupérez les sorties UTXO chiffrées correspondant à des balises de visualisation ou à un anneau spécifique. ## Sorties chiffrées Utilisez cette méthode pour obtenir des UTXO chiffrées à déchiffrer côté client. Votre portefeuille déchiffre les sorties et additionne les montants non dépensés de chaque actif afin de déterminer son solde privé. Cette méthode est comparable à la méthode [`getTokenAccountsByOwner`](https://solana.com/docs/rpc/http/gettokenaccountsbyowner) de Solana, qui renvoie les comptes de jetons SPL appartenant à une adresse. Un solde privé est stocké dans des UTXO, et non dans des comptes Solana. Il nécessite donc une méthode RPC dédiée. En savoir plus sur [l’état privé et les UTXO](https://www.helius.dev/docs/fr/privacy/concepts/utxo.md). La méthode renvoie les sorties correspondantes dans `result.data`, regroupées par transaction Solana. Chaque entrée inclut les valeurs `slot` et `signature` de la transaction. Une sortie inclut son texte chiffré, sa balise de visualisation, son engagement, l’ID de l’arbre et l’index de la feuille. La réponse inclut des sorties historiques qui peuvent déjà avoir été dépensées. Votre portefeuille doit suivre les annulateurs pour déterminer le solde disponible. Consultez le [guide sur le solde privé](https://www.helius.dev/docs/fr/privacy/guides/read-balance.md). Un tableau `tags` vide nécessite `ringProgramId` et sélectionne les sorties de cet anneau. Lorsque les deux sont fournis, les sorties doivent correspondre aux balises et à l’anneau. Consultez la section [pagination et fraîcheur des données](https://www.helius.dev/docs/fr/api-reference/privacy.md#pagination) pour connaître les limites de page, les jetons de continuation et les lectures incrémentielles. ## Paramètres de la requête **filters** `object` Bornes de slot. Reprenez une lecture à jour et sans limite en définissant `slot.gt` sur la valeur `context.slot` de la dernière page. **filters.slot** `object` Bornes de slot pour la lecture. Les bornes fournies sont combinées avec l’opérateur AND. **filters.slot.gt** `number` Inclut uniquement les transactions postérieures à ce slot. **filters.slot.gte** `number` Inclut uniquement les transactions correspondant à ce slot ou postérieures à celui-ci. **filters.slot.lt** `number` Inclut uniquement les transactions antérieures à ce slot. **filters.slot.lte** `number` Inclut uniquement les transactions correspondant à ce slot ou antérieures à celui-ci. **limit** `number` (default: 1000) Nombre maximal de transactions Solana par page, de 1 à 1 000. **minContextSlot** `number` Slot minimal enregistré par l’indexeur requis pour cette lecture. Renvoie l’erreur JSON-RPC -32016 si l’indexeur est en retard. **paginationToken** `string` Jeton de continuation provenant de la réponse précédente. Renvoyez-le sans le modifier, avec les mêmes balises, le même anneau et les mêmes filtres de slot. **ringProgramId** `string` Limite les résultats à l’anneau autorisé par cet ID de programme. Requis lorsque tags est vide. **tags** `array` *required* Balises de visualisation de 32 octets encodées en Base58. 1 000 au maximum. Un tableau vide nécessite ringProgramId et sélectionne cet anneau. ## OpenAPI ````yaml fr/openapi/privacy/getEncryptedUtxosByTags.yaml POST /v1/spr/getEncryptedUtxosByTags openapi: 3.0.3 info: title: API Solana Privacy Rings version: 0.51.2 description: >- API JSON-RPC de l'indexeur de confidentialité pour les états chiffrés, l'historique, les preuves et les enregistrements du registre public. servers: - url: https://devnet.helius-rpc.com description: API Solana Privacy Rings du Devnet security: [] paths: /v1/spr/getEncryptedUtxosByTags: post: summary: getEncryptedUtxosByTags description: >- Récupère les sorties UTXO chiffrées correspondant aux balises de visualisation ou à un anneau spécifique. operationId: getEncryptedUtxosByTags requestBody: content: application/json: schema: type: object required: - jsonrpc - id - method - params properties: id: type: string description: Un ID permettant d'identifier la requête. default: '1' jsonrpc: type: string description: La version du protocole JSON-RPC. enum: - '2.0' default: '2.0' method: type: string description: >- La méthode à invoquer. Elle doit correspondre au dernier segment du chemin de l'URL. enum: - getEncryptedUtxosByTags default: getEncryptedUtxosByTags params: type: object required: - tags properties: filters: allOf: - $ref: '#/components/schemas/HistoryFilters' description: >- Limites des slots. Reprenez une lecture à jour et sans limite avec `slot.gt` défini sur le `context.slot` de la dernière page. limit: type: integer format: uint64 maximum: 1000 minimum: 1 nullable: true default: 1000 description: >- Nombre maximal de transactions Solana par page, de 1 à 1 000. minContextSlot: type: integer format: uint64 minimum: 0 nullable: true description: >- Slot minimal persisté par l'indexeur requis pour cette lecture. Renvoie l'erreur JSON-RPC -32016 si l'indexeur est en retard. paginationToken: type: string description: >- Jeton de continuation de la réponse précédente. Renvoyez-le sans le modifier avec les mêmes balises, le même anneau et les mêmes filtres de slots. nullable: true ringProgramId: type: string description: >- Limite les résultats à l'anneau autorisé par cet ID de programme. Requis lorsque tags est vide. nullable: true tags: type: array items: $ref: '#/components/schemas/Hash' description: >- Balises de visualisation de 32 octets encodées en base58. 1 000 au maximum. Un tableau vide nécessite ringProgramId et sélectionne cet anneau. maxItems: 1000 additionalProperties: false example: tags: - '11111111111111111111111111111112' limit: 100 example: jsonrpc: '2.0' id: '1' method: getEncryptedUtxosByTags params: tags: - '11111111111111111111111111111112' limit: 100 required: true responses: '200': description: Réponse JSON-RPC. Vérifiez error avant de lire result. content: application/json: schema: type: object required: - jsonrpc - id properties: error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true id: type: string description: L'ID de la requête. jsonrpc: type: string description: La version du protocole JSON-RPC. enum: - '2.0' result: type: object description: >- Une page délimitée d'une lecture d'historique, avec une pagination de type gTFA. required: - context - data - paginationToken properties: context: $ref: '#/components/schemas/Context' data: type: array items: type: object description: >- Toutes les sorties correspondantes d'une transaction Solana. required: - slot - signature - outputs properties: outputs: type: array items: $ref: '#/components/schemas/EncryptedUtxoMatch' signature: $ref: '#/components/schemas/SerializableSignature' slot: type: integer format: uint64 minimum: 0 additionalProperties: false outputTreeId: type: integer format: uint16 description: >- L'ID de l'arbre d'état non suspendu le plus récent. Omis lorsqu'il n'est pas disponible. minimum: 0 paginationToken: type: string description: >- Jeton pour la page suivante, null lorsqu'aucun autre résultat ne correspond. Une lecture à jour sans limite `lt` ou `lte` reprend ultérieurement avec `filters.slot.gt` défini sur le `context.slot` de cette page ; une lecture plafonnée couvre uniquement les slots jusqu'à sa limite. nullable: true example: jsonrpc: '2.0' id: '1' result: context: slot: 4242 blockTime: 1730000000 data: [] paginationToken: null '400': description: >- Rejetée avant l'exécution. Une incompatibilité entre la méthode et le chemin, des champs de méthode en double ou une requête par lot renvoie -32601. Un corps illisible ou trop volumineux renvoie -32600. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- L'ID de la requête, ou null lorsque le corps n'est pas un appel JSON-RPC unique. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '429': description: Limite de débit dépassée. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- L'ID de la requête, ou null lorsque le corps n'est pas un appel JSON-RPC unique. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '500': description: Erreur interne du serveur. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- L'ID de la requête, ou null lorsque le corps n'est pas un appel JSON-RPC unique. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true security: - ApiKeyQuery: [] components: schemas: HistoryFilters: type: object description: Limites de slots facultatives pour la requête d'historique. properties: slot: $ref: '#/components/schemas/SlotFilter' additionalProperties: false Hash: type: string description: Un hachage de 32 octets encodé en base58. Context: type: object required: - blockTime - slot properties: blockTime: type: integer format: int64 slot: type: integer format: uint64 description: >- Slot le plus élevé persisté par l'indexeur, pour les contrôles d'actualisation basés sur les slots. minimum: 0 EncryptedUtxoMatch: type: object required: - slot - txSignature - txViewingPk - salt - outputSlot properties: outputSlot: $ref: '#/components/schemas/RingsOutputSlot' salt: type: string description: >- Sel AES au niveau de la transaction, partagé par tous les textes chiffrés de sortie. nullable: true slot: type: integer format: uint64 minimum: 0 txSignature: $ref: '#/components/schemas/SerializableSignature' txViewingPk: type: string description: Une chaîne d'octets encodée en base64. nullable: true SerializableSignature: type: string description: Une signature de transaction Solana de 64 octets encodée en base58. SlotFilter: type: object description: >- Limites de slots pour la lecture. Les limites fournies sont combinées avec l'opérateur AND. properties: gt: type: integer format: uint64 minimum: 0 nullable: true description: Inclut uniquement les transactions postérieures à ce slot. gte: type: integer format: uint64 minimum: 0 nullable: true description: Inclut uniquement les transactions de ce slot ou des slots suivants. lt: type: integer format: uint64 minimum: 0 nullable: true description: Inclut uniquement les transactions antérieures à ce slot. lte: type: integer format: uint64 minimum: 0 nullable: true description: >- Inclut uniquement les transactions de ce slot ou des slots précédents. additionalProperties: false RingsOutputSlot: type: object required: - viewTag - outputContext - payload properties: outputContext: $ref: '#/components/schemas/RingsOutputContext' payload: $ref: '#/components/schemas/Base64String' viewTag: $ref: '#/components/schemas/Hash' RingsOutputContext: type: object required: - hash - tree - treeId - leafIndex properties: hash: $ref: '#/components/schemas/Hash' leafIndex: type: integer format: uint64 minimum: 0 tree: allOf: - $ref: '#/components/schemas/SerializablePubkey' description: >- Compte de l'arbre d'état. Privilégiez treeId ; le compte de l'arbre en est dérivé. deprecated: true treeId: type: integer format: uint16 description: >- L'ID brut de l'arbre sous lequel l'engagement de la sortie est haché. minimum: 0 Base64String: type: string description: Une chaîne d'octets encodée en base64. SerializablePubkey: type: string description: Une clé publique Solana encodée en base58. securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: Votre clé API Helius. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.