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

> Возвращает сжатые токен-аккаунты, принадлежащие указанному аккаунту.

## Параметры запроса

<ParamField body="cursor" type="string" default="3J98t1WpEZ73CNm">
  Курсор пагинации для получения последующих наборов сжатых токен-аккаунтов в кошельках Solana с большим количеством активов
</ParamField>

<ParamField body="limit" type="number">
  Максимальное количество сжатых токен-аккаунтов, возвращаемых за один запрос (для пагинации)
</ParamField>

<ParamField body="mint" type="string" default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  Фильтрует сжатые токен-аккаунты по указанному адресу выпуска токена Solana
</ParamField>

<ParamField body="owner" type="string" required default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  Публичный ключ Solana, представленный в виде строки base58 для адресов аккаунтов и кошельков.
</ParamField>


## OpenAPI

````yaml ru/openapi/zk-compression/getCompressedTokenAccountsByOwner.yaml POST /
openapi: 3.0.3
info:
  title: API портфеля сжатых токенов Solana
  description: >
    Продвинутый индексатор Solana для аккаунтов сжатых токенов, использующий
    технологию сжатия состояния для эффективного и экономичного хранения и
    получения токенов.

    Этот API предоставляет оптимизированный доступ к сжатым токенам и NFT
    Solana, позволяя сократить расходы до 1000 раз, сохраняя при этом 

    полную безопасность и совместимость с экосистемой токенов Solana. Идеально
    подходит для приложений-кошельков, маркетплейсов и dApp на основе токенов,

    которым требуется эффективное управление портфелем сжатых активов.
  license:
    name: Apache-2.0
  version: 0.50.0
servers:
  - url: https://mainnet.helius-rpc.com
    description: RPC-эндпоинт Mainnet
  - url: https://devnet.helius-rpc.com
    description: RPC-эндпоинт Devnet
