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

> 주소로 인간이 읽을 수 있는 형식의 토큰 및 네이티브 SOL 전송 객체를 조화하여 민트, 시간, 금액, 상대방 및 페이지 매김으로 필터링합니다.

## 개요

`getTransfersByAddress`는 지갑 주소와 관련된 토큰 및 네이티브 SOL 이동에 대한 인간이 읽을 수 있는 형식의 전송 객체를 반환합니다. 결과를 민트, 블록 시간, 금액, 슬롯, 방향 또는 상대방으로 좁히기 위해 필터를 사용합니다. 이 응답은 Solana 전송 파싱을 재구현하지 않고도 정확한 지갑 활동 보기, 결제 추적 및 잔액 조정을 위해 설계되었습니다.

<Note>
  민트와 소각 전송은 일방적입니다. 민트는 `fromUserAccount: null`를 가지고 있으며 수신자의 인바운드 전송으로만 반환될 수 있습니다. 소각은 `toUserAccount: null`를 가지고 있으며 소각 소유자의 아웃바운드 전송으로만 반환될 수 있습니다.
</Note>

## 요청 매개 변수

<ParamField body="address" type="string" required>
  전송을 쿼리할 Base58로 인코딩된 소유자 지갑 주소입니다. 연관된 토큰 계정(ATA)이 아니라 지갑 소유자 주소를 전달합니다.
</ParamField>

<ParamField body="with" type="string">
  상대방 주소로 필터링합니다. 이 주소로부터의 전송만 반환합니다.
</ParamField>

<ParamField body="direction" type="string" default="any">
  쿼리된 주소에 대한 전송 방향으로 필터링합니다.

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

<ParamField body="mint" type="string">
  토큰 민트 주소입니다. 네이티브 SOL의 경우 So11111111111111111111111111111111111111111을, WSOL의 경우 So11111111111111111111111111111111111111112을 사용합니다.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
  SOL/WSOL 표시 모드입니다. merged는 WSOL을 네이티브 SOL로 취급하고 랩/언랩 행을 제외하므로 SOL로 표기된 기록을 더 쉽게 조정할 수 있으며, separate는 WSOL을 별도의 SPL 토큰 민트로 유지하고 랩/언랩 행을 포함합니다.

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

<ParamField body="filters" type="object">
  금액, 블록 시간 및 슬롯에 대한 추가 필터입니다.
</ParamField>

<ParamField body="filters.amount" type="object">
  범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
  초과.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
  이상.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
  미만.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
  이하.
</ParamField>

<ParamField body="filters.blockTime" type="object">
  범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
  초과.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
  이상.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
  미만.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
  이하.
</ParamField>

<ParamField body="filters.slot" type="object">
  범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
  초과.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
  이상.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
  미만.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
  이하.
</ParamField>

<ParamField body="limit" type="number" default="100">
  반환할 전송의 최대 수입니다. 범위는 1에서 100입니다.
</ParamField>

<ParamField body="paginationToken" type="string">
  페이지 매김을 위한 이전 응답의 커서입니다.
</ParamField>

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

<ParamField body="commitment" type="string" default="finalized">
  데이터 커밋 수준입니다.

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

<ParamField body="minContextSlot" type="number">
  요청에 사용할 최소 컨텍스트 슬롯(선택 사항)입니다.
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  결과 정렬 순서입니다.

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


## OpenAPI

