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

# getShieldedTransactionsByTags

> Rufe abgeschirmte Transaktionsereignisse ab, die mit View-Tags oder einem bestimmten Ring übereinstimmen.

## Transaktionsverlauf

Tags wählen Transaktionen aus. Jeder Eintrag in `result.data` enthält alle Ereignisse einer ausgewählten Solana-Transaktion, begrenzt auf `ringProgramId`, wenn du diesen Wert angibst. Zu den Ereignissen gehören verschlüsselte Ausgaben, Nachrichten, Nullifier und Ring-Metadaten. Entschlüssele die payloads in deinem Wallet, um Beträge und Assets wiederherzustellen. Weitere Informationen findest du im [Leitfaden zum privaten Verlauf](https://www.helius.dev/docs/de/privacy/guides/read-history.md).

Tags stimmen mit Output-View-Tags und Message-View-Tags überein. Ein leeres `tags`-Array erfordert `ringProgramId` und wählt den Verlauf des Rings aus, einschließlich Transaktionen ohne Empfänger-Tags. Wenn du beides angibst, müssen die Transaktionen sowohl mit den Tags als auch mit dem Ring übereinstimmen.

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

## Request-Parameter

**filters** `object`

Slot-Grenzen. Setze für die Fortsetzung eines vollständig aufgeholten, unbegrenzten Lesevorgangs `slot.gt` auf den Wert `context.slot` der letzten Seite.

**filters.slot** `object`

Slot-Grenzen für den Lesevorgang. Angegebene Grenzen werden mit AND kombiniert.

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

Schließe nur Transaktionen nach diesem slot ein.

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

Schließe nur Transaktionen ab diesem slot ein.

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

Schließe nur Transaktionen vor diesem slot ein.

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

Schließe nur Transaktionen bis einschließlich dieses slot ein.

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

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

**minContextSlot** `number`

Für diesen Lesevorgang erforderlicher minimaler persistierter Indexer-slot. Gibt den JSON-RPC-Fehler -32016 zurück, wenn der Indexer zurückliegt.

**paginationToken** `string`

Fortsetzungs-token aus der vorherigen response. Übergib ihn unverändert mit denselben Tags sowie denselben Ring- und Slot-Filtern.

**ringProgramId** `string`

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

**tags** `array` *required*

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


## OpenAPI

````yaml de/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags
openapi: 3.0.3
info:
  title: Solana Privacy Rings API
  version: 0.51.2
  description: >-
    JSON-RPC API des Datenschutz-Indexers für verschlüsselte Zustände, Verläufe,
    Nachweise und öffentliche Registereinträge.
servers:
  - url: https://devnet.helius-rpc.com
    description: Solana Privacy Rings API im Devnet
security: []
paths:
  /v1/spr/getShieldedTransactionsByTags:
    post:
      summary: getShieldedTransactionsByTags
      description: >-
        Ruft geschützte Transaktionsereignisse ab, die mit View-Tags oder einem
        bestimmten Ring übereinstimmen.
      operationId: getShieldedTransactionsByTags
      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:
                    - getShieldedTransactionsByTags
                  default: getShieldedTransactionsByTags
                params:
                  type: object
                  required:
                    - tags
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        slot-Grenzen. Setze für die Fortsetzung einer aktuellen,
                        nicht begrenzten Abfrage `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: >-
                        Für diese Abfrage erforderlicher minimaler persistierter
                        slot des Indexers. Gibt den JSON-RPC-Fehler -32016
                        zurück, wenn der Indexer zurückliegt.
                    paginationToken:
                      type: string
                      description: >-
                        token zur Fortsetzung aus der vorherigen response.
                        Übergib ihn unverändert mit denselben Tags sowie
                        denselben Ring- und slot-Filtern.
                      nullable: true
                    ringProgramId:
                      type: string
                      description: >-
                        Beschränkt 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-View-Tags. Maximal 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: getShieldedTransactionsByTags
              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 einer Verlaufsabfrage mit einer
                      Paginierung im gTFA-Stil.
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: >-
                            Die zurückgegebenen Ereignisse einer
                            Solana-Transaktion in Ereignisreihenfolge.
                          required:
                            - slot
                            - signature
                            - events
                          properties:
                            events:
                              type: array
                              items:
                                $ref: '#/components/schemas/ShieldedTransaction'
                            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 weggelassen, wenn sie nicht verfügbar ist.
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          token für die nächste Seite. Ist null, wenn keine
                          weiteren Ergebnisse übereinstimmen. Eine aktuelle

                          Abfrage ohne `lt`- oder `lte`-Grenze wird später
                          fortgesetzt, indem du `filters.slot.gt`

                          auf `context.slot` dieser Seite setzt. Eine begrenzte
                          Abfrage deckt nur slots bis zu

                          ihrer Obergrenze ab.
                        nullable: true
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  data: []
                  paginationToken: null
        '400':
          description: >-
            Vor der Ausführung abgelehnt. Nicht übereinstimmende Methode und
            Pfad, doppelte Methodenfelder oder ein Batch-request geben -32601
            zurück. Ein nicht lesbarer oder zu großer Body gibt -32600 zurück.
          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 kein einzelner
                      JSON-RPC-Aufruf ist.
                  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 kein einzelner
                      JSON-RPC-Aufruf ist.
                  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 kein einzelner
                      JSON-RPC-Aufruf ist.
                  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 slot-Grenzen für die 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 slot-basierte
            Aktualitätsprüfungen.
          minimum: 0
    ShieldedTransaction:
      type: object
      required:
        - slot
        - txSignature
        - txViewingPk
        - salt
        - outputSlots
        - messages
        - nullifiers
        - proofless
      properties:
        eventIndex:
          type: integer
          format: uint16
          minimum: 0
        messages:
          type: array
          items:
            $ref: '#/components/schemas/RingsMessage'
          description: >-
            Veröffentlichte Daten-slots, die an kein Output-commitment gebunden
            sind und unverändert erneut veröffentlicht werden.
        nullifiers:
          type: array
          items:
            $ref: '#/components/schemas/Hash'
        outputSlots:
          type: array
          items:
            $ref: '#/components/schemas/RingsOutputSlot'
        proofless:
          type: boolean
          description: >-
            True, wenn mindestens ein Output in dieser Transaktion keinen
            Nachweis hat.
        ringConfig:
          type: string
          description: >-
            Das Konfigurationskonto des Rings (seine `ring_auth`-PDA). Wird
            weggelassen, wenn kein Ring diese Transaktion autorisiert hat.
        ringProgramId:
          type: string
          description: >-
            Das Programm des Rings, aufgelöst über die indexierten
            Registrierungen. Wird weggelassen, wenn `ringConfig` weggelassen
            wird oder die Registrierung des Rings noch nicht indexiert wurde.
            Verwende `ringConfig`, um „kein Ring“ von „Ring mit einem nicht
            indexierten Programm“ zu unterscheiden.
        salt:
          type: string
          description: >-
            AES-Salt auf Transaktionsebene, das von jedem Output-Chiffretext
            gemeinsam verwendet wird.
          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: >-
        slot-Grenzen für die Abfrage. Angegebene Grenzen werden mit AND
        kombiniert.
      properties:
        gt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließt nur Transaktionen nach diesem slot ein.
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließt nur Transaktionen in oder nach diesem slot ein.
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließt nur Transaktionen vor diesem slot ein.
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Schließt nur Transaktionen in oder vor diesem slot ein.
      additionalProperties: false
    RingsMessage:
      type: object
      required:
        - viewTag
        - payload
      properties:
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    RingsOutputSlot:
      type: object
      required:
        - viewTag
        - outputContext
        - payload
      properties:
        outputContext:
          $ref: '#/components/schemas/RingsOutputContext'
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    Base64String:
      type: string
      description: Eine Base64-codierte Byte-Zeichenfolge.
    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. Bevorzuge treeId. Das Baumkonto wird daraus
            abgeleitet.
          deprecated: true
        treeId:
          type: integer
          format: uint16
          description: >-
            Die unverarbeitete Baum-ID, unter der das commitment des Outputs
            gehasht wird.
          minimum: 0
    SerializablePubkey:
      type: string
      description: Ein Base58-codierter öffentlicher Solana-Schlüssel.
  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.