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

# getCompressedAccount

> Retorna a conta comprimida com o endereço ou hash fornecido.

## Parâmetros da Requisição

<ParamField body="address" type="string" default="11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3">
  A chave pública Solana da conta comprimida para recuperar os dados
</ParamField>

<ParamField body="hash" type="string">
  O identificador do hash de dados da conta Solana comprimida se o endereço não estiver disponível
</ParamField>


## OpenAPI

````yaml pt-BR/openapi/zk-compression/getCompressedAccount.yaml POST /
openapi: 3.0.3
info:
  title: Solana State Compression API
  description: >
    Indexador avançado de Solana para contas de estado comprimidas usando provas
    de conhecimento zero para armazenamento e recuperação de dados eficientes.

    Esta API permite operações de NFT e token com custo reduzido através da
    tecnologia de compressão de estado do Solana,

    reduzindo custos de armazenamento em até 1000x em comparação com contas
    tradicionais.
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 0.50.0
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint Mainnet RPC
  - url: https://devnet.helius-rpc.com
    description: Endpoint Devnet RPC
security: []
paths:
  /:
    summary: getCompressedAccount
    post:
      description: >
        Recupere dados detalhados para uma conta Solana comprimida usando
        tecnologia de compressão de estado.

        Este endpoint fornece acesso a armazenamento de dados on-chain eficiente
        com economia de custos de até 1000x

        em comparação com contas Solana regulares. Consulte NFTs e contas de
        token comprimidas por endereço ou hash

        para obter informações completas da conta, detalhes de propriedade e
        dados on-chain.


        Principais benefícios:

        - Redução drástica de custos para projetos NFT Solana e emissores de
        token

        - Taxas de armazenamento reduzidas para aplicativos de alto volume

        - Total compatibilidade com o modelo de segurança e consenso do Solana

        - Solução escalável para grandes coleções de NFTs e conjuntos de tokens

        - Maior capacidade de processamento para operações de ativos comprimidos
      operationId: getCompressedAccount
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: A versão do protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Um ID para identificar a solicitação.
                  default: '1'
                method:
                  type: string
                  description: O nome do método a ser invocado.
                  enum:
                    - getCompressedAccount
                  default: getCompressedAccount
                params:
                  type: object
                  description: >
                    Parâmetros de solicitação para recuperar dados de conta
                    comprimidos no Solana, incluindo

                    identificador de endereço ou hash de dados para NFTs e
                    tokens comprimidos
                  default:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
                  properties:
                    address:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: >-
                        A chave pública Solana da conta comprimida para
                        recuperar dados
                    hash:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/Hash'
                      nullable: true
                      description: >-
                        O identificador de hash de dados da conta Solana
                        comprimida se o endereço não estiver disponível
                  additionalProperties: false
                  example:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
        required: true
      responses:
        '200':
          description: >-
            Dados da conta comprimida recuperados com sucesso do blockchain
            Solana
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/Account'
                additionalProperties: false
        '400':
          description: >-
            Requisição Inválida - Parâmetros de solicitação inválidos ou
            requisição malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parâmetros inválidos
                id: '1'
        '401':
          description: Não autorizado - API key inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Não autorizado
                id: '1'
        '429':
          description: Muitas Solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Muitas solicitações
                id: '1'
        '500':
          description: Erro Interno do Servidor - Ocorreu um erro no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Erro interno
                id: '1'
        '503':
          description: Serviço Indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Serviço indisponível
                id: '1'
        '504':
          description: Tempo de Resposta Excedido - A solicitação excedeu o tempo limite.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tempo limite do gateway
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    SerializablePubkey:
      type: string
      description: >-
        Uma chave pública Solana representada como uma string codificada em
        base58, usada para identificar contas, programas e usuários.
      default: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
      example: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
    Hash:
      type: string
      description: >-
        Um hash criptográfico de 32 bytes representado como uma string base58,
        usado para verificação de conta comprimida no Solana.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: O slot de contexto atual do blockchain Solana para esta solicitação
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Endereço identificador único para a conta Solana comprimida
        data:
          $ref: '#/components/schemas/AccountData'
          description: Dados on-chain armazenados na conta Solana comprimida
        hash:
          $ref: '#/components/schemas/Hash'
          description: Hash criptográfico dos dados da conta comprimida para verificação
        lamports:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Saldo SOL mantido por esta conta comprimida em lamports (1 SOL =
            1.000.000.000 lamports)
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Índice de posição na árvore de Merkle onde esta conta comprimida
            está armazenada
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Programa Solana que possui esta conta comprimida (tipicamente o
            programa de compressão)
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Número de sequência para rastrear atualizações desta conta
            comprimida
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Slot do blockchain Solana quando esta conta comprimida foi criada
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Endereço da árvore de Merkle onde esta conta comprimida está
            armazenada
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código de erro.
              example: -32602
            message:
              type: string
              description: A mensagem de erro.
            data:
              type: object
              description: Dados adicionais sobre o erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
    AccountData:
      type: object
      required:
        - discriminator
        - data
        - dataHash
      properties:
        data:
          $ref: '#/components/schemas/Base64String'
        dataHash:
          $ref: '#/components/schemas/Hash'
        discriminator:
          $ref: '#/components/schemas/UnsignedInteger'
      additionalProperties: false
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
      description: >-
        Um valor inteiro não negativo usado para vários parâmetros numéricos em
        contas comprimidas no Solana
    Base64String:
      type: string
      description: >-
        Uma string codificada em base64 representando dados de conta comprimidos
        no Solana.
      default: SGVsbG8sIFdvcmxkIQ==
      example: SGVsbG8sIFdvcmxkIQ==
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua Helius API key. Você pode obter uma gratuitamente no
        [painel](https://dashboard.helius.dev/api-keys).

````