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

# getTransfersByAddress

> Запрашивайте по адресу разобранные, удобочитаемые объекты переводов токенов и нативного SOL с фильтрами по минту, времени, сумме, контрагенту и поддержкой пагинации.

## Обзор

`getTransfersByAddress` возвращает разобранные, удобочитаемые объекты переводов токенов и нативного SOL, в которых участвует адрес кошелька. Используйте фильтры, чтобы ограничить результаты по минту, времени блока, сумме, слоту, направлению или контрагенту. Ответ предназначен для точного отображения активности кошелька, отслеживания платежей и сверки баланса без повторной реализации разбора переводов Solana.

<Note>
  Переводы при выпуске и сжигании являются односторонними. Операции выпуска имеют `fromUserAccount: null` и могут возвращаться только как входящие переводы для получателя. Операции сжигания имеют `toUserAccount: null` и могут возвращаться только как исходящие переводы для владельца, выполняющего сжигание.
</Note>

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

<ParamField body="address" type="string" required>
  Закодированный в Base58 адрес кошелька владельца, для которого запрашиваются переводы. Передайте адрес владельца кошелька, а не связанного токен-аккаунта (ATA).
</ParamField>

<ParamField body="with" type="string">
  Фильтр по адресу контрагента. Возвращает только переводы на этот адрес или с него.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Фильтр по направлению перевода относительно запрашиваемого адреса.

  * `in`
  * `out`
  * `any`
</ParamField>

<ParamField body="mint" type="string">
  Адрес минта токена. Используйте So11111111111111111111111111111111111111111 для нативного SOL и So11111111111111111111111111111111111111112 для WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  Режим отображения SOL/WSOL. Режим merged обрабатывает WSOL как нативный SOL и исключает строки обёртывания и развёртывания, упрощая сверку истории в SOL; режим separate сохраняет WSOL как отдельный минт SPL-токена и включает строки обёртывания и развёртывания.

  * `merged`
  * `separate`
</ParamField>

<ParamField body="filters" type="object">
  Дополнительные фильтры по сумме, времени блока и слоту.
</ParamField>

<ParamField body="filters.amount" type="object">
  Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  Больше.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  Больше или равно.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  Меньше.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  Меньше или равно.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  Больше.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  Больше или равно.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  Меньше.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  Меньше или равно.
</ParamField>

<ParamField body="filters.slot" type="object">
  Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  Больше.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  Больше или равно.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  Меньше.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  Меньше или равно.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Максимальное количество возвращаемых переводов. Диапазон: от 1 до 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Курсор из предыдущего ответа для пагинации.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  Уровень подтверждения данных.

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

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

<ParamField body="sortOrder" type="string" default="desc">
  Порядок результатов.

  * `asc`
  * `desc`
</ParamField>


## OpenAPI

