> ## 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 analizados y legibles de transferencias de tokens y SOL nativo por dirección, con filtros por acuñación, tiempo, cantidad, contraparte y paginación.

## Descripción general

`getTransfersByAddress` devuelve objetos de transferencia analizados y legibles correspondientes al movimiento de tokens y SOL nativo que involucra a una dirección de billetera. Usa filtros para limitar los resultados por acuñación, tiempo de bloque, cantidad, slot, dirección de la transferencia o contraparte. La respuesta está diseñada para mostrar con precisión la actividad de la billetera, hacer seguimiento de pagos y conciliar saldos sin volver a implementar el análisis de transferencias de Solana.

<Note>
  Las transferencias de acuñación y quema son unilaterales. Las acuñaciones tienen `fromUserAccount: null` y solo pueden devolverse como transferencias entrantes para el destinatario. Las quemas tienen `toUserAccount: null` y solo pueden devolverse como transferencias salientes para el propietario que realiza la quema.
</Note>

## Parámetros de la solicitud

<ParamField body="address" type="string" required>
  Dirección de la billetera del propietario codificada en Base58 cuyas transferencias quieres consultar. Proporciona la dirección del propietario de la billetera, no una cuenta de token asociada (ATA).
</ParamField>

<ParamField body="with" type="string">
  Filtra por dirección de la contraparte. Devuelve solo las transferencias hacia o desde esta dirección.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Filtra por la dirección de la transferencia en relación con la dirección consultada.

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

<ParamField body="mint" type="string">
  Dirección de acuñación del token. Usa So11111111111111111111111111111111111111111 para SOL nativo y So11111111111111111111111111111111111111112 para WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  Modo de visualización de SOL/WSOL. merged trata WSOL como SOL nativo y excluye las filas de envoltura y desenvoltura para facilitar la conciliación del historial denominado en SOL; separate conserva WSOL como una acuñación de token SPL independiente e incluye las filas de envoltura y desenvoltura.

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

<ParamField body="filters" type="object">
  Filtros adicionales de cantidad, tiempo de bloque y slot.
</ParamField>

<ParamField body="filters.amount" type="object">
  Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
</ParamField>

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

<ParamField body="filters.amount.gte" type="number">
  Mayor o igual que.
</ParamField>

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

<ParamField body="filters.amount.lte" type="number">
  Menor o igual que.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
</ParamField>

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

<ParamField body="filters.blockTime.gte" type="number">
  Mayor o igual que.
</ParamField>

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

<ParamField body="filters.blockTime.lte" type="number">
  Menor o igual que.
</ParamField>

<ParamField body="filters.slot" type="object">
  Filtro de comparación por rango. Todos los campos son opcionales y pueden combinarse.
</ParamField>

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

<ParamField body="filters.slot.gte" type="number">
  Mayor o igual que.
</ParamField>

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

<ParamField body="filters.slot.lte" type="number">
  Menor o igual que.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Número máximo de transferencias que se devolverán. Rango de 1 a 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Cursor de la respuesta anterior para la paginación.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  Nivel de compromiso de los datos.

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

<ParamField body="minContextSlot" type="number">
  Slot de contexto mínimo que se usará para la solicitud (opcional).
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  Orden de los resultados.

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


## OpenAPI

