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

> Interrogez les objets de transfert de tokens et de SOL natifs, analysés et lisibles, par adresse avec des filtres par mint, temps, montant, contrepartie et pagination.

## Aperçu

`getTransfersByAddress` retourne des objets de transfert analysés et lisibles pour le mouvement de tokens et de SOL natif impliquant une adresse de portefeuille. Utilisez des filtres pour affiner les résultats par mint, heure de bloc, montant, créneau, direction ou contrepartie. La réponse est conçue pour des vues précises de l'activité du portefeuille, le suivi des paiements et la réconciliation des soldes sans réimplémenter l'analyse des transferts Solana.

<Note>
  Les transferts de mint et de burn sont unilatéraux. Les mints ont `fromUserAccount: null` et ne peuvent être retournés que comme transferts entrants pour le destinataire. Les burns ont `toUserAccount: null` et ne peuvent être retournés que comme transferts sortants pour le propriétaire brulant.
</Note>

## Paramètres de la requête

<ParamField body="address" type="string" required>
  Adresse de portefeuille propriétaire encodée en Base58 pour interroger les transferts. Passez l'adresse du propriétaire du portefeuille, pas un compte de token associé (ATA).
</ParamField>

<ParamField body="with" type="string">
  Filtrer par adresse contrepartie. Retourne uniquement les transferts vers ou depuis cette adresse.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Filtrer par direction de transfert par rapport à l'adresse interrogée.

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

<ParamField body="mint" type="string">
  Adresse de mint de token. Utilisez So11111111111111111111111111111111111111111 pour le SOL natif et So11111111111111111111111111111111111111112 pour le WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  Mode d'affichage SOL/WSOL. merged traite le WSOL comme le SOL natif et exclut les lignes d'enveloppement/déballage pour que l'historique en SOL soit plus facile à réconcilier; separate préserve le WSOL comme un mint de token SPL distinct et inclut les lignes d'enveloppement/déballage.

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

<ParamField body="filters" type="object">
  Filtres supplémentaires pour le montant, le temps de bloc, et le créneau.
</ParamField>

<ParamField body="filters.amount" type="object">
  Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  Supérieur à.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  Supérieur ou égal.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  Inférieur à.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  Inférieur ou égal.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  Supérieur à.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  Supérieur ou égal.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  Inférieur à.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  Inférieur ou égal.
</ParamField>

<ParamField body="filters.slot" type="object">
  Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  Supérieur à.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  Supérieur ou égal.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  Inférieur à.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  Inférieur ou égal.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Nombre maximum de transferts à retourner. Plage de 1 à 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Curseur de la réponse précédente pour la pagination.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  Niveau d'engagement des données.

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

<ParamField body="minContextSlot" type="number">
  Créneau de contexte minimum à utiliser pour la requête (optionnel).
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  Ordre des résultats.

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


## OpenAPI

