> ## 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 > Recupere saídas UTXO criptografadas que correspondam a tags de visualização ou a um anel específico. ## Saídas criptografadas Use este método para obter UTXOs criptografadas para descriptografia no lado do cliente. Sua carteira descriptografa as saídas e soma os valores não gastos de cada ativo para determinar seu saldo privado. Este método é comparável ao [`getTokenAccountsByOwner`](https://solana.com/docs/rpc/http/gettokenaccountsbyowner) da Solana, que retorna contas de tokens SPL pertencentes a um endereço. Um saldo privado é armazenado em UTXOs, não em contas da Solana, por isso requer um método RPC dedicado. Saiba mais sobre [estado privado e UTXOs](https://www.helius.dev/docs/pt-BR/privacy/concepts/utxo.md). O método retorna as saídas correspondentes em `result.data`, agrupadas por transação da Solana. Cada entrada inclui `slot` e `signature` da transação. Uma saída inclui seu texto cifrado, sua tag de visualização, seu compromisso, seu ID de árvore e seu índice de folha. A resposta inclui saídas históricas que talvez já tenham sido gastas. Sua carteira deve rastrear nulificadores para determinar o saldo disponível para gasto. Consulte o [guia de saldo privado](https://www.helius.dev/docs/pt-BR/privacy/guides/read-balance.md). Um array `tags` vazio requer `ringProgramId` e seleciona as saídas desse anel. Quando ambos são fornecidos, as saídas devem corresponder às tags e ao anel. Consulte [paginação e atualidade dos dados](https://www.helius.dev/docs/pt-BR/api-reference/privacy.md#paginação) para saber mais sobre limites de página, tokens de continuação e leituras incrementais. ## Parâmetros da solicitação **filters** `object` Limites de slot. Retome uma leitura atualizada e sem limite com `slot.gt` definido como o `context.slot` da última página. **filters.slot** `object` Limites de slot para a leitura. Os limites fornecidos são combinados com AND. **filters.slot.gt** `number` Inclua apenas transações posteriores a este slot. **filters.slot.gte** `number` Inclua apenas transações neste slot ou posteriores a ele. **filters.slot.lt** `number` Inclua apenas transações anteriores a este slot. **filters.slot.lte** `number` Inclua apenas transações neste slot ou anteriores a ele. **limit** `number` (default: 1000) Número máximo de transações da Solana por página, de 1 a 1.000. **minContextSlot** `number` Slot mínimo persistido do indexador necessário para esta leitura. Retorna o erro JSON-RPC -32016 se o indexador estiver atrasado. **paginationToken** `string` Token de continuação da resposta anterior. Envie-o novamente sem alterações, com as mesmas tags, o mesmo anel e os mesmos filtros de slot. **ringProgramId** `string` Restrinja os resultados ao anel autorizado por este ID de programa. Obrigatório quando tags estiver vazio. **tags** `array` *required* Tags de visualização de 32 bytes codificadas em Base58. No máximo 1.000. Um array vazio requer ringProgramId e seleciona esse anel. ## OpenAPI ````yaml pt-BR/openapi/privacy/getEncryptedUtxosByTags.yaml POST /v1/spr/getEncryptedUtxosByTags openapi: 3.0.3 info: title: API de Anéis de Privacidade da Solana version: 0.51.2 description: >- API JSON-RPC do indexador de privacidade para estado criptografado, histórico, provas e registros públicos. servers: - url: https://devnet.helius-rpc.com description: API de Anéis de Privacidade da Solana na Devnet security: [] paths: /v1/spr/getEncryptedUtxosByTags: post: summary: getEncryptedUtxosByTags description: >- Recupera saídas UTXO criptografadas que correspondem a tags de visualização ou a um anel específico. operationId: getEncryptedUtxosByTags requestBody: content: application/json: schema: type: object required: - jsonrpc - id - method - params properties: id: type: string description: Um ID para identificar a solicitação. default: '1' jsonrpc: type: string description: A versão do protocolo JSON-RPC. enum: - '2.0' default: '2.0' method: type: string description: >- O método a ser invocado. Deve corresponder ao segmento final do caminho da URL. enum: - getEncryptedUtxosByTags default: getEncryptedUtxosByTags params: type: object required: - tags properties: filters: allOf: - $ref: '#/components/schemas/HistoryFilters' description: >- Limites de slots. Para retomar uma leitura atualizada e sem limite máximo, defina `slot.gt` como o `context.slot` da última página. limit: type: integer format: uint64 maximum: 1000 minimum: 1 nullable: true default: 1000 description: >- Número máximo de transações da Solana por página, de 1 a 1.000. minContextSlot: type: integer format: uint64 minimum: 0 nullable: true description: >- Slot mínimo persistido pelo indexador necessário para esta leitura. Retorna o erro JSON-RPC -32016 se o indexador estiver atrasado. paginationToken: type: string description: >- Token de continuação da resposta anterior. Envie-o novamente sem alterações com as mesmas tags e os mesmos filtros de anel e slot. nullable: true ringProgramId: type: string description: >- Restringe os resultados ao anel autorizado por este ID de programa. Obrigatório quando tags está vazio. nullable: true tags: type: array items: $ref: '#/components/schemas/Hash' description: >- Tags de visualização de 32 bytes codificadas em base58. No máximo 1.000. Uma matriz vazia exige ringProgramId e seleciona esse anel. 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: Resposta JSON-RPC. Verifique error antes de ler 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: O ID da solicitação. jsonrpc: type: string description: A versão do protocolo JSON-RPC. enum: - '2.0' result: type: object description: >- Uma página limitada de uma leitura de histórico, com paginação no estilo gTFA. required: - context - data - paginationToken properties: context: $ref: '#/components/schemas/Context' data: type: array items: type: object description: >- Todas as saídas correspondentes de uma transação da 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: >- O ID da árvore de estado não pausada mais recente. Omitido quando indisponível. minimum: 0 paginationToken: type: string description: >- Token para a próxima página, null quando não houver mais resultados correspondentes. Uma leitura atualizada sem um limite `lt` ou `lte` é retomada posteriormente com `filters.slot.gt` definido como o `context.slot` desta página; uma leitura com limite máximo abrange apenas os slots até seu limite. nullable: true example: jsonrpc: '2.0' id: '1' result: context: slot: 4242 blockTime: 1730000000 data: [] paginationToken: null '400': description: >- Rejeitada antes da execução. Uma divergência entre método e caminho, campos de método duplicados ou uma solicitação em lote retorna -32601. Um corpo ilegível ou muito grande retorna -32600. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- O ID da solicitação, ou null quando o corpo não é uma única chamada JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '429': description: Limite de taxa excedido. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- O ID da solicitação, ou null quando o corpo não é uma única chamada JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '500': description: Erro interno do servidor. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- O ID da solicitação, ou null quando o corpo não é uma única chamada 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: Limites de slots opcionais para a consulta de histórico. properties: slot: $ref: '#/components/schemas/SlotFilter' additionalProperties: false Hash: type: string description: Um hash de 32 bytes codificado em base58. Context: type: object required: - blockTime - slot properties: blockTime: type: integer format: int64 slot: type: integer format: uint64 description: >- O slot mais alto persistido pelo indexador, usado para verificações de atualização baseadas em slot. minimum: 0 EncryptedUtxoMatch: type: object required: - slot - txSignature - txViewingPk - salt - outputSlot properties: outputSlot: $ref: '#/components/schemas/RingsOutputSlot' salt: type: string description: >- Salt AES no nível da transação compartilhado por todos os textos cifrados das saídas. nullable: true slot: type: integer format: uint64 minimum: 0 txSignature: $ref: '#/components/schemas/SerializableSignature' txViewingPk: type: string description: Uma string de bytes codificada em base64. nullable: true SerializableSignature: type: string description: Uma assinatura de transação da Solana de 64 bytes codificada em base58. SlotFilter: type: object description: >- Limites de slots para a leitura. Os limites fornecidos são combinados com AND. properties: gt: type: integer format: uint64 minimum: 0 nullable: true description: Inclui apenas transações posteriores a este slot. gte: type: integer format: uint64 minimum: 0 nullable: true description: Inclui apenas transações neste slot ou posteriores a ele. lt: type: integer format: uint64 minimum: 0 nullable: true description: Inclui apenas transações anteriores a este slot. lte: type: integer format: uint64 minimum: 0 nullable: true description: Inclui apenas transações neste slot ou anteriores a ele. 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: >- Conta da árvore de estado. Prefira treeId; a conta da árvore é derivada dele. deprecated: true treeId: type: integer format: uint16 description: >- O ID bruto da árvore sob a qual o compromisso da saída é transformado em hash. minimum: 0 Base64String: type: string description: Uma string de bytes codificada em base64. SerializablePubkey: type: string description: Uma chave pública da Solana codificada em base58. securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: Sua chave de API da Helius. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.