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

> Truy vấn các đối tượng chuyển token và SOL gốc đã được phân tích, ở định dạng dễ đọc, theo địa chỉ với các bộ lọc theo địa chỉ mint, thời gian, số lượng, đối tác và phân trang.

## Tổng quan

`getTransfersByAddress` trả về các đối tượng chuyển đã được phân tích, ở định dạng dễ đọc, cho các giao dịch chuyển token và SOL gốc có liên quan đến một địa chỉ ví. Sử dụng bộ lọc để thu hẹp kết quả theo địa chỉ mint, thời gian khối, số lượng, slot, hướng chuyển hoặc đối tác. Phản hồi được thiết kế để hiển thị chính xác hoạt động ví, theo dõi thanh toán và đối soát số dư mà không cần triển khai lại logic phân tích giao dịch chuyển của Solana.

<Note>
  Các giao dịch mint và đốt chỉ có một phía. Giao dịch mint có `fromUserAccount: null` và chỉ có thể được trả về dưới dạng giao dịch chuyển vào cho người nhận. Giao dịch đốt có `toUserAccount: null` và chỉ có thể được trả về dưới dạng giao dịch chuyển ra cho chủ sở hữu thực hiện đốt.
</Note>

## Tham số yêu cầu

<ParamField body="address" type="string" required>
  Địa chỉ ví của chủ sở hữu được mã hóa Base58 cần truy vấn giao dịch chuyển. Truyền địa chỉ chủ sở hữu ví, không phải tài khoản token liên kết (ATA).
</ParamField>

<ParamField body="with" type="string">
  Lọc theo địa chỉ đối tác. Chỉ trả về các giao dịch chuyển đến hoặc từ địa chỉ này.
</ParamField>

<ParamField body="direction" type="string" default="any">
  Lọc theo hướng chuyển so với địa chỉ được truy vấn.

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

<ParamField body="mint" type="string">
  Địa chỉ mint của token. Sử dụng So11111111111111111111111111111111111111111 cho SOL gốc và So11111111111111111111111111111111111111112 cho WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  Chế độ hiển thị SOL/WSOL. merged xem WSOL như SOL gốc và loại trừ các hàng bọc/mở bọc để lịch sử được định giá bằng SOL dễ đối soát hơn; separate giữ WSOL dưới dạng một địa chỉ mint token SPL riêng biệt và bao gồm các hàng bọc/mở bọc.

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

<ParamField body="filters" type="object">
  Các bộ lọc bổ sung cho số lượng, thời gian khối và slot.
</ParamField>

<ParamField body="filters.amount" type="object">
  Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  Lớn hơn.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  Lớn hơn hoặc bằng.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  Nhỏ hơn.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  Nhỏ hơn hoặc bằng.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  Lớn hơn.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  Lớn hơn hoặc bằng.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  Nhỏ hơn.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  Nhỏ hơn hoặc bằng.
</ParamField>

<ParamField body="filters.slot" type="object">
  Bộ lọc so sánh theo phạm vi. Tất cả các trường đều không bắt buộc và có thể kết hợp với nhau.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  Lớn hơn.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  Lớn hơn hoặc bằng.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  Nhỏ hơn.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  Nhỏ hơn hoặc bằng.
</ParamField>

<ParamField body="limit" type="number" default="100">
  Số lượng giao dịch chuyển tối đa cần trả về. Phạm vi từ 1 đến 100.
</ParamField>

<ParamField body="paginationToken" type="string">
  Con trỏ từ phản hồi trước dùng để phân trang.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  Mức cam kết dữ liệu.

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

<ParamField body="minContextSlot" type="number">
  Slot ngữ cảnh tối thiểu dùng cho yêu cầu (không bắt buộc).
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  Thứ tự kết quả.

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


## OpenAPI