````yaml fr/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API d'historique spécifique aux transferts Solana pour interroger des objets
    de transfert de jetons et SOL natifs analysés et lisibles par l'homme par
    adresse avec des filtres par mint, temps, montant et contrepartie. Conçu
    pour des vues précises de l'activité du portefeuille, le suivi des paiements
    et la réconciliation des soldes.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Point de terminaison RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Point de terminaison RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        Renvoie des objets de transfert de jetons analysés et lisibles par
        l'homme et de SOL natifs pour une adresse de portefeuille. Cette méthode
        RPC Helius renvoie des enregistrements concis spécifiques au transfert
        au lieu de charges utiles transactionnelles complètes et est conçue pour
        des vues précises des activités du portefeuille, le suivi des paiements
        et la réconciliation des soldes.


        Vous pouvez filtrer l'historique des transferts par mint, heure du bloc,
        montant, slot, direction et contrepartie.
      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 version du protocole JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Un identifiant unique pour la requête.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: Le nom de la méthode RPC à invoquer.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Tableau contenant l'adresse de portefeuille requise et
                    l'objet de configuration optionnel.
                  minItems: 1
                  maxItems: 2
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Adresse de portefeuille du propriétaire encodée en
                          Base58 pour interroger les transferts. Passez
                          l'adresse du propriétaire du portefeuille, pas un
                          compte associé (ATA).
                        example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                      - type: object
                        description: Configuration optionnelle de la requête de transfert.
                        properties:
                          with:
                            type: string
                            description: >-
                              Filtrer par adresse de la contrepartie. Ne renvoie
                              que les transferts vers ou depuis cette adresse.
                            example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          direction:
                            type: string
                            description: >-
                              Filtrer par direction du transfert par rapport à
                              l'adresse interrogée.
                            enum:
                              - in
                              - out
                              - any
                            default: any
                            example: in
                          mint:
                            type: string
                            description: >-
                              Adresse du mint de jetons. Utilisez
                              So11111111111111111111111111111111111111111 pour
                              SOL natif et
                              So11111111111111111111111111111111111111112 pour
                              WSOL.
                            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          solMode:
                            type: string
                            description: >-
                              Mode d'affichage SOL/WSOL. merged traite WSOL
                              comme le SOL natif et exclut les lignes
                              wrap/unwrap pour faciliter la réconciliation de
                              l'historique en SOL ; separate préserve WSOL comme
                              un mint de jetons SPL distinct et inclut les
                              lignes wrap/unwrap.
                            enum:
                              - merged
                              - separate
                            default: merged
                            example: merged
                          filters:
                            type: object
                            description: >-
                              Filtres supplémentaires pour le montant, l'heure
                              du bloc et le slot.
                            properties:
                              amount:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filtrer par montant brut du transfert, pas par
                                  montant de l'interface utilisateur.
                              blockTime:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filtrer par horodatage de bloc en secondes
                                  Unix.
                              slot:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: Filtrer par numéro de slot.
                            additionalProperties: false
                          limit:
                            type: integer
                            description: >-
                              Nombre maximum de transferts à retourner. Plage de
                              1 à 100.
                            minimum: 1
                            maximum: 100
                            default: 100
                            example: 50
                          paginationToken:
                            type: string
                            description: >-
                              Curseur de la réponse précédente pour la
                              pagination.
                            example: 315069220:308:2:1:splTransfer
                          commitment:
                            type: string
                            description: Niveau d'engagement des données.
                            enum:
                              - finalized
                              - confirmed
                            default: finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Slot de contexte minimum à utiliser pour la
                              requête (optionnel).
                            example: 1000
                          sortOrder:
                            type: string
                            description: Ordre des résultats.
                            enum:
                              - asc
                              - desc
                            default: desc
                            example: desc
                        additionalProperties: false
      responses:
        '200':
          description: Transferts récupérés avec succès pour l'adresse spécifiée.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: La version du protocole JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identifiant correspondant à la requête.
                    example: '1'
                  result:
                    type: object
                    description: Données de transfert et informations de pagination.
                    properties:
                      data:
                        type: array
                        description: Liste des enregistrements de transfert.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: >-
                              Curseur pour récupérer la page suivante de
                              résultats.
                          - type: 'null'
                        description: >-
                          Curseur pour la page suivante, ou null s'il n'y a plus
                          de résultats disponibles.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Réponse de transfert
                  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: >-
            Mauvaise Requête - Paramètres de requête invalides ou requête mal
            formée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Paramètres invalides
                id: '1'
        '401':
          description: Non Autorisé - Clé API invalide ou manquante.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Non autorisé
                id: '1'
        '429':
          description: Trop de Requêtes - Limite de débit dépassée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Trop de requêtes
                id: '1'
        '500':
          description: Erreur Interne du Serveur - Une erreur est survenue sur le serveur.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Erreur interne
                id: '1'
        '503':
          description: Service Indisponible - Le service est temporairement indisponible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service indisponible
                id: '1'
        '504':
          description: Délai d'Attente de la Passerelle - La demande a expiré.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Délai d'attente de la passerelle
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TransferComparisonFilter:
      type: object
      description: >-
        Filtre de comparaison de plage. Tous les champs sont optionnels et
        peuvent être combinés.
      properties:
        gt:
          type: number
          description: Supérieur à.
          example: 1000000
        gte:
          type: number
          description: Supérieur ou égal à.
          example: 1000000
        lt:
          type: number
          description: Inférieur à.
          example: 1000000000
        lte:
          type: number
          description: Inférieur ou égal à.
          example: 1000000000
      additionalProperties: false
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Signature de transaction encodée en Base58.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Numéro de slot contenant la transaction.
          example: 315073428
        blockTime:
          type: integer
          description: Horodatage Unix en secondes pour le bloc.
          example: 1736159420
        type:
          type: string
          description: Type de transfert analysé.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Adresse du portefeuille qui a envoyé les jetons, ou null
            lorsqu'aucun expéditeur n'existe. Ce champ est toujours présent.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Adresse du portefeuille qui a reçu les jetons, ou null lorsqu'aucun
            destinataire n'existe. Ce champ est toujours présent.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Compte de jetons source. Omis lorsqu'il n'est pas applicable, comme
            pour les transferts SOL natifs.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Compte de jetons de destination. Omis lorsqu'il n'est pas
            applicable, comme pour les transferts SOL natifs.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Adresse du mint de jetons. SOL natif utilise
            So11111111111111111111111111111111111111111 ; WSOL utilise
            So11111111111111111111111111111111111111112 lorsque solMode est
            séparé.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Montant brut du transfert sous forme de chaîne pour préserver la
            précision. Pour les transferts Token-2022 portant des frais, c'est
            le montant reçu par la destination.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Frais de transfert retenus par l'extension de frais de transfert
            Token-2022. Présent uniquement sur les transferts assujettis à des
            frais. Pour les transferts assujettis à des frais, la source est
            débitée du montant plus feeAmount, et la destination est créditée du
            montant.
          example: '13450000'
        decimals:
          type: integer
          description: Décimales de jetons. SOL natif utilise 9.
          example: 6
        uiAmount:
          type: string
          description: Montant lisible par l'homme.
          example: '2.5'
        feeUiAmount:
          type: string
          description: >-
            Montant des frais lisible par l'homme. Présent uniquement lorsque
            feeAmount est présent.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Statut de confirmation.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Indice de la transaction dans le bloc.
          example: 35
        instructionIdx:
          type: integer
          description: Indice de l'instruction dans la transaction.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Indice dans les instructions internes. Zéro lorsque le transfert est
            de niveau supérieur.
          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 version du protocole JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Le code d'erreur.
              example: -32602
            message:
              type: string
              description: Le message d'erreur.
            data:
              type: object
              description: Données supplémentaires sur l'erreur.
        id:
          type: string
          description: Identifiant correspondant à la requête.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le
        [tableau de bord](https://dashboard.helius.dev/api-keys).

````