````yaml es/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: API RPC de Solana
  version: 1.0.0
  description: >-
    API de historial de Solana específica para transferencias que permite
    consultar, por dirección, objetos analizados y legibles de transferencias de
    tokens y SOL nativo, con filtros por acuñación, tiempo, cantidad y
    contraparte. Está diseñada para mostrar con precisión la actividad de las
    billeteras, hacer seguimiento de pagos y conciliar saldos.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Punto de conexión RPC de Mainnet
  - url: https://devnet.helius-rpc.com
    description: Punto de conexión RPC de Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        Devuelve objetos analizados y legibles de transferencias de tokens y SOL
        nativo para

        una dirección de billetera. Este método RPC de Helius devuelve registros
        concisos

        específicos de transferencias en lugar de cargas útiles completas de
        transacciones y está diseñado para mostrar con precisión

        la actividad de las billeteras, hacer seguimiento de pagos y conciliar
        saldos.


        Puedes filtrar el historial de transferencias por acuñación, hora del
        bloque, cantidad, slot,

        dirección y 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: La versión del protocolo JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Un identificador único para la solicitud.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: El nombre del método RPC que se invocará.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Arreglo que contiene la dirección de billetera obligatoria y
                    el objeto de configuración opcional.
                  minItems: 1
                  maxItems: 2
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Dirección de la billetera del propietario codificada
                          en Base58 cuyas transferencias quieres consultar.
                          Proporciona la dirección de la billetera del
                          propietario, no una cuenta de tokens asociada (ATA).
                        example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                      - type: object
                        description: >-
                          Configuración opcional de la consulta de
                          transferencias.
                        properties:
                          with:
                            type: string
                            description: >-
                              Filtra por dirección de contraparte. Devuelve solo
                              las transferencias hacia o desde esta dirección.
                            example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          direction:
                            type: string
                            description: >-
                              Filtra por la dirección de la transferencia con
                              respecto a la dirección consultada.
                            enum:
                              - in
                              - out
                              - any
                            default: any
                            example: in
                          mint:
                            type: string
                            description: >-
                              Dirección de acuñación del token. Usa
                              So11111111111111111111111111111111111111111 para
                              SOL nativo y
                              So11111111111111111111111111111111111111112 para
                              WSOL.
                            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          solMode:
                            type: string
                            description: >-
                              Modo de visualización de SOL/WSOL. merged trata
                              WSOL como SOL nativo y excluye las filas
                              wrap/unwrap para facilitar la conciliación del
                              historial denominado en SOL; separate conserva
                              WSOL como una acuñación de token SPL distinta e
                              incluye las filas wrap/unwrap.
                            enum:
                              - merged
                              - separate
                            default: merged
                            example: merged
                          filters:
                            type: object
                            description: >-
                              Filtros adicionales de cantidad, hora del bloque y
                              slot.
                            properties:
                              amount:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filtra por la cantidad bruta de la
                                  transferencia, no por la cantidad de la
                                  interfaz de usuario.
                              blockTime:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filtra por la marca de tiempo del bloque en
                                  segundos Unix.
                              slot:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: Filtra por número de slot.
                            additionalProperties: false
                          limit:
                            type: integer
                            description: >-
                              Número máximo de transferencias que se devolverán.
                              Intervalo de 1 a 100.
                            minimum: 1
                            maximum: 100
                            default: 100
                            example: 50
                          paginationToken:
                            type: string
                            description: >-
                              Cursor de la respuesta anterior para la
                              paginación.
                            example: 315069220:308:2:1:splTransfer
                          commitment:
                            type: string
                            description: Nivel de compromiso de los datos.
                            enum:
                              - finalized
                              - confirmed
                            default: finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Slot de contexto mínimo que se usará para la
                              solicitud (opcional).
                            example: 1000
                          sortOrder:
                            type: string
                            description: Orden de los resultados.
                            enum:
                              - asc
                              - desc
                            default: desc
                            example: desc
                        additionalProperties: false
      responses:
        '200':
          description: >-
            Se recuperaron correctamente las transferencias de la dirección
            especificada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: La versión del protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador que coincide con la solicitud.
                    example: '1'
                  result:
                    type: object
                    description: Datos de las transferencias e información de paginación.
                    properties:
                      data:
                        type: array
                        description: Lista de registros de transferencias.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: >-
                              Cursor para recuperar la siguiente página de
                              resultados.
                          - type: 'null'
                        description: >-
                          Cursor para la siguiente página, o null si no hay más
                          resultados disponibles.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Respuesta de transferencia
                  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: >-
            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: Invalid params
                id: '1'
        '401':
          description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                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: Too many requests
                id: '1'
        '500':
          description: 'Error interno del servidor: ocurrió un error en el servidor.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                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: Service unavailable
                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: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TransferComparisonFilter:
      type: object
      description: >-
        Filtro de comparación de intervalos. Todos los campos son opcionales y
        se pueden combinar.
      properties:
        gt:
          type: number
          description: Mayor que.
          example: 1000000
        gte:
          type: number
          description: Mayor o igual que.
          example: 1000000
        lt:
          type: number
          description: Menor que.
          example: 1000000000
        lte:
          type: number
          description: Menor o igual que.
          example: 1000000000
      additionalProperties: false
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Firma de transacción codificada en Base58.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Número de slot que contiene la transacción.
          example: 315073428
        blockTime:
          type: integer
          description: Marca de tiempo Unix del bloque, en segundos.
          example: 1736159420
        type:
          type: string
          description: Tipo de transferencia analizado.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Dirección de la billetera que envió los tokens, o null cuando no
            existe un remitente. Este campo siempre está presente.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Dirección de la billetera que recibió los tokens, o null cuando no
            existe un destinatario. Este campo siempre está presente.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Cuenta de tokens de origen. Se omite cuando no corresponde, como en
            las transferencias de SOL nativo.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Cuenta de tokens de destino. Se omite cuando no corresponde, como en
            las transferencias de SOL nativo.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Dirección de acuñación del token. SOL nativo usa
            So11111111111111111111111111111111111111111; WSOL usa
            So11111111111111111111111111111111111111112 cuando solMode es
            separate.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Cantidad bruta de la transferencia como cadena para conservar la
            precisión. En las transferencias de Token-2022 sujetas a comisiones,
            esta es la cantidad que recibe el destino.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Comisión de transferencia retenida por la extensión de comisiones de
            transferencia de Token-2022. Solo está presente en transferencias
            sujetas a comisiones. En estas transferencias, se debita del origen
            amount más feeAmount y se acredita amount al destino.
          example: '13450000'
        decimals:
          type: integer
          description: Decimales del token. SOL nativo usa 9.
          example: 6
        uiAmount:
          type: string
          description: Cantidad legible.
          example: '2.5'
        feeUiAmount:
          type: string
          description: >-
            Cantidad de la comisión en formato legible. Solo está presente
            cuando feeAmount está presente.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Estado de confirmación.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Índice de la transacción dentro del bloque.
          example: 35
        instructionIdx:
          type: integer
          description: Índice de la instrucción dentro de la transacción.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Índice dentro de las instrucciones internas. Es cero cuando la
            transferencia es de nivel 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: La versión del protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: El código de 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'
  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).

````