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

> Abfrage von geparsten, lesbaren Token- und nativen SOL-Transferobjekten nach Adresse mit Filtern nach Mint, Zeit, Betrag, Gegenpartei und Paginierung.

## Übersicht

`getTransfersByAddress` gibt geparste, lesbare Transferobjekte für Token und native SOL-Bewegungen, die eine Wallet-Adresse betreffen, zurück. Verwenden Sie Filter, um die Ergebnisse nach Mint, Blockzeit, Betrag, Slot, Richtung oder Gegenpartei einzugrenzen. Die Antwort ist so gestaltet, dass sie genaue Wallet-Aktivitätsansichten, Zahlungsnachverfolgung und Saldenabstimmung ermöglicht, ohne die Solana-Transferanalyse neu zu implementieren.

<Note>
  Mint- und Burn-Transfers sind einseitig. Mints haben `fromUserAccount: null` und können nur als eingehende Transfers für den Empfänger zurückgegeben werden. Burns haben `toUserAccount: null` und können nur als ausgehende Transfers für den verbrennenden Besitzer zurückgegeben werden.
</Note>

## Anforderungsparameter

<ParamField body="address" type="string" required>
  Base58-codierte Inhaber-Wallet-Adresse, für die Transfers abgefragt werden sollen. Geben Sie die Wallet-Inhaber-Adresse und nicht ein zugehöriges Token-Konto (ATA) an.
</ParamField>

<ParamField body="with" type="string">
  Nach Gegenpartei-Adresse filtern. Gibt nur Transfers zu oder von dieser Adresse zurück.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Nach Transfer-Richtung in Bezug auf die abgefragte Adresse filtern.

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

<ParamField body="mint" type="string">
  Token-Mint-Adresse. Verwenden Sie So11111111111111111111111111111111111111111 für native SOL und So11111111111111111111111111111111111111112 für WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  SOL/WSOL-Anzeigemodus. Merged behandelt WSOL als native SOL und schließt Wrap/Unwrap-Zeilen aus, sodass die SOL-nominierte Historie leichter abgeglichen werden kann; Separate bewahrt WSOL als eigenes SPL Token Mint und schließt Wrap/Unwrap-Zeilen ein.

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

<ParamField body="filters" type="object">
  Zusätzliche Filter für Betrag, Blockzeit und Slot.
</ParamField>

<ParamField body="filters.amount" type="object">
  Bereichsvergleichsfilter. Alle Felder sind optional und können kombiniert werden.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  Größer als.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  Größer oder gleich.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  Kleiner als.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  Kleiner oder gleich.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Bereichsvergleichsfilter. Alle Felder sind optional und können kombiniert werden.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  Größer als.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  Größer oder gleich.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  Kleiner als.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  Kleiner oder gleich.
</ParamField>

<ParamField body="filters.slot" type="object">
  Bereichsvergleichsfilter. Alle Felder sind optional und können kombiniert werden.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  Größer als.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  Größer oder gleich.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  Kleiner als.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  Kleiner oder gleich.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Maximale Anzahl an Transfers, die zurückgegeben werden sollen. Bereich 1 bis 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Cursor aus der vorherigen Antwort zur Paginierung.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  Datenbindungsniveau.

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

<ParamField body="minContextSlot" type="number">
  Minimaler Context-Slot für die Anfrage (optional).
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  Ergebnisreihenfolge.

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


## OpenAPI