````yaml ru/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API истории Solana для переводов, позволяющий запрашивать по адресу
    разобранные и понятные человеку объекты переводов токенов и нативного SOL с
    фильтрами по адресу выпуска, времени, сумме и контрагенту. Предназначен для
    точного отображения активности кошелька, отслеживания платежей и сверки
    баланса.
  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: getTransfersByAddress
      description: >
        Возвращает разобранные и понятные человеку объекты переводов токенов и
        нативного SOL для

        адреса кошелька. Этот метод RPC Helius возвращает краткие записи,

        относящиеся к переводам, вместо полных данных транзакций и предназначен
        для точного

        отображения активности кошелька, отслеживания платежей и сверки баланса.


        Историю переводов можно фильтровать по адресу выпуска, времени блока,
        сумме, слоту,

        направлению и контрагенту.
      operationId: getTransfersByAddress
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  example: '2.0'
                  description: Версия протокола JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Уникальный идентификатор запроса.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: Имя вызываемого метода RPC.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Массив, содержащий обязательный адрес кошелька и
                    необязательный объект конфигурации.
                  minItems: 1
                  maxItems: 2
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Адрес кошелька владельца в кодировке Base58, для
                          которого нужно запросить переводы. Передайте адрес
                          владельца кошелька, а не связанный токен-аккаунт
                          (ATA).
                        example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                      - type: object
                        description: Необязательная конфигурация запроса переводов.
                        properties:
                          with:
                            type: string
                            description: >-
                              Фильтр по адресу контрагента. Возвращает только
                              переводы на этот адрес или с него.
                            example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          direction:
                            type: string
                            description: >-
                              Фильтр по направлению перевода относительно
                              запрашиваемого адреса.
                            enum:
                              - in
                              - out
                              - any
                            default: any
                            example: in
                          mint:
                            type: string
                            description: >-
                              Адрес выпуска токена. Используйте
                              So11111111111111111111111111111111111111111 для
                              нативного SOL и
                              So11111111111111111111111111111111111111112 для
                              WSOL.
                            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          solMode:
                            type: string
                            description: >-
                              Режим отображения SOL/WSOL. Значение merged
                              обрабатывает WSOL как нативный SOL и исключает
                              строки wrap/unwrap, упрощая сверку истории в SOL;
                              значение separate сохраняет WSOL как отдельный
                              адрес выпуска токена SPL и включает строки
                              wrap/unwrap.
                            enum:
                              - merged
                              - separate
                            default: merged
                            example: merged
                          filters:
                            type: object
                            description: >-
                              Дополнительные фильтры по сумме, времени блока и
                              слоту.
                            properties:
                              amount:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Фильтр по исходной сумме перевода, а не по
                                  сумме для пользовательского интерфейса.
                              blockTime:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Фильтр по временной метке блока в секундах
                                  Unix.
                              slot:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: Фильтр по номеру слота.
                            additionalProperties: false
                          limit:
                            type: integer
                            description: >-
                              Максимальное количество возвращаемых переводов.
                              Диапазон от 1 до 100.
                            minimum: 1
                            maximum: 100
                            default: 100
                            example: 50
                          paginationToken:
                            type: string
                            description: >-
                              Курсор из предыдущего ответа для постраничного
                              вывода.
                            example: 315069220:308:2:1:splTransfer
                          commitment:
                            type: string
                            description: Уровень подтверждения данных.
                            enum:
                              - finalized
                              - confirmed
                            default: finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Минимальный слот контекста для запроса
                              (необязательно).
                            example: 1000
                          sortOrder:
                            type: string
                            description: Порядок результатов.
                            enum:
                              - asc
                              - desc
                            default: desc
                            example: desc
                        additionalProperties: false
      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:
                      data:
                        type: array
                        description: Список записей о переводах.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: >-
                              Курсор для получения следующей страницы
                              результатов.
                          - type: 'null'
                        description: >-
                          Курсор для следующей страницы или null, если других
                          результатов нет.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Ответ с переводами
                  value:
                    jsonrpc: '2.0'
                    id: '1'
                    result:
                      data:
                        - signature: >-
                            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
                          slot: 315073428
                          blockTime: 1736159420
                          type: transfer
                          fromUserAccount: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          toUserAccount: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                          fromTokenAccount: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
                          toTokenAccount: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
                          mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          amount: '2500000'
                          decimals: 6
                          uiAmount: '2.5'
                          confirmationStatus: finalized
                          transactionIdx: 35
                          instructionIdx: 1
                          innerInstructionIdx: 0
                      paginationToken: 315073428:35:1:0:splTransfer
        '400':
          description: >-
            Некорректный запрос — недопустимые параметры или неправильный формат
            запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Не авторизовано — недействительный или отсутствующий ключ API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Слишком много запросов — превышено ограничение частоты запросов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Внутренняя ошибка сервера — на сервере произошла ошибка.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Сервис недоступен — сервис временно недоступен.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Истекло время ожидания шлюза — время ожидания запроса истекло.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TransferComparisonFilter:
      type: object
      description: >-
        Фильтр сравнения диапазона. Все поля необязательны и могут
        комбинироваться.
      properties:
        gt:
          type: number
          description: Больше.
          example: 1000000
        gte:
          type: number
          description: Больше или равно.
          example: 1000000
        lt:
          type: number
          description: Меньше.
          example: 1000000000
        lte:
          type: number
          description: Меньше или равно.
          example: 1000000000
      additionalProperties: false
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Подпись транзакции в кодировке Base58.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Номер слота, содержащего транзакцию.
          example: 315073428
        blockTime:
          type: integer
          description: Временная метка Unix блока в секундах.
          example: 1736159420
        type:
          type: string
          description: Разобранный тип перевода.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Адрес кошелька, отправившего токены, или null, если отправителя нет.
            Это поле присутствует всегда.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Адрес кошелька, получившего токены, или null, если получателя нет.
            Это поле присутствует всегда.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Исходный токен-аккаунт. Не указывается, если неприменим, например
            при переводах нативного SOL.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Целевой токен-аккаунт. Не указывается, если неприменим, например при
            переводах нативного SOL.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Адрес выпуска токена. Для нативного SOL используется
            So11111111111111111111111111111111111111111; для WSOL используется
            So11111111111111111111111111111111111111112, когда solMode имеет
            значение separate.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Исходная сумма перевода в виде строки для сохранения точности. Для
            переводов Token-2022 с комиссией это сумма, полученная целевым
            аккаунтом.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Комиссия за перевод, удержанная расширением комиссии за перевод
            Token-2022. Присутствует только в переводах с комиссией. Для таких
            переводов с исходного аккаунта списывается amount плюс feeAmount, а
            на целевой аккаунт зачисляется amount.
          example: '13450000'
        decimals:
          type: integer
          description: >-
            Количество десятичных знаков токена. Для нативного SOL используется
            9.
          example: 6
        uiAmount:
          type: string
          description: Сумма в удобном для чтения виде.
          example: '2.5'
        feeUiAmount:
          type: string
          description: >-
            Сумма комиссии в удобном для чтения виде. Присутствует только при
            наличии feeAmount.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Статус подтверждения.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Индекс транзакции в блоке.
          example: 35
        instructionIdx:
          type: integer
          description: Индекс инструкции в транзакции.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Индекс среди внутренних инструкций. Равен нулю, если перевод
            выполняется на верхнем уровне.
          example: 0
      required:
        - signature
        - slot
        - blockTime
        - type
        - fromUserAccount
        - toUserAccount
        - mint
        - amount
        - decimals
        - uiAmount
        - confirmationStatus
        - transactionIdx
        - instructionIdx
        - innerInstructionIdx
      additionalProperties: false
    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.