> ## 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

> Rufe verschlüsselte UTXO-Ausgänge ab, die mit View-Tags oder einem bestimmten Ring übereinstimmen.

## Verschlüsselte Ausgänge

Rufe mit dieser Methode verschlüsselte UTXOs zur clientseitigen Entschlüsselung ab. Deine Wallet entschlüsselt die Ausgänge und summiert die nicht ausgegebenen Beträge für jeden Vermögenswert, um das private Guthaben zu ermitteln.

Dies entspricht Solanas [`getTokenAccountsByOwner`](https://solana.com/docs/rpc/http/gettokenaccountsbyowner), das die SPL-Token-Konten einer Adresse zurückgibt. Ein privates Guthaben wird in UTXOs und nicht in Solana-Konten gespeichert. Daher ist eine eigene RPC-Methode erforderlich. Weitere Informationen findest du unter [Privater Zustand und UTXOs](https://www.helius.dev/docs/de/privacy/concepts/utxo.md).

Die Methode gibt übereinstimmende Ausgänge in `result.data` zurück, gruppiert nach Solana-Transaktion. Jeder Eintrag enthält `slot` und `signature` der Transaktion. Ein Ausgang enthält seinen Chiffretext, View-Tag, commitment, seine Baum-ID und seinen Blattindex.

Die response enthält historische Ausgänge, die möglicherweise bereits ausgegeben wurden. Deine Wallet muss Nullifier nachverfolgen, um das ausgebbare Guthaben zu ermitteln. Weitere Informationen findest du im [Leitfaden zum privaten Guthaben](https://www.helius.dev/docs/de/privacy/guides/read-balance.md).

Ein leeres `tags`-Array erfordert `ringProgramId` und wählt Ausgänge aus diesem Ring aus. Wenn du beides angibst, müssen die Ausgänge sowohl mit den Tags als auch mit dem Ring übereinstimmen.

Unter [Paginierung und Aktualität](https://www.helius.dev/docs/de/api-reference/privacy.md#paginierung) findest du Informationen zu Seitenlimits, Fortsetzungs-token und inkrementellen Lesevorgängen.

## Parameter des request

**filters** `object`

Grenzen für den slot. Setze `slot.gt` auf `context.slot` der letzten Seite, um einen aufgeholten, unbegrenzten Lesevorgang fortzusetzen.

**filters.slot** `object`

Grenzen für den slot des Lesevorgangs. Angegebene Grenzen werden mit AND verknüpft.

**filters.slot.gt** `number`

Berücksichtigt nur Transaktionen nach diesem slot.

**filters.slot.gte** `number`

Berücksichtigt nur Transaktionen in oder nach diesem slot.

**filters.slot.lt** `number`

Berücksichtigt nur Transaktionen vor diesem slot.

**filters.slot.lte** `number`

Berücksichtigt nur Transaktionen in oder vor diesem slot.

**limit** `number` (default: 1000)

Maximale Anzahl von Solana-Transaktionen pro Seite, von 1 bis 1.000.

**minContextSlot** `number`

Mindestens erforderlicher persistierter slot des Indexers für diesen Lesevorgang. Gibt den JSON-RPC-Fehler -32016 zurück, wenn der Indexer zurückliegt.

**paginationToken** `string`

token für die Fortsetzung aus der vorherigen response. Übergib ihn unverändert mit denselben Tags sowie denselben Ring- und slot-Filtern.

**ringProgramId** `string`

Beschränkt die Ergebnisse auf den von dieser Programm-ID autorisierten Ring. Erforderlich, wenn tags leer ist.

**tags** `array` *required*

Base58-codierte View-Tags mit 32 Byte. Maximal 1.000. Ein leeres Array erfordert ringProgramId und wählt diesen Ring aus.


## OpenAPI

````yaml de/openapi/privacy/getEncryptedUtxosByTags.yaml POST /v1/spr/getEncryptedUtxosByTags
openapi: 3.0.3
info:
  title: Solana Privacy Rings API
  version: 0.51.2
  description: >-
    JSON-RPC API für einen Datenschutzindexer mit verschlüsselten Zuständen,
    Verläufen, Nachweisen und öffentlichen Registereinträgen.
servers:
  - url: https://devnet.helius-rpc.com
    description: Solana Privacy Rings API im Devnet
security: []
paths:
  /v1/spr/getEncryptedUtxosByTags:
    post:
      summary: getEncryptedUtxosByTags
      description: >-
        Rufe verschlüsselte UTXO-Ausgaben ab, die mit Anzeige-Tags oder einem
        bestimmten Ring übereinstimmen.
      operationId: getEncryptedUtxosByTags
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: Eine ID zur Identifizierung des request.
                  default: '1'
                jsonrpc:
                  type: string
                  description: Die Version des JSON-RPC-Protokolls.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: >-
                    Die aufzurufende Methode. Sie muss mit dem letzten Segment
                    des URL-Pfads übereinstimmen.
                  enum:
                    - getEncryptedUtxosByTags
                  default: getEncryptedUtxosByTags
                params:
                  type: object
                  required:
                    - tags
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        Grenzen für den slot. Setze für die Fortsetzung eines
                        vollständig aufgeholten, unbegrenzten Lesevorgangs
                        `slot.gt` auf `context.slot` der letzten Seite.
                    limit:
                      type: integer
                      format: uint64
                      maximum: 1000
                      minimum: 1
                      nullable: true
                      default: 1000
                      description: >-
                        Maximale Anzahl von Solana-Transaktionen pro Seite, von
                        1 bis 1.000.
                    minContextSlot:
                      type: integer
                      format: uint64
                      minimum: 0
                      nullable: true
                      description: >-
                        Mindestens erforderlicher persistierter slot des
                        Indexers für diesen Lesevorgang. Gibt den
                        JSON-RPC-Fehler -32016 zurück, wenn der Indexer
                        zurückliegt.
                    paginationToken:
                      type: string
                      description: >-
                        Fortsetzungs-token aus der vorherigen response. Übergib
                        ihn unverändert mit denselben Tags sowie denselben
                        Filtern für Ring und slot.
                      nullable: true
                    ringProgramId:
                      type: string
                      description: >-
                        Beschränke die Ergebnisse auf den von dieser Programm-ID
                        autorisierten Ring. Erforderlich, wenn tags leer ist.
                      nullable: true
                    tags:
                      type: array
                      items:
                        $ref: '#/components/schemas/Hash'
                      description: >-
                        Base58-codierte 32-Byte-Anzeige-Tags. Höchstens 1.000.
                        Ein leeres Array erfordert ringProgramId und wählt
                        diesen Ring aus.
                      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: JSON-RPC response. Prüfe error, bevor du result liest.
          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: Die ID des request.
                  jsonrpc:
                    type: string
                    description: Die Version des JSON-RPC-Protokolls.
                    enum:
                      - '2.0'
                  result:
                    type: object
                    description: >-
                      Eine begrenzte Seite eines Verlaufslesevorgangs mit
                      Paginierung im gTFA-Stil.
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: >-
                            Alle übereinstimmenden Ausgaben einer
                            Solana-Transaktion.
                          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: >-
                          Die ID des neuesten nicht pausierten Zustandsbaums.
                          Wird ausgelassen, wenn sie nicht verfügbar ist.
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          token für die nächste Seite; null, wenn keine weiteren
                          Ergebnisse übereinstimmen. Ein vollständig aufgeholter

                          Lesevorgang ohne Grenze durch `lt` oder `lte` wird
                          später fortgesetzt, indem `filters.slot.gt`

                          auf `context.slot` dieser Seite gesetzt wird; ein
                          gedeckelter Lesevorgang umfasst nur slots bis

                          zu seiner Obergrenze.
                        nullable: true
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  data: []
                  paginationToken: null
        '400':
          description: >-
            Vor der Ausführung abgelehnt. Stimmen Methode und Pfad nicht
            überein, sind Methodenfelder doppelt vorhanden oder handelt es sich
            um einen Batch-request, wird -32601 zurückgegeben. Bei einem
            unlesbaren oder zu großen Body wird -32600 zurückgegeben.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      Die ID des request oder null, wenn der Body keinen
                      einzelnen JSON-RPC-Aufruf enthält.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: rate limit überschritten.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      Die ID des request oder null, wenn der Body keinen
                      einzelnen JSON-RPC-Aufruf enthält.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Interner Serverfehler.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      Die ID des request oder null, wenn der Body keinen
                      einzelnen JSON-RPC-Aufruf enthält.
                  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: Optionale Grenzen für den slot bei der Verlaufsabfrage.
      properties:
        slot:
          $ref: '#/components/schemas/SlotFilter'
      additionalProperties: false
    Hash:
      type: string
      description: Ein Base58-codierter 32-Byte-Hash.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Höchster vom Indexer persistierter slot für Aktualitätsprüfungen
            anhand des slot.
          minimum: 0
    EncryptedUtxoMatch:
      type: object
      required:
        - slot
        - txSignature
        - txViewingPk
        - salt
        - outputSlot
      properties:
        outputSlot:
          $ref: '#/components/schemas/RingsOutputSlot'
        salt:
          type: string
          description: >-
            AES-Salt auf Transaktionsebene, den alle Chiffrate der Ausgaben
            gemeinsam verwenden.
          nullable: true
        slot:
          type: integer
          format: uint64
          minimum: 0
        txSignature:
          $ref: '#/components/schemas/SerializableSignature'
        txViewingPk:
          type: string
          description: Eine Base64-codierte Byte-Zeichenfolge.
          nullable: true
    SerializableSignature:
      type: string
      description: Eine Base58-codierte 64-Byte-Signatur einer Solana-Transaktion.
    SlotFilter:
      type: object
      description: >-
        Grenzen für den slot des Lesevorgangs. Angegebene Grenzen werden mit AND
        kombiniert.
      properties:
        gt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließe nur Transaktionen nach diesem slot ein.
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließe nur Transaktionen in oder nach diesem slot ein.
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließe nur Transaktionen vor diesem slot ein.
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließe nur Transaktionen in oder vor diesem slot ein.
      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: >-
            Konto des Zustandsbaums. Verwende vorzugsweise treeId; das Baumkonto
            wird daraus abgeleitet.
          deprecated: true
        treeId:
          type: integer
          format: uint16
          description: >-
            Die unverarbeitete Baum-ID, unter der das commitment der Ausgabe
            gehasht wird.
          minimum: 0
    Base64String:
      type: string
      description: Eine Base64-codierte Byte-Zeichenfolge.
    SerializablePubkey:
      type: string
      description: Ein Base58-codierter öffentlicher Solana-Key.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Dein Helius API key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.