````yaml de/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    Solana-Verlauf-API für transfer-spezifische Abfragen von geparsten,
    menschenlesbaren Token- und nativen SOL-Transferobjekten nach Adresse mit
    Filtern nach Mint, Zeit, Betrag und Gegenpartei. Entwickelt für genaue
    Ansichten der Wallet-Aktivität, Zahlungsnachverfolgung und Saldenabstimmung.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Mainnet RPC-Endpunkt
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC-Endpunkt
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        Gibt geparste, menschenlesbare Token- und native SOL-Transferobjekte für
        eine Wallet-Adresse zurück. Diese Helius RPC-Methode liefert prägnante,
        transfer-spezifische Datensätze anstelle von vollständigen
        Transaktions-Payloads und ist für genaue Wallet-Aktivitätsansichten,
        Zahlungsnachverfolgung und Saldenabstimmung konzipiert.


        Sie können die Transferhistorie nach Mint, Blockzeit, Betrag, Slot,
        Richtung und Gegenpartei filtern.
      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: Die JSON-RPC-Protokollversion.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Eine eindeutige Kennung für die Anfrage.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: Der Name der RPC-Methode, die aufgerufen werden soll.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Array, das die erforderliche Wallet-Adresse und das
                    optionale Konfigurationsobjekt enthält.
                  minItems: 1
                  maxItems: 2
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Base58-kodierte Inhaber-Wallet-Adresse, für die
                          Transfers abgefragt werden sollen. Geben Sie die
                          Inhaber-Wallet-Adresse an, nicht ein zugeordnetes
                          Token-Konto (ATA).
                        example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                      - type: object
                        description: Optionale Transfer-Abfragekonfiguration.
                        properties:
                          with:
                            type: string
                            description: >-
                              Filter nach Gegenpartei-Adresse. Gibt nur
                              Transfers zu oder von dieser Adresse zurück.
                            example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          direction:
                            type: string
                            description: >-
                              Filter nach Übertragungsrichtung relativ zur
                              abgefragten Adresse.
                            enum:
                              - in
                              - out
                              - any
                            default: any
                            example: in
                          mint:
                            type: string
                            description: >-
                              Token-Mint-Adresse. Verwenden Sie
                              So11111111111111111111111111111111111111111 für
                              native SOL und
                              So11111111111111111111111111111111111111112 für
                              WSOL.
                            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          solMode:
                            type: string
                            description: >-
                              SOL/WSOL-Anzeigemodus. Merged behandelt WSOL als
                              native SOL und schließt Wrap-/Unwrap-Zeilen aus,
                              sodass SOL-nominierte Historie einfacher
                              abzustimmen ist; separate bewahrt WSOL als einen
                              separaten SPL-Token-Mint und schließt
                              Wrap-/Unwrap-Zeilen ein.
                            enum:
                              - merged
                              - separate
                            default: merged
                            example: merged
                          filters:
                            type: object
                            description: Zusätzliche Filter für Betrag, Blockzeit und Slot.
                            properties:
                              amount:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filter nach rohem Transferbetrag, nicht
                                  UI-Betrag.
                              blockTime:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Filter nach Block-Zeitstempel in
                                  Unix-Sekunden.
                              slot:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: Filter nach Slot-Nummer.
                            additionalProperties: false
                          limit:
                            type: integer
                            description: >-
                              Maximale Anzahl der zurückzugebenden Transfers.
                              Bereich 1 bis 100.
                            minimum: 1
                            maximum: 100
                            default: 100
                            example: 50
                          paginationToken:
                            type: string
                            description: Cursor aus der vorherigen Antwort zur Paginierung.
                            example: 315069220:308:2:1:splTransfer
                          commitment:
                            type: string
                            description: Datenverpflichtungsgrad.
                            enum:
                              - finalized
                              - confirmed
                            default: finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Minimaler Kontext-Slot, der für die Anfrage
                              verwendet wird (optional).
                            example: 1000
                          sortOrder:
                            type: string
                            description: Ergebnisreihenfolge.
                            enum:
                              - asc
                              - desc
                            default: desc
                            example: desc
                        additionalProperties: false
      responses:
        '200':
          description: Transfers für die angegebene Adresse erfolgreich abgerufen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Die JSON-RPC-Protokollversion.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Kennung, die mit der Anfrage übereinstimmt.
                    example: '1'
                  result:
                    type: object
                    description: Übertragungsdaten und Seiteninformationen.
                    properties:
                      data:
                        type: array
                        description: Liste der Übertragungsdatensätze.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: >-
                              Cursor zum Abrufen der nächsten Seite der
                              Ergebnisse.
                          - type: 'null'
                        description: >-
                          Cursor für die nächste Seite oder null, wenn keine
                          weiteren Ergebnisse verfügbar sind.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Transferantwort
                  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: >-
            Fehlerhafte Anfrage - Ungültige Anforderungsparameter oder
            fehlerhafte Anfrage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Ungültige Parameter
                id: '1'
        '401':
          description: Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Nicht autorisiert
                id: '1'
        '429':
          description: Zu viele Anfragen - Ratenbegrenzung überschritten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Zu viele Anfragen
                id: '1'
        '500':
          description: Interner Serverfehler - Ein Fehler ist auf dem Server aufgetreten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Interner Fehler
                id: '1'
        '503':
          description: >-
            Dienst nicht verfügbar - Der Dienst ist vorübergehend nicht
            verfügbar.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Dienst nicht verfügbar
                id: '1'
        '504':
          description: >-
            Gateway-Zeitüberschreitung - Die Anfrage hat das Zeitlimit
            überschritten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway-Zeitüberschreitung
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TransferComparisonFilter:
      type: object
      description: >-
        Bereichsvergleichsfilter. Alle Felder sind optional und können
        kombiniert werden.
      properties:
        gt:
          type: number
          description: Größer als.
          example: 1000000
        gte:
          type: number
          description: Größer oder gleich.
          example: 1000000
        lt:
          type: number
          description: Kleiner als.
          example: 1000000000
        lte:
          type: number
          description: Kleiner oder gleich.
          example: 1000000000
      additionalProperties: false
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Base58-kodierte Transaktionssignatur.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Slot-Nummer, die die Transaktion enthält.
          example: 315073428
        blockTime:
          type: integer
          description: Unix-Zeitstempel in Sekunden für den Block.
          example: 1736159420
        type:
          type: string
          description: Geparster Transfer-Typ.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Wallet-Adresse, die die Tokens gesendet hat, oder null, wenn kein
            Absender existiert. Dieses Feld ist immer vorhanden.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Wallet-Adresse, die die Tokens erhalten hat, oder null, wenn kein
            Empfänger existiert. Dieses Feld ist immer vorhanden.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Quell-Token-Konto. Weggelassen, wenn nicht zutreffend, wie bei
            nativen SOL-Transfers.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Ziel-Token-Konto. Weggelassen, wenn nicht zutreffend, wie bei
            nativen SOL-Transfers.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Token-Mint-Adresse. Native SOL verwendet
            So11111111111111111111111111111111111111111; WSOL verwendet
            So11111111111111111111111111111111111111112, wenn solMode auf
            separate eingestellt ist.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Roher Transferbetrag als Zeichenfolge, um die Genauigkeit zu
            bewahren. Bei Gebühren-behafteten Token-2022-Transfers ist dies der
            Betrag, der vom Ziel erhalten wurde.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Übertragungsgebühr, die von der
            Token-2022-Transfergebühren-Erweiterung einbehalten wird. Nur bei
            Gebühren-behafteten Transfers vorhanden. Bei Gebühren-behafteten
            Transfers wird die Quelle mit Betrag plus feeAmount belastet und das
            Ziel mit Betrag gutgeschrieben.
          example: '13450000'
        decimals:
          type: integer
          description: Token-Dezimalstellen. Native SOL verwendet 9.
          example: 6
        uiAmount:
          type: string
          description: Menschlich lesbarer Betrag.
          example: '2.5'
        feeUiAmount:
          type: string
          description: >-
            Menschlich lesbarer Gebührenbetrag. Nur vorhanden, wenn feeAmount
            vorhanden ist.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Bestätigungsstatus.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Index der Transaktion innerhalb des Blocks.
          example: 35
        instructionIdx:
          type: integer
          description: Index der Instruktion innerhalb der Transaktion.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Index innerhalb der inneren Instruktionen. Null, wenn der Transfer
            auf höchster Ebene ist.
          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: Die JSON-RPC-Protokollversion.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Der Fehlercode.
              example: -32602
            message:
              type: string
              description: Die Fehlermeldung.
            data:
              type: object
              description: Zusätzliche Informationen über den Fehler.
        id:
          type: string
          description: Kennung, die mit der Anfrage übereinstimmt.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ihr Helius API-Schlüssel. Sie können einen kostenlos im
        [Dashboard](https://dashboard.helius.dev/api-keys) erhalten.

````