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

> Consulta objetos de transferência de tokens e SOL nativo analisados e legíveis por humanos, por endereço, com filtros por mint, tempo, quantidade, contraparte e paginação.

## Visão Geral

`getTransfersByAddress` retorna objetos de transferência analisados e legíveis por humanos para movimento de token e SOL nativo envolvendo um endereço de carteira. Use filtros para restringir os resultados por mint, tempo de bloco, quantidade, slot, direção ou contraparte. A resposta é projetada para visualizações precisas de atividades de carteira, acompanhamento de pagamentos e reconciliação de saldos sem reimplementar a análise de transferência Solana.

<Note>
  Transferências de mint e burn são unilaterais. Mints têm `fromUserAccount: null` e só podem ser retornados como transferências de entrada para o destinatário. Burns têm `toUserAccount: null` e só podem ser retornados como transferências de saída para o proprietário que queima.
</Note>

## Parâmetros de Requisição

<ParamField body="address" type="string" required>
  Endereço de carteira do proprietário codificado em Base58 para consultar transferências. Passe o endereço do proprietário da carteira, não uma conta de token associada (ATA).
</ParamField>

<ParamField body="with" type="string">
  Filtre por endereço de contraparte. Retorna apenas transferências para ou deste endereço.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Filtre pela direção da transferência em relação ao endereço consultado.

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

<ParamField body="mint" type="string">
  Endereço de mint do token. Use So11111111111111111111111111111111111111111 para SOL nativo e So11111111111111111111111111111111111111112 para WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  Modo de exibição SOL/WSOL. merged trata WSOL como SOL nativo e exclui linhas de wrap/unwrap para que o histórico denominado em SOL seja mais fácil de reconciliar; separate preserva WSOL como um mint de token SPL distinto e inclui linhas de wrap/unwrap.

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

<ParamField body="filters" type="object">
  Filtros adicionais para quantidade, tempo de bloco e slot.
</ParamField>

<ParamField body="filters.amount" type="object">
  Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  Maior que.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  Maior ou igual a.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  Menor que.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  Menor ou igual a.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  Maior que.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  Maior ou igual a.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  Menor que.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  Menor ou igual a.
</ParamField>

<ParamField body="filters.slot" type="object">
  Filtro de comparação de intervalo. Todos os campos são opcionais e podem ser combinados.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  Maior que.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  Maior ou igual a.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  Menor que.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  Menor ou igual a.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Número máximo de transferências a serem retornadas. Intervalo de 1 a 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Cursor da resposta anterior para paginação.
</ParamField>

<ParamField body="example" type="any" />

<ParamField body="commitment" type="string" default="finalized">
  Nível de compromisso de dados.

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

