Token History API

Klaytn을 사용하면서 사용자가 토큰 송수신 내역과 토큰 정보를 확인하려면 모든 트랜잭션을 확인해야 합니다. 이런 번거로움이나 시간, 비용 문제를 KAS에서 해결할 수 있습니다. 이를 지원하는 것이 바로 Token History API입니다. Token History API는 특정 토큰의 이력을 모두 알아볼 수 있습니다. KLAY 전송 기록은 물론 FT, NFT, MT 같은 토큰 정보를 확인할 수 있고, 토큰 송수신 기록도 조회 가능합니다. Token History API의 기능은 다음과 같습니다.

• 컨트랙트 정보 및 목록 조회
  • FT 컨트랙트 정보 조회
  • NFT 컨트랙트 정보 조회
  • MT 컨트랙트 정보 조회
  • 모든 FT 컨트랙트 정보 목록 조회
  • 모든 NFT 컨트랙트 정보 목록 조회
  • 모든 MT 컨트랙트 정보 목록 조회
• 토큰 정보 조회
  • 특정 FT 정보 조회
  • 특정 NFT 정보 조회
  • 특정 MT 정보 조회
  • 특정 계정의 FT 정보 조회
  • 특정 계정의 NFT 정보 조회
  • 특정 계정의 MT 정보 조회
  • 토큰 송수신 기록 조회
• 소유자 정보 조회
  • 특정 MT의 모든 소유자 기록 조회
  • 특정 NFT의 소유권 변경 기록 조회
• 토큰 송수신 기록 조회
  • 트랜잭션 해시로 조회
  • 계정으로 조회

컨트랙트 정보 및 목록 조회

라벨링이란 KAS에 토큰 컨트랙트 정보를 등록하는 것을 의미합니다. 이는 Token History API가 특정 토큰의 이력을 추적할 수 있기 위함입니다. 라벨 상태는 모든 컨트랙트 목록이나 특정 컨트랙트 정보를 조회할 때 응답값으로 반환됩니다. 특정 컨트랙트를 조회하려면 컨트랙트 주소를 파라미터로 입력해 구분합니다.

토큰 정보 조회

정보 조회 기준에 따라 실행하는 API가 다릅니다. 정보 조회는 크게 2가지 기준이 있습니다.

• 토큰: 토큰을 기준으로 현재 소유자와 직전 소유자의 정보까지 모든 토큰 정보 확인
• 계정: 특정 계정이 소유한 토큰 정보를 조회

소유자 정보 조회

NFT 또는 MT 소유자 정보를 조회합니다. 특정 MT의 소유자 내역을 조회하면 토큰 정보는 물론 현재와 직전 소유자의 정보까지 확인할 수 있습니다. NFT의 소유권 변경 내역을 조회하면 발신자와 수신자, 전송 시간을 응답으로 반환합니다.

토큰 송수신 기록 조회

토큰의 거래 내역을 조회합니다. 아래 항목을 요청 스키마로 입력한 후 API를 실행하면 토큰 종류와 트랜잭션 정보, 컨트랙트 정보는 물론 토큰 발신자와 수신자 정보를 반환합니다.

• Preset

  토큰 컨트랙트 주소와 계정 주소의 집합입니다. KAS Console Service > Token History > Preset에서 Preset을 미리 생성해야 해당 API를 실행할 수 있습니다.

Token History API를 실행해보고 싶으신가요? 그렇다면 튜토리얼 문서를 읽고 따라해보세요. 각 기능별 API 레퍼런스는 KAS API Reference에서 확인할 수 있습니다.