Skip to main content
POST
getTransfersByAddress

개요

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

요청 매개 변수

string
필수
전송을 쿼리할 Base58로 인코딩된 소유자 지갑 주소입니다. 연관된 토큰 계정(ATA)이 아니라 지갑 소유자 주소를 전달합니다.
string
상대방 주소로 필터링합니다. 이 주소로부터의 전송만 반환합니다.
string
기본값:"any"
쿼리된 주소에 대한 전송 방향으로 필터링합니다.
  • in
  • out
  • any
string
토큰 민트 주소입니다. 네이티브 SOL의 경우 So11111111111111111111111111111111111111111을, WSOL의 경우 So11111111111111111111111111111111111111112을 사용합니다.
string
기본값:"merged"
SOL/WSOL 표시 모드입니다. merged는 WSOL을 네이티브 SOL로 취급하고 랩/언랩 행을 제외하므로 SOL로 표기된 기록을 더 쉽게 조정할 수 있으며, separate는 WSOL을 별도의 SPL 토큰 민트로 유지하고 랩/언랩 행을 포함합니다.
  • merged
  • separate
object
금액, 블록 시간 및 슬롯에 대한 추가 필터입니다.
object
범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
number
초과.
number
이상.
number
미만.
number
이하.
object
범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
number
초과.
number
이상.
number
미만.
number
이하.
object
범위 비교 필터입니다. 모든 필드는 선택 사항이며 조합할 수 있습니다.
number
초과.
number
이상.
number
미만.
number
이하.
number
기본값:"100"
반환할 전송의 최대 수입니다. 범위는 1에서 100입니다.
string
페이지 매김을 위한 이전 응답의 커서입니다.
any
string
기본값:"finalized"
데이터 커밋 수준입니다.
  • finalized
  • confirmed
number
요청에 사용할 최소 컨텍스트 슬롯(선택 사항)입니다.
string
기본값:"desc"
결과 정렬 순서입니다.
  • asc
  • desc

인증

api-key
string
query
필수

당신의 Helius API 키입니다. 대시보드에서 무료로 받을 수 있습니다.

본문

application/json
jsonrpc
enum<string>
기본값:2.0
필수

JSON-RPC 프로토콜 버전입니다.

사용 가능한 옵션:
2.0
예시:

"2.0"

id
string
기본값:1
필수

요청에 대한 고유 식별자입니다.

예시:

"1"

method
enum<string>
기본값:getTransfersByAddress
필수

호출할 RPC 메소드의 이름입니다.

사용 가능한 옵션:
getTransfersByAddress
예시:

"getTransfersByAddress"

params
tuple
필수

필수 지갑 주소와 선택적 구성 객체가 포함된 배열입니다.

예시:

응답

지정된 주소에 대한 전송을 성공적으로 검색하였습니다.

jsonrpc
enum<string>

JSON-RPC 프로토콜 버전입니다.

사용 가능한 옵션:
2.0
예시:

"2.0"

id
string

요청과 일치하는 식별자입니다.

예시:

"1"

result
object

전송 데이터 및 페이지 매김 정보입니다.