Skip to main content
지갑 API는 베타 버전입니다. 엔드포인트 및 응답 형식은 변경될 수 있습니다.

개요

Token Transfers 엔드포인트는 Solana 지갑의 모든 토큰 전송 활동을 검색하며, 발신자 및 수신자에 대한 자세한 정보를 포함합니다. 전체 거래 내역과 달리, 이 엔드포인트는 전송에 중점을 두어 결제 추적 및 전송 모니터링에 이상적입니다. 이 엔드포인트는 요청당 최대 100개의 전송을 반환하며 (기본값 50), 다음 페이지를 가져오기 위해 cursor 매개변수를 pagination.nextCursor와 함께 사용하고, 더 많은 결과를 확인하려면 pagination.hasMore를 읽으세요.

사용 시기

Token Transfers API는 다음과 같은 경우에 사용하세요:
  • 결제 추적: 결제 프로세서를 위한 들어오는 결제를 모니터링합니다.
  • 전송 피드 생성: 간단한 “보냄/받음” 활동 피드를 표시합니다.
  • 특정 토큰 모니터링: 특정 토큰의 전송을 추적합니다 (예: USDC 결제).
  • 거래 상대 식별: 누가 토큰을 보냈는지 또는 받았는지 확인하세요.
  • 영수증 생성: 발신자/수신자 세부 정보를 포함한 결제 영수증을 만듭니다.
  • 의심 활동 감지: 비정상적인 전송 패턴을 모니터링합니다.

빠른 시작

기본 전송 쿼리

최근 들어오고 나가는 전송을 얻습니다:

방향별 필터링

클라이언트 측에서 결과를 필터링하여 들어오는 전송 또는 나가는 전송만 얻습니다:

쿼리 매개변수

응답 형식

필드 노트

  • direction: 쿼리하는 지갑에 상대적입니다. in는 토큰이 받아진 경우 (들어오는 결제)에 해당하며, out는 토큰이 보내진 경우 (나가는 결제)에 해당합니다.
  • counterparty: in 전송의 경우 발신자; out 전송의 경우 수신자.
  • amount: 사람이 읽을 수 있는 전송 금액으로 이미 decimals로 나뉩니다. 표시용으로 사용하세요 (예: 1.5 SOL, 100.0 USDC).
  • amountRaw: 소수 점 조정 전에 정수 문자열로 표현된 동일한 금액입니다 (예: "1500000000"는 1.5 SOL의 경우). 부동 소수점의 정확도 손실을 피하기 위해 문자열로 직렬화됩니다. 온체인 명령이나 정밀한 산수를 위해 사용하세요: amount = parseInt(amountRaw) / 10**decimals.
  • mint: 토큰 민트 주소 (네이티브 SOL의 경우 So11111111111111111111111111111111111111111).
  • symbol: 토큰 심볼. 모든 토큰에 심볼이 있는 것은 아닙니다; symbolnull일 때 민트 주소를 사용하세요.

사용 사례

상인의 결제 이력 추적

들어오는 USDC 결제를 모니터링합니다:

결제 영수증 생성

특정 전송에 대한 상세 영수증을 만듭니다:

의심스러운 전송 패턴 모니터링

비정상적인 전송 활동을 감지합니다:

전송 활동 피드 구축

사용자 친화적인 활동 피드를 만듭니다:

결제 조정

예상 결제와 전송을 일치시킵니다:

페이지네이션

많은 전송이 있는 지갑의 경우 cursor 매개변수 및 pagination.hasMore를 사용하여 결과를 페이지로 나눕니다:

모범 사례

  • 특정 토큰을 위해 클라이언트 측에서 필터링. API는 모든 토큰 전송을 반환합니다. 특정 토큰 (예: USDC 또는 SOL)을 추적하려면 mint 주소로 필터링하십시오.
  • Identity API와 결합. Identity 엔드포인트를 사용하여 알려진 상대방 (거래소, 프로토콜 등)의 이름을 사람이 읽을 수 있게 표시하세요.
  • 최근 전송 캐시. 전송 데이터는 변경되지 않습니다. 결과를 캐시하고 마지막 쿼리 이후 새 전송만 가져옵니다.
  • 전체 기록을 위해 페이지네이션. 수천 개의 전송이 있는 지갑을 효율적으로 처리하려면 페이지네이션을 구현하세요.
  • 심볼 누락 처리. 모든 토큰에 symbol 필드가 있는 것은 아닙니다. symbolnull일 때 민트 주소를 사용하세요.

전송 대 거래 내역

결제에만 관심이 있다면 Transfers를 사용하세요. 전체 잔액 변경 데이터가 필요할 경우 Transaction History를 사용하세요.

일반적인 오류

다음 단계

지갑 내역

거래별 잔액 변경과 함께 완전한 거래 내역을 제공합니다.

지갑 API 개요

모든 지갑 API 엔드포인트와 공유 규칙.

API 참조

토큰 전송에 대한 요청 및 응답 스키마.