````yaml vi/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API lịch sử Solana dành riêng cho giao dịch chuyển, dùng để truy vấn các đối
    tượng chuyển token và SOL gốc đã được phân tích cú pháp, dễ đọc theo địa
    chỉ, với các bộ lọc theo địa chỉ mint, thời gian, số lượng và đối tác. Được
    thiết kế để hiển thị chính xác hoạt động của ví, theo dõi thanh toán và đối
    soát số dư.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Điểm cuối RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Điểm cuối RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        Trả về các đối tượng chuyển token và SOL gốc đã được phân tích cú pháp,
        dễ đọc cho

        một địa chỉ ví. Phương thức Helius RPC này trả về các bản ghi ngắn gọn
        dành riêng cho

        giao dịch chuyển thay vì toàn bộ tải trọng giao dịch và được thiết kế để
        hiển thị chính xác

        hoạt động của ví, theo dõi thanh toán và đối soát số dư.


        Bạn có thể lọc lịch sử giao dịch chuyển theo địa chỉ mint, thời gian
        khối, số lượng, slot,

        hướng chuyển và đối tác.
      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: Phiên bản giao thức JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Mã định danh duy nhất cho yêu cầu.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: Tên của phương thức RPC cần gọi.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: >-
                    Mảng chứa địa chỉ ví bắt buộc và đối tượng cấu hình không
                    bắt buộc.
                  minItems: 1
                  maxItems: 2
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Địa chỉ ví của chủ sở hữu được mã hóa bằng Base58 cần
                          truy vấn giao dịch chuyển. Truyền địa chỉ chủ sở hữu
                          ví, không phải tài khoản token liên kết (ATA).
                        example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                      - type: object
                        description: Cấu hình truy vấn giao dịch chuyển không bắt buộc.
                        properties:
                          with:
                            type: string
                            description: >-
                              Lọc theo địa chỉ đối tác. Chỉ trả về các giao dịch
                              chuyển đến hoặc từ địa chỉ này.
                            example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                          direction:
                            type: string
                            description: >-
                              Lọc theo hướng chuyển tương ứng với địa chỉ được
                              truy vấn.
                            enum:
                              - in
                              - out
                              - any
                            default: any
                            example: in
                          mint:
                            type: string
                            description: >-
                              Địa chỉ mint của token. Sử dụng
                              So11111111111111111111111111111111111111111 cho
                              SOL gốc và
                              So11111111111111111111111111111111111111112 cho
                              WSOL.
                            example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                          solMode:
                            type: string
                            description: >-
                              Chế độ hiển thị SOL/WSOL. merged coi WSOL là SOL
                              gốc và loại trừ các hàng wrap/unwrap để dễ đối
                              soát lịch sử tính theo SOL; separate giữ WSOL dưới
                              dạng một địa chỉ mint token SPL riêng biệt và bao
                              gồm các hàng wrap/unwrap.
                            enum:
                              - merged
                              - separate
                            default: merged
                            example: merged
                          filters:
                            type: object
                            description: >-
                              Các bộ lọc bổ sung cho số lượng, thời gian khối và
                              slot.
                            properties:
                              amount:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Lọc theo số lượng chuyển thô, không phải số
                                  lượng trên giao diện người dùng.
                              blockTime:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: >-
                                  Lọc theo dấu thời gian khối tính bằng giây
                                  Unix.
                              slot:
                                $ref: '#/components/schemas/TransferComparisonFilter'
                                description: Lọc theo số slot.
                            additionalProperties: false
                          limit:
                            type: integer
                            description: >-
                              Số lượng giao dịch chuyển tối đa cần trả về. Phạm
                              vi từ 1 đến 100.
                            minimum: 1
                            maximum: 100
                            default: 100
                            example: 50
                          paginationToken:
                            type: string
                            description: Con trỏ từ phản hồi trước để phân trang.
                            example: 315069220:308:2:1:splTransfer
                          commitment:
                            type: string
                            description: Mức cam kết dữ liệu.
                            enum:
                              - finalized
                              - confirmed
                            default: finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Slot ngữ cảnh tối thiểu cần sử dụng cho yêu cầu
                              (không bắt buộc).
                            example: 1000
                          sortOrder:
                            type: string
                            description: Thứ tự kết quả.
                            enum:
                              - asc
                              - desc
                            default: desc
                            example: desc
                        additionalProperties: false
      responses:
        '200':
          description: >-
            Đã truy xuất thành công các giao dịch chuyển cho địa chỉ đã chỉ
            định.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Phiên bản giao thức JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Mã định danh khớp với yêu cầu.
                    example: '1'
                  result:
                    type: object
                    description: Dữ liệu giao dịch chuyển và thông tin phân trang.
                    properties:
                      data:
                        type: array
                        description: Danh sách các bản ghi giao dịch chuyển.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: Con trỏ để truy xuất trang kết quả tiếp theo.
                          - type: 'null'
                        description: >-
                          Con trỏ cho trang tiếp theo hoặc null nếu không còn
                          kết quả nào.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: Phản hồi giao dịch chuyển
                  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: >-
            Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
            định dạng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Hết thời gian chờ cổng kết nối - Yêu cầu đã hết thời gian chờ.
          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: >-
        Bộ lọc so sánh phạm vi. Tất cả các trường đều không bắt buộc và có thể
        được kết hợp.
      properties:
        gt:
          type: number
          description: Lớn hơn.
          example: 1000000
        gte:
          type: number
          description: Lớn hơn hoặc bằng.
          example: 1000000
        lt:
          type: number
          description: Nhỏ hơn.
          example: 1000000000
        lte:
          type: number
          description: Nhỏ hơn hoặc bằng.
          example: 1000000000
      additionalProperties: false
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Chữ ký giao dịch được mã hóa bằng Base58.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: Số slot chứa giao dịch.
          example: 315073428
        blockTime:
          type: integer
          description: Dấu thời gian Unix của khối, tính bằng giây.
          example: 1736159420
        type:
          type: string
          description: Loại giao dịch chuyển đã được phân tích cú pháp.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Địa chỉ ví đã gửi token hoặc null khi không có người gửi. Trường này
            luôn hiện diện.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: >-
            Địa chỉ ví đã nhận token hoặc null khi không có người nhận. Trường
            này luôn hiện diện.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: >-
            Tài khoản token nguồn. Bị bỏ qua khi không áp dụng, chẳng hạn như
            với giao dịch chuyển SOL gốc.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: >-
            Tài khoản token đích. Bị bỏ qua khi không áp dụng, chẳng hạn như với
            giao dịch chuyển SOL gốc.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            Địa chỉ mint của token. SOL gốc sử dụng
            So11111111111111111111111111111111111111111; WSOL sử dụng
            So11111111111111111111111111111111111111112 khi solMode là separate.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            Số lượng chuyển thô ở dạng chuỗi để duy trì độ chính xác. Với các
            giao dịch chuyển Token-2022 có tính phí, đây là số lượng mà tài
            khoản đích nhận được.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Phí chuyển được phần mở rộng phí chuyển của Token-2022 giữ lại. Chỉ
            hiện diện trong các giao dịch chuyển có tính phí. Với các giao dịch
            này, tài khoản nguồn bị ghi nợ amount cộng với feeAmount và tài
            khoản đích được ghi có amount.
          example: '13450000'
        decimals:
          type: integer
          description: Số chữ số thập phân của token. SOL gốc sử dụng 9.
          example: 6
        uiAmount:
          type: string
          description: Số lượng dễ đọc.
          example: '2.5'
        feeUiAmount:
          type: string
          description: Số tiền phí dễ đọc. Chỉ hiện diện khi có feeAmount.
          example: '134.5'
        confirmationStatus:
          type: string
          description: Trạng thái xác nhận.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: Chỉ mục của giao dịch trong khối.
          example: 35
        instructionIdx:
          type: integer
          description: Chỉ mục của chỉ thị trong giao dịch.
          example: 1
        innerInstructionIdx:
          type: integer
          description: >-
            Chỉ mục trong các chỉ thị nội bộ. Bằng 0 khi giao dịch chuyển ở cấp
            cao nhất.
          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: Phiên bản giao thức JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Mã lỗi.
              example: -32602
            message:
              type: string
              description: Thông báo lỗi.
            data:
              type: object
              description: Dữ liệu bổ sung về lỗi.
        id:
          type: string
          description: Mã định danh khớp với yêu cầu.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
        khiển](https://dashboard.helius.dev/api-keys).

````