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

# getTokenAccountsByOwner

> getTokenAccountsByOwner возвращает все аккаунты SPL-токенов, принадлежащие кошельку Solana, с фильтрацией по адресу выпуска токена или токен-программе и инкрементальной синхронизацией с помощью changedSinceSlot.

<Info>
  **Новая функция**: `getTokenAccountsByOwner` теперь поддерживает параметр `changedSinceSlot` для инкрементальных обновлений. Если он указан, метод возвращает только аккаунты токенов, измененные в указанном слоте или после него. Это удобно для отслеживания изменений баланса токенов и обновлений портфеля.
</Info>

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

<ParamField body="address" type="string" required>
  Адрес кошелька Solana (публичный ключ) владельца аккаунта, для которого запрашиваются токены, в виде строки в кодировке base-58.
</ParamField>

<ParamField body="mint" type="string">
  Адрес выпуска определенного токена Solana, чтобы получить только аккаунты конкретного токена или NFT.
</ParamField>

<ParamField body="programId" type="string">
  Идентификатор определенной токен-программы Solana (обычно программы SPL Token), создавшей аккаунты токенов.
</ParamField>

<ParamField body="commitment" type="string">
  Уровень подтверждения для запроса.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>

<ParamField body="minContextSlot" type="number">
  Минимальный слот, в котором может быть обработан запрос.
</ParamField>

<ParamField body="dataSlice" type="object">
  Запрос части данных аккаунта.
</ParamField>

<ParamField body="dataSlice.length" type="number">
  Количество возвращаемых байтов.
</ParamField>

<ParamField body="dataSlice.offset" type="number">
  Смещение в байтах, с которого начинается чтение.
</ParamField>

<ParamField body="encoding" type="string">
  Формат кодирования данных аккаунта.

  * `base58`
  * `base64`
  * `base64+zstd`
  * `jsonParsed`
</ParamField>

<ParamField body="changedSinceSlot" type="number">
  Возвращать только аккаунты, измененные в этом слоте или после него. Полезно для инкрементальных обновлений.
</ParamField>


## OpenAPI