<ParamField body="minContextSlot" type="number">
  Slot de contexto mínimo para usar na requisição (opcional).
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  Ordenação dos resultados.

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


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de histórico específico de transferências da Solana para consulta de
    objetos de transferência de tokens e SOL nativo analisados e legíveis por
    humanos por endereço, com filtros por mint, tempo, quantidade e contraparte.
    Projetado para visualizações precisas de atividade de carteira, rastreamento
    de pagamentos e reconciliação de saldo.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Ponto de extremidade Mainnet RPC
  - url: https://devnet.helius-rpc.com
    description: Ponto de extremidade Devnet RPC
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        Retorna objetos de transferência de tokens e SOL nativo analisados e
        legíveis por humanos para

        um endereço de carteira. Este método Helius RPC retorna registros
        concisos, específicos de transferência

        em vez de cargas de transação completas e é projetado para visualizações
        precisas

        de atividade de carteira, rastreamento de pagamentos e reconciliação de
        saldo.


        Você pode filtrar o histórico de transferências por mint, tempo do
        bloco, quantidade, slot,

        direção e contraparte.
      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: A versão do protocolo JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Um identificador único para a solicitação.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: O nome do método RPC a ser invocado.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Array contendo o endereço da carteira necessário e o objeto
                    de configuração opcional.
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                  minItems: 1
                  maxItems: 2
                  prefixItems:
                    - type: string
                      description: >-
                        Endereço da carteira do proprietário codificado em
                        Base58 para consultar transferências. Passe o endereço
                        do proprietário da carteira, não uma conta de token
                        associada (ATA).
                      example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - type: object
                      description: Configuração de consulta de transferência opcional.
                      properties:
                        with:
                          type: string
                          description: >-
                            Filtrar por endereço de contraparte. Retorna apenas
                            transferências para ou deste endereço.
                          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                        direction:
                          type: string
                          description: >-
                            Filtrar por direção de transferência em relação ao
                            endereço consultado.
                          enum:
                            - in
                            - out
                            - any
                          default: any
                          example: in
                        mint:
                          type: string
                          description: >-
                            Endereço de mint do token. Use
                            So11111111111111111111111111111111111111111 para SOL
                            nativo e So11111111111111111111111111111111111111112
                            para WSOL.
                          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                        solMode:
                          type: string
                          description: >-
                            Modo de exibição SOL/WSOL. merged trata WSOL como
                            SOL nativo e exclui linhas de wrap/unwrap para que o
                            histórico denominado em SOL seja mais fácil de
                            reconciliar; separate preserva WSOL como um mint SPL
                            token distinto e inclui linhas de wrap/unwrap.
                          enum:
                            - merged
                            - separate
                          default: merged
                          example: merged
                        filters:
                          type: object
                          description: >-
                            Filtros adicionais para quantia, tempo do bloco e
                            slot.
                          properties:
                            amount:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: >-
                                Filtrar por quantidade bruta de transferência,
                                não por quantidade de UI.
                            blockTime:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: Filtrar por timestamp do bloco em segundos Unix.
                            slot:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: Filtrar por número do slot.
                          additionalProperties: false
                        limit:
                          type: integer
                          description: >-
                            Número máximo de transferências a retornar.
                            Intervalo de 1 a 100.
                          minimum: 1
                          maximum: 100
                          default: 100
                          example: 50
                        paginationToken:
                          type: string
                          description: Cursor da resposta anterior para paginação.
                        example: 315069220:308:2:1:splTransfer
                        commitment:
                          type: string
                          description: Nível de compromisso de dados.
                          enum:
                            - finalized
                            - confirmed
                          default: finalized
                          example: finalized
                        minContextSlot:
                          type: integer
                          description: >-
                            Slot de contexto mínimo a ser usado para a
                            solicitação (opcional).
                          example: 1000
                        sortOrder:
                          type: string
                          description: Ordenação dos resultados.
                          enum:
                            - asc
                            - desc
                          default: desc
                          example: desc
                      additionalProperties: false
                  items: false
                  example:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
      responses:
        '200':
          description: Transferências recuperadas com sucesso para o endereço especificado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: A versão do protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador correspondente à solicitação.
                    example: '1'
                  result:
                    type: object
                    description: Dados de transferência e informações de paginação.
                    properties:
                      data:
                        type: array
                        description: Lista de registros de transferência.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: >-
                              Cursor para recuperar a próxima página de
                              resultados.
                          - type: 'null'
                        description: >-
                          Cursor para a próxima página ou nulo se não houver
                          mais resultados disponíveis.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Resposta de transferência
                  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: >-
            Solicitação inválida - Parâmetros de solicitação inválidos ou
            solicitação malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Não autorizado - Chave de API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Muitas solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Erro interno do servidor - Um erro ocorreu no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Serviço indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Tempo limite do gateway - A solicitação expirou.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Assinatura da transação codificada em Base58.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Número do slot contendo a transação.
          example: 315073428
        blockTime:
          type: integer
          description: Timestamp Unix em segundos para o bloco.
          example: 1736159420
        type:
          type: string
          description: Tipo de transferência analisada.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Endereço da carteira que enviou os tokens ou nulo quando não existe
            remetente. Este campo está sempre presente.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Endereço da carteira que recebeu os tokens ou nulo quando não existe
            destinatário. Este campo está sempre presente.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Conta de token de origem. Omitido quando não aplicável, como
            transferências de SOL nativo.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Conta de token de destino. Omitido quando não aplicável, como
            transferências de SOL nativo.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Endereço de mint do token. SOL nativo usa
            So11111111111111111111111111111111111111111; WSOL usa
            So11111111111111111111111111111111111111112 quando solMode é
            separado.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Quantia bruta de transferência como string para preservar a
            precisão. Para transferências com taxas do Token-2022, essa é a
            quantidade recebida pelo destino.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Taxa de transferência retida pela extensão de taxa de transferência
            do Token-2022. Presente apenas em transferências com taxas. Para
            transferências com taxas, o valor debitado da fonte é a quantia mais
            feeAmount, e o destino é creditado com a quantia.
          example: '13450000'
        decimals:
          type: integer
          description: Decimais do token. SOL nativo usa 9.
          example: 6
        uiAmount:
          type: string
          description: Quantia em formato legível por humanos.
          example: '2.5'
        feeUiAmount:
          type: string
          description: >-
            Valor da taxa em formato legível por humanos. Presente apenas quando
            feeAmount está presente.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Status de confirmação.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Índice da transação dentro do bloco.
          example: 35
        instructionIdx:
          type: integer
          description: Índice da instrução dentro da transação.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Índice dentro das instruções internas. Zero quando a transferência é
            de nível superior.
          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: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código de erro.
              example: -32602
            message:
              type: string
              description: A mensagem de erro.
            data:
              type: object
              description: Dados adicionais sobre o erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave de API da Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````