````yaml ko/openapi/rpc-http/getTransfersByAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    주소별로 필터링하여 파싱된 사람이 읽을 수 있는 토큰 및 기본 SOL 전송 객체를 쿼리하기 위한 전송 전용 Solana 기록
    API입니다. 정확한 지갑 활동 보기, 결제 추적 및 잔액 조정을 위해 설계되었습니다.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTransfersByAddress
      description: >
        지갑 주소에 대한 파싱된 사람이 읽을 수 있는 토큰과 기본 SOL 전송 객체를 반환합니다. 이 Helius RPC 메소드는 전체
        거래 페이로드 대신 간결한 전송 전용 기록을 반환하며 정확한 지갑 활동 보기, 결제 추적 및 잔액 조정을 위해 설계되었습니다.


        발행자, 블록 시간, 금액, 슬롯, 방향 및 상대방에 따라 전송 기록을 필터링할 수 있습니다.
      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: JSON-RPC 프로토콜 버전입니다.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: 요청에 대한 고유 식별자입니다.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTransfersByAddress
                  example: getTransfersByAddress
                  description: 호출할 RPC 메소드의 이름입니다.
                  default: getTransfersByAddress
                params:
                  type: array
                  description: 필수 지갑 주소와 선택적 구성 객체가 포함된 배열입니다.
                  default:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                  minItems: 1
                  maxItems: 2
                  prefixItems:
                    - type: string
                      description: >-
                        전송을 쿼리하기 위한 Base58로 인코딩된 소유자 지갑 주소입니다. 지갑 소유자 주소를 전달하고,
                        연결된 토큰 계정(ATA)이 아닙니다.
                      example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - type: object
                      description: 선택적 전송 쿼리 구성입니다.
                      properties:
                        with:
                          type: string
                          description: 상대방 주소로 필터링합니다. 이 주소로의 전송 또는 이 주소로부터의 전송만 반환합니다.
                          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
                        direction:
                          type: string
                          description: 쿼리된 주소에 대한 전송 방향으로 필터링합니다.
                          enum:
                            - in
                            - out
                            - any
                          default: any
                          example: in
                        mint:
                          type: string
                          description: >-
                            토큰 발행 주소입니다. 기본 SOL의 경우
                            So11111111111111111111111111111111111111111를 사용하고
                            WSOL의 경우
                            So11111111111111111111111111111111111111112를 사용합니다.
                          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                        solMode:
                          type: string
                          description: >-
                            SOL/WSOL 디스플레이 모드입니다. merged는 WSOL을 기본 SOL로 처리하고
                            wrap/unwrap 행을 제외하여 SOL 명목화된 기록을 쉽게 조정할 수 있게 하고,
                            separate는 WSOL을 별개의 SPL 토큰 발행으로 유지하며 wrap/unwrap 행을
                            포함합니다.
                          enum:
                            - merged
                            - separate
                          default: merged
                          example: merged
                        filters:
                          type: object
                          description: 금액, 블록 시간 및 슬롯에 대한 추가 필터입니다.
                          properties:
                            amount:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: UI 금액이 아닌 원시 전송 금액으로 필터링합니다.
                            blockTime:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: Unix 초 단위의 블록 타임스탬프로 필터링합니다.
                            slot:
                              $ref: '#/components/schemas/TransferComparisonFilter'
                              description: 슬롯 번호로 필터링합니다.
                          additionalProperties: false
                        limit:
                          type: integer
                          description: 반환할 전송의 최대 수입니다. 범위는 1에서 100까지입니다.
                          minimum: 1
                          maximum: 100
                          default: 100
                          example: 50
                        paginationToken:
                          type: string
                          description: 페이지 매김을 위한 이전 응답의 커서입니다.
                        example: 315069220:308:2:1:splTransfer
                        commitment:
                          type: string
                          description: 데이터 확정성 수준입니다.
                          enum:
                            - finalized
                            - confirmed
                          default: finalized
                          example: finalized
                        minContextSlot:
                          type: integer
                          description: 요청에 사용할 최소 컨텍스트 슬롯입니다(선택 사항).
                          example: 1000
                        sortOrder:
                          type: string
                          description: 결과 정렬 순서입니다.
                          enum:
                            - asc
                            - desc
                          default: desc
                          example: desc
                      additionalProperties: false
                  items: false
                  example:
                    - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
                    - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      limit: 50
                      sortOrder: desc
      responses:
        '200':
          description: 지정된 주소에 대한 전송을 성공적으로 검색하였습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC 프로토콜 버전입니다.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: 요청과 일치하는 식별자입니다.
                    example: '1'
                  result:
                    type: object
                    description: 전송 데이터 및 페이지 매김 정보입니다.
                    properties:
                      data:
                        type: array
                        description: 전송 기록 목록입니다.
                        items:
                          $ref: '#/components/schemas/TokenTransfer'
                      paginationToken:
                        oneOf:
                          - type: string
                            description: 결과의 다음 페이지를 검색하기 위한 커서입니다.
                          - type: 'null'
                        description: 다음 페이지를 위한 커서입니다. 더 이상 결과가 없는 경우 null입니다.
                        example: 315073428:35:1:0:splTransfer
              examples:
                transferResponse:
                  summary: 전송 응답
                  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: 잘못된 요청 - 잘못된 요청 매개변수 또는 형식이 잘못된 요청입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: 잘못된 매개변수
                id: '1'
        '401':
          description: Unauthorized - 유효하지 않거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: 권한이 없음
                id: '1'
        '429':
          description: 요청이 너무 많음 - 제한 수를 초과했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: 요청이 너무 많음
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: 내부 오류
                id: '1'
        '503':
          description: 서비스를 사용할 수 없음 - 서비스가 일시적으로 사용할 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: 서비스를 사용할 수 없음
                id: '1'
        '504':
          description: 게이트웨이 시간 초과 - 요청이 시간 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: 게이트웨이 시간 초과
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    TokenTransfer:
      type: object
      properties:
        signature:
          type: string
          description: Base58로 인코딩된 거래 서명입니다.
          example: >-
            5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG
        slot:
          type: integer
          description: 거래를 포함하는 슬롯 번호입니다.
          example: 315073428
        blockTime:
          type: integer
          description: 블록의 Unix 타임스탬프(초)입니다.
          example: 1736159420
        type:
          type: string
          description: 파싱된 전송 유형입니다.
          enum:
            - transfer
            - mint
            - burn
            - wrap
            - unwrap
            - changeOwner
            - withdrawWithheldFee
          example: transfer
        fromUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: 토큰을 보낸 지갑 주소입니다. 발신자가 없을 경우 null입니다. 이 필드는 항상 존재합니다.
          example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx
        toUserAccount:
          oneOf:
            - type: string
            - type: 'null'
          description: 토큰을 받은 지갑 주소입니다. 수신자가 없을 경우 null입니다. 이 필드는 항상 존재합니다.
          example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
        fromTokenAccount:
          type: string
          description: 소스 토큰 계정입니다. 기본 SOL 전송과 같이 적용할 수 없는 경우에는 생략됩니다.
          example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x
        toTokenAccount:
          type: string
          description: 목적지 토큰 계정입니다. 기본 SOL 전송과 같이 적용할 수 없는 경우에는 생략됩니다.
          example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY
        mint:
          type: string
          description: >-
            토큰 발행 주소입니다. 기본 SOL은 So11111111111111111111111111111111111111111,
            WSOL은 solMode가 separate일 때
            So11111111111111111111111111111111111111112를 사용합니다.
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        amount:
          type: string
          description: >-
            정확성을 유지하기 위해 문자열 형식의 원시 전송 금액입니다. 수수료가 있는 Token-2022 전송의 경우, 이는
            목적지에서 받은 양입니다.
          example: '2500000'
        feeAmount:
          type: string
          description: >-
            Token-2022 전송 수수료 확장에서 보류된 전송 수수료입니다. 수수료가 있는 전송에만 존재합니다. 수수료가 있는
            전송의 경우, 소스에는 금액에 feeAmount가 추가되어 차감되고, 목적지는 금액이 추가됩니다.
          example: '13450000'
        decimals:
          type: integer
          description: 토큰 소수점 자리수입니다. 기본 SOL은 9를 사용합니다.
          example: 6
        uiAmount:
          type: string
          description: 사람이 읽을 수 있는 양입니다.
          example: '2.5'
        feeUiAmount:
          type: string
          description: 사람이 읽을 수 있는 수수료 양입니다. feeAmount가 있을 때만 존재합니다.
          example: '134.5'
        confirmationStatus:
          type: string
          description: 확인 상태입니다.
          enum:
            - finalized
            - confirmed
          example: finalized
        transactionIdx:
          type: integer
          description: 블록 내 거래의 인덱스입니다.
          example: 35
        instructionIdx:
          type: integer
          description: 거래 내 명령의 인덱스입니다.
          example: 1
        innerInstructionIdx:
          type: integer
          description: 내부 명령 내 인덱스입니다. 전송이 최상위일 때는 0입니다.
          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: JSON-RPC 프로토콜 버전입니다.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: 오류 코드입니다.
              example: -32602
            message:
              type: string
              description: 오류 메시지입니다.
            data:
              type: object
              description: 오류에 대한 추가 데이터입니다.
        id:
          type: string
          description: 요청과 일치하는 식별자입니다.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        받을 수 있습니다.

````