````yaml ru/openapi/rpc-http/getTokenAccountsByOwner.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    Комплексный API для обнаружения токен-аккаунтов Solana, позволяющий получать
    балансы токенов SPL, NFT и сведения о других токенах, связанных с любым
    адресом кошелька в блокчейне Solana.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Конечная точка RPC основной сети
  - url: https://devnet.helius-rpc.com
    description: Конечная точка RPC тестовой сети Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenAccountsByOwner
      description: >
        Получает все токен-аккаунты SPL, принадлежащие определённому адресу
        кошелька Solana, с расширенными возможностями фильтрации.

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

        с возможностью фильтрации по определённым адресам выпуска токенов или
        ограничения результатов аккаунтами, созданными конкретными
        токен-программами.

        Поддерживает разобранные данные для представления информации о токенах в
        удобочитаемом формате, включая балансы, количество знаков после запятой
        и статус владения.

        Необходим для кошельков, средств отслеживания портфелей и приложений
        DeFi, которым требуются полные данные о токенах.
      operationId: getTokenAccountsByOwner
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: Версия протокола JSON-RPC.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Уникальный идентификатор запроса.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenAccountsByOwner
                  description: Имя вызываемого метода RPC.
                  example: getTokenAccountsByOwner
                  default: getTokenAccountsByOwner
                params:
                  type: array
                  description: >-
                    Параметры запроса токен-аккаунтов, принадлежащих
                    определённому открытому ключу.
                  default:
                    - A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
                    - programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                    - encoding: jsonParsed
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Адрес кошелька Solana (открытый ключ) владельца
                          аккаунта, для которого запрашиваются сведения о
                          токенах, в виде строки с кодировкой base58.
                        example: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
                      - type: object
                        description: >-
                          Конфигурация фильтра для отбора токен-аккаунтов по
                          адресу выпуска или идентификатору программы.
                        properties:
                          mint:
                            type: string
                            description: >-
                              Определённый адрес выпуска токена Solana,
                              позволяющий получить только аккаунты конкретного
                              токена или NFT.
                            example: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
                          programId:
                            type: string
                            description: >-
                              Идентификатор определённой токен-программы Solana
                              (обычно программы SPL Token), создавшей
                              токен-аккаунты.
                            example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                      - type: object
                        description: Объект конфигурации с необязательными полями.
                        properties:
                          commitment:
                            type: string
                            description: Уровень подтверждения для запроса.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Минимальный слот, в котором может быть обработан
                              запрос.
                            example: 1000
                          dataSlice:
                            type: object
                            description: Запрашивает фрагмент данных аккаунта.
                            properties:
                              length:
                                type: integer
                                description: Количество возвращаемых байтов.
                                example: 10
                              offset:
                                type: integer
                                description: >-
                                  Смещение в байтах, с которого начинается
                                  чтение.
                                example: 0
                          encoding:
                            type: string
                            description: Формат кодирования данных аккаунта.
                            enum:
                              - base58
                              - base64
                              - base64+zstd
                              - jsonParsed
                            example: jsonParsed
                          changedSinceSlot:
                            type: integer
                            description: >-
                              Возвращает только аккаунты, изменённые в этом
                              слоте или после него. Полезно для инкрементальных
                              обновлений.
                            example: 464175999
      responses:
        '200':
          description: Токен-аккаунты владельца успешно получены.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Версия протокола JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Идентификатор, соответствующий запросу.
                    example: '1'
                  result:
                    type: object
                    description: Контекст и сведения об аккаунте.
                    properties:
                      context:
                        type: object
                        description: Контекст ответа.
                        properties:
                          apiVersion:
                            type: string
                            description: Версия API.
                            example: 2.0.15
                          slot:
                            type: integer
                            description: Слот, в котором были получены данные.
                            example: 341197933
                      value:
                        type: array
                        description: Список токен-аккаунтов.
                        items:
                          type: object
                          properties:
                            pubkey:
                              type: string
                              description: >-
                                Открытый ключ аккаунта в виде строки с
                                кодировкой base58.
                              example: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
                            account:
                              type: object
                              description: Сведения о токен-аккаунте.
                              properties:
                                lamports:
                                  type: integer
                                  description: Количество лампортов, назначенных аккаунту.
                                  example: 2039280
                                owner:
                                  type: string
                                  description: >-
                                    Открытый ключ программы, которой назначен
                                    этот аккаунт.
                                  example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                                data:
                                  type: object
                                  description: >-
                                    Связанные с аккаунтом данные о состоянии
                                    токена.
                                  properties:
                                    program:
                                      type: string
                                      description: Имя программы.
                                      example: spl-token
                                    parsed:
                                      type: object
                                      description: Разобранные данные токена.
                                      properties:
                                        info:
                                          type: object
                                          description: Информация о токен-аккаунте.
                                          properties:
                                            isNative:
                                              type: boolean
                                              description: >-
                                                Указывает, содержит ли аккаунт нативные
                                                SOL.
                                              example: false
                                            mint:
                                              type: string
                                              description: Открытый ключ выпуска токена.
                                              example: >-
                                                2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
                                            owner:
                                              type: string
                                              description: Открытый ключ владельца аккаунта.
                                              example: >-
                                                A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
                                            state:
                                              type: string
                                              description: Состояние токен-аккаунта.
                                              example: initialized
                                            tokenAmount:
                                              type: object
                                              description: Сведения о количестве токенов.
                                              properties:
                                                amount:
                                                  type: string
                                                  description: >-
                                                    Необработанный баланс без учёта знаков
                                                    после запятой.
                                                  example: '420000000000000'
                                                decimals:
                                                  type: integer
                                                  description: Количество знаков после запятой.
                                                  example: 6
                                                uiAmount:
                                                  type: number
                                                  description: Баланс в удобочитаемом формате.
                                                  example: 420000000
                                                uiAmountString:
                                                  type: string
                                                  description: Баланс в виде строки.
                                                  example: '420000000'
                                    space:
                                      type: integer
                                      description: >-
                                        Объём пространства, выделенного
                                        аккаунту.
                                      example: 165
                                executable:
                                  type: boolean
                                  description: Указывает, содержит ли аккаунт программу.
                                  example: false
                                rentEpoch:
                                  type: integer
                                  description: >-
                                    Эпоха, в которой аккаунт должен будет внести
                                    следующую арендную плату.
                                  example: 18446744073709552000
                                space:
                                  type: integer
                                  description: Размер данных аккаунта.
                                  example: 165
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    apiVersion: 2.0.15
                    slot: 341197933
                  value:
                    - pubkey: BGocb4GEpbTFm8UFV2VsDSaBXHELPfAXrvd4vtt8QWrA
                      account:
                        lamports: 2039280
                        owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                        data:
                          program: spl-token
                          parsed:
                            info:
                              isNative: false
                              mint: 2cHr7QS3xfuSV8wdxo3ztuF4xbiarF6Nrgx3qpx3HzXR
                              owner: A1TMhSGzQxMr1TboBKtgixKz1sS6REASMxPo1qsyTSJd
                              state: initialized
                              tokenAmount:
                                amount: '420000000000000'
                                decimals: 6
                                uiAmount: 420000000
                                uiAmountString: '420000000'
                          space: 165
                        executable: false
                        rentEpoch: 18446744073709552000
                        space: 165
        '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:
    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'
  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.