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

# getCompressedTokenAccountsByOwner

> Devuelve las cuentas de tokens comprimidos que pertenecen a una cuenta determinada.

## Parámetros de la solicitud

<ParamField body="cursor" type="string" default="3J98t1WpEZ73CNm">
  Cursor de paginación para recuperar conjuntos posteriores de cuentas de tokens comprimidos en billeteras de Solana con grandes tenencias
</ParamField>

<ParamField body="limit" type="number">
  Número máximo de cuentas de tokens comprimidos que se devolverán por solicitud (para la paginación)
</ParamField>

<ParamField body="mint" type="string" default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  Filtra las cuentas de tokens comprimidos por una dirección de mint específica de un token de Solana
</ParamField>

<ParamField body="owner" type="string" required default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  Una clave pública de Solana representada como una cadena base58 para direcciones de cuentas y billeteras.
</ParamField>


## OpenAPI

````yaml es/openapi/zk-compression/getCompressedTokenAccountsByOwner.yaml POST /
openapi: 3.0.3
info:
  title: API de portafolio de tokens comprimidos de Solana
  description: >
    Indexador avanzado de Solana para cuentas de tokens comprimidos que utiliza
    tecnología de compresión de estado para almacenar y recuperar tokens de
    forma eficiente y rentable.

    Esta API proporciona acceso optimizado a tokens comprimidos y NFT de Solana,
    lo que permite ahorrar hasta 1000 veces en costos y mantener 

    toda la seguridad y compatibilidad con el ecosistema de tokens de Solana. Es
    ideal para aplicaciones de billetera, mercados y dApps basadas en tokens

    que necesitan una gestión eficiente del portafolio de activos comprimidos.
  license:
    name: Apache-2.0
  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: getCompressedTokenAccountsByOwner
    post:
      description: >
        Recupera todas las cuentas de tokens comprimidos que pertenecen a una
        dirección específica de billetera de Solana. 

        Este endpoint de portafolio proporciona datos completos sobre las
        tenencias de tokens SPL comprimidos y NFT, con 

        ahorros significativos gracias a la tecnología de compresión de estado
        de Solana. Filtra los resultados por dirección de acuñación, 

        pagina colecciones grandes de manera eficiente y accede a datos
        detallados de las cuentas con verificación completa de propiedad.


        Beneficios clave:

        - Reducción de los costos de almacenamiento en cadena para las cuentas
        de tokens (ahorros de hasta 1000 veces)

        - Compatibilidad con integraciones de billeteras a gran escala mediante
        paginación eficiente

        - Compatibilidad con el estándar de tokens SPL de Solana y NFT
        comprimidos

        - Filtrado por acuñación para consultas específicas de tokens

        - Datos completos de las cuentas de tokens, incluidos saldos, delegados
        y estados
      operationId: getCompressedTokenAccountsByOwner
      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:
                    - getCompressedTokenAccountsByOwner
                  default: getCompressedTokenAccountsByOwner
                params:
                  type: object
                  required:
                    - owner
                  properties:
                    cursor:
                      allOf:
                        - $ref: '#/components/schemas/Base58String'
                      nullable: true
                      description: >-
                        Cursor de paginación para recuperar conjuntos
                        posteriores de cuentas de tokens comprimidos en
                        billeteras de Solana con grandes tenencias
                    limit:
                      allOf:
                        - $ref: '#/components/schemas/Limit'
                      nullable: true
                      description: >-
                        Número máximo de cuentas de tokens comprimidos que se
                        devolverán por solicitud (para paginación)
                    mint:
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: >-
                        Filtra las cuentas de tokens comprimidos por una
                        dirección específica de acuñación de tokens de Solana
                    owner:
                      $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        La dirección de la billetera de Solana que posee las
                        cuentas de tokens comprimidos que se recuperarán
                  additionalProperties: false
        required: true
      responses:
        '200':
          description: >-
            Las cuentas de tokens comprimidos se recuperaron correctamente de la
            blockchain de Solana para el propietario de la billetera
            especificado
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                  - value
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/TokenAccountList'
                additionalProperties: false
        '400':
          description: >-
            Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
            con 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: clave de API no válida o ausente.'
          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: se produjo 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:
    Base58String:
      type: string
      description: >-
        Cadena codificada en base58 que se utiliza para direcciones e
        identificadores de Solana.
      default: 3J98t1WpEZ73CNm
      example: 3J98t1WpEZ73CNm
    Limit:
      type: integer
      format: int64
      minimum: 0
      description: >-
        Número máximo de cuentas de tokens comprimidos que se devolverán en una
        sola solicitud
    SerializablePubkey:
      type: string
      description: >-
        Clave pública de Solana representada como una cadena base58 para
        direcciones de cuentas y billeteras.
      default: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
      example: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: Slot actual de la blockchain de Solana para esta respuesta
    TokenAccountList:
      type: object
      required:
        - items
      properties:
        cursor:
          $ref: '#/components/schemas/Base58String'
          description: >-
            Cursor de paginación para recuperar el siguiente conjunto de cuentas
            de tokens comprimidos en solicitudes posteriores
        items:
          type: array
          items:
            $ref: '#/components/schemas/TokenAcccount'
          description: >-
            Arreglo de cuentas de tokens comprimidos que pertenecen a la
            dirección especificada de la billetera de Solana
    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 del 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'
    TokenAcccount:
      type: object
      required:
        - account
        - tokenData
      properties:
        account:
          $ref: '#/components/schemas/Account'
          description: >-
            Información de la cuenta comprimida correspondiente a la cuenta de
            token en Solana, incluida la posición en el árbol y los datos de
            verificación
        tokenData:
          $ref: '#/components/schemas/TokenData'
          description: >-
            Datos específicos relacionados con el token, incluidos el saldo, la
            acuñación, el propietario y el estado de delegación
      additionalProperties: false
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: La dirección única de la cuenta comprimida en Solana
        data:
          $ref: '#/components/schemas/AccountData'
          description: Datos de la cuenta almacenados en formato comprimido en 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 lamports asociado con la cuenta comprimida
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Posición del índice en el árbol de Merkle donde se almacena la
            cuenta comprimida
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Programa de Solana que posee esta cuenta comprimida
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Número de secuencia para rastrear las actualizaciones de la cuenta
            comprimida
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Slot de la blockchain de Solana en el que se creó la cuenta
            comprimida
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Dirección del árbol de Merkle que contiene esta cuenta comprimida
      additionalProperties: false
    TokenData:
      type: object
      required:
        - mint
        - owner
        - amount
        - state
      properties:
        amount:
          $ref: '#/components/schemas/UnsignedInteger'
          description: >-
            Cantidad del saldo de tokens que contiene esta cuenta de token
            comprimido
        delegate:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Dirección opcional del delegado autorizado para realizar operaciones
            en esta cuenta de token comprimido
        mint:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            La dirección de acuñación del token SPL de Solana a la que pertenece
            esta cuenta de token comprimido
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            La dirección de la billetera de Solana que posee esta cuenta de
            token comprimido
        state:
          $ref: '#/components/schemas/AccountState'
          description: >-
            Estado actual de la cuenta de token comprimido (inicializada o
            congelada)
        tlv:
          $ref: '#/components/schemas/Base64String'
          description: >-
            Datos opcionales codificados como tipo-longitud-valor para ampliar
            la información de la cuenta de token
    AccountData:
      type: object
      required:
        - discriminator
        - data
        - dataHash
      properties:
        data:
          $ref: '#/components/schemas/Base64String'
          description: Datos codificados en base64 de la cuenta comprimida de Solana
        dataHash:
          $ref: '#/components/schemas/Hash'
          description: >-
            Hash de los datos de la cuenta comprimida para verificar su
            integridad
        discriminator:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Identificador del tipo de cuenta en el programa de Solana
      additionalProperties: false
    Hash:
      type: string
      description: >-
        Hash criptográfico de 32 bytes representado como una cadena base58 para
        verificar datos de Solana.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
      description: >-
        Valor entero no negativo utilizado para cantidades de tokens, números de
        secuencia y otros valores numéricos
    AccountState:
      type: string
      enum:
        - initialized
        - frozen
      description: >-
        Estado actual de la cuenta de token comprimido (inicializada o
        congelada)
    Base64String:
      type: string
      description: >-
        Cadena codificada en base64 para almacenar datos binarios en cuentas
        comprimidas de 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).

````