tokenHistory API

  1. tokenHistory API를 쓸 때, query 설정
    KLAY가 아니라 자체 발행한 토큰(KIP7 토큰인 DTK)을 조회하려고 하면 kind로 설정이 가능한가요?
    공식 문서를 보니 klay, ft, nft 이런 종류만 선택이 가능한거같아서요.

  2. 조회를 할 때마다 인자값을 줘서 계정에 대한 tokenHistory를 얻을 수 있을까요?
    예를 들면 getTransferHistoryByAccount(‘계정’) 이런 API가 있나요?

아래는 제가 쓰고 있는 코드입니다.

async function tokenHistory(){
	console.log('get tokenHistory.....')

	const query = {
		kind: [caver.kas.tokenHistory.queryOptions.kind.KLAY], //Token 거래를 보고 싶은건데
		size: 10,
		range: '1617993758,1618944158',
	}

	// KAS PRESET 설정. (Smart Contract Address 및 Owner EOA)
	const result = 	await caver.kas.tokenHistory.getTransferHistory(182, query) 
	console.log(result)
	// await caver.kas.tokenHistory.getTransferHistory(182).then(console.log)
}

안녕하세요, 클레이튼 포럼에 질문을 올려주셔서 감사드립니다.

  1. kind는 KIP-7(FT), KIP-17(NFT), KLAY에 대한 구분자입니다. 특정 토큰을 구분하지는 않습니다. /v2/transfer API를 사용하시려면 preset을 통해 원하시는 컨트랙트를 설정하시면 그 컨트랙트 내용만 받아보실 수 있습니다.

  2. /v2/transfer/account/{address} 이 API를 사용하시면 될 것 같습니다. 여기서도 마찬가지로 ca-filter에 원하시는 컨트랙트 주소를 넣으시면 그 컨트랙트에 대한 전송이력만 조회하실 수 있습니다.

감사합니다.

1 Like

답변 감사합니다.

참고하여 caver-js-ext-kas에서 getTransferHistoryByAccount()를 이용중인데요
1. 여기 나온 value는 token이 아니라 klay값인거 같은데요. token 값을 확인하려면 어떻게 해야 되나요?

2. token Transfers를 확인할 수 있는 API가 따로 있을까요?"
transfer()를 통해 얼마의 토큰을 보내줬는지, 해당 계정의 token 보유량은 얼마인지 등이요.

  1. token과 KLAY를 모두 확인하실 수 있습니다. 다른 데이터도 같이 확인을 부탁드리겠습니다. getTransferHistoryByAccount()의 두 번째 파라미터가 queryOptions인데, 여기에 kind에 FT로 명시해주시면 FT에 대한 데이터만 확인하실 수 있습니다.
  2. 현재 KIP-7 API는 구현 마무리 중입니다. 해당 API가 제공되면 해당 계정의 보유량은 좀 더 쉽게 확인하실 수 있을 것 같습니다. token transfer는 Token History API를 통해 확인하실 수 있습니다.

감사합니다.

답변 감사합니다.

  1. kind에 FT로 설정을 이미 해줬는데요. 그러면 Klay만 나오는거 아닌가요?
    tx type이 legacy transaction, value transfer 들이고 결과값으로 나오는 value에는 klay 값만 나오는데 token 값을 어떻게 조회해야될까요? token 주고받은 양을 알고 싶습니다.
  1. kind에 FT로 설정하셨으면, klay가 아닌 KIP-7 토큰에 대한 전송내역이 포함됩니다. 다만 FT 전송도 실제로는 smart contract execution transaction이 발생하고, 이 트랜잭션에도 KLAY를 전송할 수 있는 기능이 있기 때문에, KLAY 내역이 추가로 나올 수 있습니다.

  2. https://refs.klaytnapi.com/en/th/latest#tag/Token-History 여기에 보시면 response에 대한 예제가 있습니다. transferType이 "ft"인 정보의 "value"값을 확인하시면 원하시는 정보를 얻으실 수 있습니다.

감사합니다.

1 Like