security: []
paths:
  /:
    summary: getCompressedTokenAccountsByOwner
    post:
      description: >
        Получает все аккаунты сжатых токенов, принадлежащие указанному адресу
        кошелька Solana. 

        Этот эндпоинт портфеля предоставляет полные данные о сжатых SPL-токенах
        и NFT, 

        позволяя значительно сократить расходы благодаря технологии сжатия
        состояния Solana. Фильтруйте результаты по адресу выпуска токена, 

        эффективно разбивайте большие коллекции на страницы и получайте
        подробные данные аккаунтов с полной проверкой владения.


        Основные преимущества:

        - Снижение расходов на хранение аккаунтов токенов в блокчейне (до 1000
        раз)

        - Поддержка крупномасштабных интеграций кошельков с эффективной
        пагинацией

        - Совместимость со стандартом SPL-токенов Solana и сжатыми NFT

        - Фильтрация по выпуску токена для целевых запросов токенов

        - Полные данные аккаунтов токенов, включая балансы, делегатов и
        состояния
      operationId: getCompressedTokenAccountsByOwner
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: Версия протокола JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Идентификатор запроса.
                  default: '1'
                method:
                  type: string
                  description: Имя вызываемого метода.
                  enum:
                    - getCompressedTokenAccountsByOwner
                  default: getCompressedTokenAccountsByOwner
                params:
                  type: object
                  required:
                    - owner
                  properties:
                    cursor:
                      allOf:
                        - $ref: '#/components/schemas/Base58String'
                      nullable: true
                      description: >-
                        Курсор пагинации для получения последующих наборов
                        аккаунтов сжатых токенов в кошельках Solana с большим
                        количеством активов
                    limit:
                      allOf:
                        - $ref: '#/components/schemas/Limit'
                      nullable: true
                      description: >-
                        Максимальное количество аккаунтов сжатых токенов,
                        возвращаемых за один запрос (для пагинации)
                    mint:
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: >-
                        Фильтрация аккаунтов сжатых токенов по указанному адресу
                        выпуска токена Solana
                    owner:
                      $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Адрес кошелька Solana, которому принадлежат получаемые
                        аккаунты сжатых токенов
                  additionalProperties: false
        required: true
      responses:
        '200':
          description: >-
            Аккаунты сжатых токенов для указанного владельца кошелька успешно
            получены из блокчейна Solana
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                  - value
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/TokenAccountList'
                additionalProperties: false
        '400':
          description: >-
            Некорректный запрос — недопустимые параметры или неправильный формат
            запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Недопустимые параметры
                id: '1'
        '401':
          description: Не авторизовано — недействительный или отсутствующий ключ API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Не авторизовано
                id: '1'
        '429':
          description: Слишком много запросов — превышен лимит запросов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Слишком много запросов
                id: '1'
        '500':
          description: Внутренняя ошибка сервера — на сервере произошла ошибка.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Внутренняя ошибка
                id: '1'
        '503':
          description: Сервис недоступен — сервис временно недоступен.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Сервис недоступен
                id: '1'
        '504':
          description: Истекло время ожидания шлюза — время ожидания запроса истекло.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Истекло время ожидания шлюза
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    Base58String:
      type: string
      description: >-
        Строка в кодировке Base58, используемая для адресов и идентификаторов
        Solana.
      default: 3J98t1WpEZ73CNm
      example: 3J98t1WpEZ73CNm
    Limit:
      type: integer
      format: int64
      minimum: 0
      description: >-
        Максимальное количество аккаунтов сжатых токенов, возвращаемых в одном
        запросе
    SerializablePubkey:
      type: string
      description: >-
        Открытый ключ Solana, представленный строкой Base58 для адресов
        аккаунтов и кошельков.
      default: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
      example: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: Текущий слот блокчейна Solana для этого ответа
    TokenAccountList:
      type: object
      required:
        - items
      properties:
        cursor:
          $ref: '#/components/schemas/Base58String'
          description: >-
            Курсор пагинации для получения следующего набора аккаунтов сжатых
            токенов в последующих запросах
        items:
          type: array
          items:
            $ref: '#/components/schemas/TokenAcccount'
          description: >-
            Массив аккаунтов сжатых токенов, принадлежащих указанному адресу
            кошелька Solana
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Версия протокола JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Код ошибки.
              example: -32602
            message:
              type: string
              description: Сообщение об ошибке.
            data:
              type: object
              description: Дополнительные данные об ошибке.
        id:
          type: string
          description: Идентификатор, соответствующий запросу.
          example: '1'
    TokenAcccount:
      type: object
      required:
        - account
        - tokenData
      properties:
        account:
          $ref: '#/components/schemas/Account'
          description: >-
            Сведения о сжатом аккаунте для аккаунта токена в Solana, включая
            позицию в дереве и данные для проверки
        tokenData:
          $ref: '#/components/schemas/TokenData'
          description: >-
            Данные токена, включая баланс, выпуск, владельца и статус
            делегирования
      additionalProperties: false
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Уникальный адрес сжатого аккаунта в Solana
        data:
          $ref: '#/components/schemas/AccountData'
          description: Данные аккаунта, хранящиеся в Solana в сжатом формате
        hash:
          $ref: '#/components/schemas/Hash'
          description: Криптографический хеш данных сжатого аккаунта для проверки
        lamports:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Баланс в лампортах, связанный со сжатым аккаунтом
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Позиция индекса в дереве Меркла, где хранится сжатый аккаунт
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Программа Solana, владеющая этим сжатым аккаунтом
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Порядковый номер для отслеживания обновлений сжатого аккаунта
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Слот блокчейна Solana, в котором был создан сжатый аккаунт
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Адрес дерева Меркла, содержащего этот сжатый аккаунт
      additionalProperties: false
    TokenData:
      type: object
      required:
        - mint
        - owner
        - amount
        - state
      properties:
        amount:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Количество токенов на балансе этого аккаунта сжатого токена
        delegate:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Необязательный адрес делегата, уполномоченного выполнять операции с
            этим аккаунтом сжатого токена
        mint:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Адрес выпуска SPL-токена Solana, к которому относится этот аккаунт
            сжатого токена
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Адрес кошелька Solana, которому принадлежит этот аккаунт сжатого
            токена
        state:
          $ref: '#/components/schemas/AccountState'
          description: >-
            Текущее состояние аккаунта сжатого токена (инициализирован или
            заморожен)
        tlv:
          $ref: '#/components/schemas/Base64String'
          description: >-
            Необязательные данные в кодировке «тип — длина — значение» для
            расширенной информации об аккаунте токена
    AccountData:
      type: object
      required:
        - discriminator
        - data
        - dataHash
      properties:
        data:
          $ref: '#/components/schemas/Base64String'
          description: Данные сжатого аккаунта Solana, закодированные в Base64
        dataHash:
          $ref: '#/components/schemas/Hash'
          description: Хеш данных сжатого аккаунта для проверки целостности
        discriminator:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Идентификатор типа аккаунта в программе Solana
      additionalProperties: false
    Hash:
      type: string
      description: >-
        32-байтовый криптографический хеш, представленный строкой Base58 для
        проверки данных Solana.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
      description: >-
        Неотрицательное целое число, используемое для количества токенов,
        порядковых номеров и других числовых значений
    AccountState:
      type: string
      enum:
        - initialized
        - frozen
      description: >-
        Текущее состояние аккаунта сжатого токена (инициализирован или
        заморожен)
    Base64String:
      type: string
      description: >-
        Строка в кодировке Base64 для хранения двоичных данных в сжатых
        аккаунтах Solana.
      default: SGVsbG8sIFdvcmxkIQ==
      example: SGVsbG8sIFdvcmxkIQ==
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ваш ключ API Helius. Его можно бесплатно получить на [панели
        управления](https://dashboard.helius.dev/api-keys).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.