> ## 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 > Recupera eventos de transacciones protegidas que coincidan con etiquetas de visualización o con un anillo específico. ## Historial de transacciones Las etiquetas seleccionan transacciones. Cada entrada de `result.data` contiene todos los eventos de una transacción de Solana seleccionada, limitados a `ringProgramId` cuando lo proporcionas. Los eventos incluyen salidas cifradas, mensajes, anuladores y metadatos del anillo. Descifra las cargas útiles en tu billetera para recuperar los importes y activos. Consulta la [guía del historial privado](https://www.helius.dev/docs/es/privacy/guides/read-history.md). Las etiquetas coinciden con las etiquetas de visualización de las salidas y los mensajes. Un arreglo `tags` vacío requiere `ringProgramId` y selecciona el historial del anillo, incluidas las transacciones sin etiquetas de destinatario. Cuando proporcionas ambos, las transacciones deben coincidir con las etiquetas y el anillo. Consulta [paginación y actualización de datos](https://www.helius.dev/docs/es/api-reference/privacy.md#paginación) para conocer los límites de página, los tokens de continuación y las lecturas incrementales. ## Parámetros de la solicitud **filters** `object` Límites de ranura. Reanuda una lectura actualizada y sin límite superior con `slot.gt` establecido en el valor `context.slot` de la última página. **filters.slot** `object` Límites de ranura para la lectura. Los límites proporcionados se combinan con AND. **filters.slot.gt** `number` Incluye solo las transacciones posteriores a esta ranura. **filters.slot.gte** `number` Incluye solo las transacciones de esta ranura o posteriores. **filters.slot.lt** `number` Incluye solo las transacciones anteriores a esta ranura. **filters.slot.lte** `number` Incluye solo las transacciones de esta ranura o anteriores. **limit** `number` (default: 1000) Número máximo de transacciones de Solana por página, de 1 a 1000. **minContextSlot** `number` Ranura mínima persistida del indexador requerida para esta lectura. Devuelve el error JSON-RPC -32016 si el indexador está retrasado. **paginationToken** `string` Token de continuación de la respuesta anterior. Vuelve a enviarlo sin cambios con las mismas etiquetas, el mismo anillo y los mismos filtros de ranura. **ringProgramId** `string` Restringe los resultados al anillo autorizado por este ID de programa. Es obligatorio cuando tags está vacío. **tags** `array` *required* Etiquetas de visualización de 32 bytes codificadas en Base58. Se permiten 1000 como máximo. Un arreglo vacío requiere ringProgramId y selecciona ese anillo. ## OpenAPI ````yaml es/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags openapi: 3.0.3 info: title: API de anillos de privacidad de Solana version: 0.51.2 description: >- API JSON-RPC del indexador de privacidad para estados cifrados, historiales, pruebas y registros públicos. servers: - url: https://devnet.helius-rpc.com description: API de anillos de privacidad de Solana en Devnet security: [] paths: /v1/spr/getShieldedTransactionsByTags: post: summary: getShieldedTransactionsByTags description: >- Recupera eventos de transacciones protegidas que coincidan con etiquetas de visualización o con un anillo específico. operationId: getShieldedTransactionsByTags requestBody: content: application/json: schema: type: object required: - jsonrpc - id - method - params properties: id: type: string description: Un ID para identificar la solicitud. default: '1' jsonrpc: type: string description: La versión del protocolo JSON-RPC. enum: - '2.0' default: '2.0' method: type: string description: >- El método que se invocará. Debe coincidir con el segmento final de la ruta de la URL. enum: - getShieldedTransactionsByTags default: getShieldedTransactionsByTags params: type: object required: - tags properties: filters: allOf: - $ref: '#/components/schemas/HistoryFilters' description: >- Límites de slots. Para reanudar una lectura actualizada y sin límite, establece `slot.gt` en el valor `context.slot` de la última página. limit: type: integer format: uint64 maximum: 1000 minimum: 1 nullable: true default: 1000 description: >- Número máximo de transacciones de Solana por página, de 1 a 1,000. minContextSlot: type: integer format: uint64 minimum: 0 nullable: true description: >- Slot mínimo persistido del indexador requerido para esta lectura. Devuelve el error JSON-RPC -32016 si el indexador está atrasado. paginationToken: type: string description: >- Token de continuación de la respuesta anterior. Vuelve a enviarlo sin cambios con las mismas etiquetas y los mismos filtros de anillo y slot. nullable: true ringProgramId: type: string description: >- Restringe los resultados al anillo autorizado por este ID de programa. Es obligatorio cuando tags está vacío. nullable: true tags: type: array items: $ref: '#/components/schemas/Hash' description: >- Etiquetas de visualización de 32 bytes codificadas en base58. Se permiten hasta 1,000. Un arreglo vacío requiere ringProgramId y selecciona ese anillo. 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: Respuesta JSON-RPC. Revisa error antes de leer 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: El ID de la solicitud. jsonrpc: type: string description: La versión del protocolo JSON-RPC. enum: - '2.0' result: type: object description: >- Una página limitada de una lectura de historial, con paginación al estilo gTFA. required: - context - data - paginationToken properties: context: $ref: '#/components/schemas/Context' data: type: array items: type: object description: >- Los eventos devueltos de una transacción de Solana, en el orden de los eventos. 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: >- El ID del árbol de estado no pausado más reciente. Se omite cuando no está disponible. minimum: 0 paginationToken: type: string description: >- Token para la página siguiente; es null cuando no hay más resultados coincidentes. Una lectura actualizada sin un límite `lt` o `lte` se reanuda más tarde con `filters.slot.gt` establecido en el valor `context.slot` de esta página; una lectura con límite solo abarca los slots hasta ese límite. nullable: true example: jsonrpc: '2.0' id: '1' result: context: slot: 4242 blockTime: 1730000000 data: [] paginationToken: null '400': description: >- Se rechazó antes de la ejecución. Una discrepancia entre el método y la ruta, campos de método duplicados o una solicitud por lotes devuelve -32601. Un cuerpo ilegible o demasiado grande devuelve -32600. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- El ID de la solicitud, o null cuando el cuerpo no contiene una sola llamada JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '429': description: Se superó el límite de solicitudes. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- El ID de la solicitud, o null cuando el cuerpo no contiene una sola llamada JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '500': description: Error interno del servidor. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- El ID de la solicitud, o null cuando el cuerpo no contiene una sola llamada JSON-RPC. 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: Límites de slots opcionales para la consulta del historial. properties: slot: $ref: '#/components/schemas/SlotFilter' additionalProperties: false Hash: type: string description: Un hash de 32 bytes codificado en base58. Context: type: object required: - blockTime - slot properties: blockTime: type: integer format: int64 slot: type: integer format: uint64 description: >- El slot más alto que el indexador ha persistido, para comprobaciones de actualización basadas en slots. 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: >- Slots de datos publicados que no están vinculados a ningún compromiso de salida y se vuelven a publicar sin modificaciones. nullifiers: type: array items: $ref: '#/components/schemas/Hash' outputSlots: type: array items: $ref: '#/components/schemas/RingsOutputSlot' proofless: type: boolean description: >- Es true cuando al menos una salida de esta transacción no tiene prueba. ringConfig: type: string description: >- La cuenta de configuración del anillo (su PDA `ring_auth`). Se omite cuando ningún anillo autorizó esta transacción. ringProgramId: type: string description: >- El programa del anillo, resuelto mediante los registros indexados. Se omite cuando se omite `ringConfig` o cuando el registro del anillo aún no se ha indexado. Usa `ringConfig` para distinguir entre "sin anillo" y "anillo con un programa no indexado". salt: type: string description: >- Salt AES a nivel de transacción compartido por todos los textos cifrados de salida. nullable: true slot: type: integer format: uint64 minimum: 0 txSignature: $ref: '#/components/schemas/SerializableSignature' txViewingPk: type: string description: Una cadena de bytes codificada en base64. nullable: true SerializableSignature: type: string description: Una firma de transacción de Solana de 64 bytes codificada en base58. SlotFilter: type: object description: >- Límites de slots para la lectura. Los límites proporcionados se combinan con AND. properties: gt: type: integer format: uint64 minimum: 0 nullable: true description: Incluye únicamente las transacciones posteriores a este slot. gte: type: integer format: uint64 minimum: 0 nullable: true description: Incluye únicamente las transacciones de este slot o posteriores. lt: type: integer format: uint64 minimum: 0 nullable: true description: Incluye únicamente las transacciones anteriores a este slot. lte: type: integer format: uint64 minimum: 0 nullable: true description: Incluye únicamente las transacciones de este slot o anteriores. 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: Una cadena de bytes codificada en base64. 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: >- Cuenta del árbol de estado. Prefiere treeId; la cuenta del árbol se deriva de este valor. deprecated: true treeId: type: integer format: uint16 description: >- El ID de árbol sin procesar bajo el cual se calcula el hash del compromiso de la salida. minimum: 0 SerializablePubkey: type: string description: Una clave pública de Solana codificada en base58. securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: Tu clave de API de Helius. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.