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

> Devuelve la cuenta comprimida con la dirección o el hash especificados.

## Parámetros de la solicitud

<ParamField body="address" type="string" default="11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3">
  La clave pública de Solana de la cuenta comprimida cuyos datos quieres obtener
</ParamField>

<ParamField body="hash" type="string">
  El identificador hash de los datos de la cuenta comprimida de Solana si la dirección no está disponible
</ParamField>


## OpenAPI

````yaml es/openapi/zk-compression/getCompressedAccount.yaml POST /
openapi: 3.0.3
info:
  title: API de compresión de estado de Solana
  description: >
    Indexador avanzado de Solana para cuentas de estado comprimidas que utiliza
    pruebas de conocimiento cero para almacenar y recuperar datos de forma
    eficiente.

    Esta API permite realizar operaciones rentables con NFT y tokens mediante la
    tecnología de compresión de estado de Solana,

    lo que reduce los costos de almacenamiento hasta 1000 veces en comparación
    con las cuentas tradicionales.
  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 RPC de Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC de Devnet
security: []
paths:
  /:
    summary: getCompressedAccount
    post:
      description: >
        Recupera datos detallados de una cuenta comprimida de Solana mediante la
        tecnología de compresión de estado.

        Este endpoint proporciona acceso a un almacenamiento eficiente de datos
        en cadena con un ahorro de costos de hasta 1000 veces 

        en comparación con las cuentas normales de Solana. Consulta NFT
        comprimidos y cuentas de tokens por dirección o hash 

        para obtener información completa de la cuenta, detalles de propiedad y
        datos en cadena.


        Beneficios principales:

        - Costos considerablemente menores para proyectos de NFT y emisores de
        tokens de Solana

        - Tarifas de almacenamiento reducidas para aplicaciones de gran volumen

        - Compatibilidad total con el modelo de seguridad y consenso de Solana

        - Solución escalable para grandes colecciones de NFT y conjuntos de
        tokens

        - Mayor rendimiento en las operaciones con activos comprimidos
      operationId: getCompressedAccount
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: La versión del protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Un ID para identificar la solicitud.
                  default: '1'
                method:
                  type: string
                  description: El nombre del método que se invocará.
                  enum:
                    - getCompressedAccount
                  default: getCompressedAccount
                params:
                  type: object
                  description: >
                    Parámetros de la solicitud para recuperar datos de cuentas
                    comprimidas en Solana, incluido 

                    un identificador de dirección o un hash de datos para NFT y
                    tokens comprimidos
                  default:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
                  properties:
                    address:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: >-
                        La clave pública de Solana de la cuenta comprimida cuyos
                        datos se recuperarán
                    hash:
                      type: string
                      allOf:
                        - $ref: '#/components/schemas/Hash'
                      nullable: true
                      description: >-
                        El identificador hash de los datos de la cuenta
                        comprimida de Solana si la dirección no está disponible
                  additionalProperties: false
                  example:
                    address: null
                    hash: gEF8v1TLb2T9vTaJarFj6kQoSfWNkskMSCJpPJSxZzT
        required: true
      responses:
        '200':
          description: >-
            Los datos de la cuenta comprimida se recuperaron correctamente de la
            blockchain de Solana
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/Account'
                additionalProperties: false
        '400':
          description: >-
            Solicitud incorrecta: los parámetros de la solicitud no son válidos
            o la solicitud tiene un formato incorrecto.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parámetros no válidos
                id: '1'
        '401':
          description: 'No autorizado: la clave de API no es válida o no está presente.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: No autorizado
                id: '1'
        '429':
          description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Demasiadas solicitudes
                id: '1'
        '500':
          description: 'Error interno del servidor: ocurrió un error en el servidor.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Error interno
                id: '1'
        '503':
          description: >-
            Servicio no disponible: el servicio no está disponible
            temporalmente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Servicio no disponible
                id: '1'
        '504':
          description: >-
            Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
            de espera de la solicitud.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tiempo de espera de la puerta de enlace agotado
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    SerializablePubkey:
      type: string
      description: >-
        Una clave pública de Solana representada como una cadena codificada en
        base58, que se utiliza para identificar cuentas, programas y usuarios.
      default: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
      example: 11111112D1oxKts8YPdTJRG5FzxTNpMtWmq8hkVx3
    Hash:
      type: string
      description: >-
        Un hash criptográfico de 32 bytes representado como una cadena base58,
        que se utiliza para verificar cuentas comprimidas de Solana.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: >-
            El contexto del slot actual de la blockchain de Solana para esta
            solicitud
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Dirección de identificación única de la cuenta comprimida de Solana
        data:
          $ref: '#/components/schemas/AccountData'
          description: Datos en cadena almacenados en la cuenta comprimida de Solana
        hash:
          $ref: '#/components/schemas/Hash'
          description: >-
            Hash criptográfico de los datos de la cuenta comprimida para su
            verificación
        lamports:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Saldo en SOL que mantiene esta cuenta comprimida, expresado en
            lamports (1 SOL = 1,000,000,000 lamports)
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Índice de posición en el árbol de Merkle donde se almacena esta
            cuenta comprimida
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Programa de Solana propietario de esta cuenta comprimida
            (normalmente, el programa de compresión)
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Número de secuencia para realizar el seguimiento de las
            actualizaciones de esta cuenta comprimida
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Slot de la blockchain de Solana en el que se creó esta cuenta
            comprimida
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Dirección del árbol de Merkle donde se almacena esta cuenta
            comprimida
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: La versión del protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: El código de error.
              example: -32602
            message:
              type: string
              description: El mensaje de error.
            data:
              type: object
              description: Datos adicionales sobre el error.
        id:
          type: string
          description: Identificador que coincide con la solicitud.
          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: >-
        Un valor entero no negativo que se utiliza para diversos parámetros
        numéricos de las cuentas comprimidas de Solana
    Base64String:
      type: string
      description: >-
        Una cadena codificada en base64 que representa datos de una cuenta
        comprimida en Solana.
      default: SGVsbG8sIFdvcmxkIQ==
      example: SGVsbG8sIFdvcmxkIQ==
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Tu clave de API de Helius. Puedes obtener una gratis en el
        [panel](https://dashboard.helius.dev/api-keys).

````