토큰 송/수신 기록 조회

거래내역을 통합 조회합니다. 거래내역은 KAIA (=KLAY) 전송 (KlayTransfer), FT 전송 (FtTransfer), NFT 전송 (NftTransfer), MT 전송 (MtTransfer)으로 나뉩니다. 호환성을 위해 기존의 klay 용어를 유지하고 있습니다.

FT/NFT/MT 거래내역 조회 결과에 포함된 KlayTransfer

FT, NFT, MT 전송의 경우 토큰 전송을 실행한 KlayTransfer 전송내역이 조회 결과에 포함됩니다. 이것은 FT/NFT/MT 토큰 전송은 기본적으로 FT/NFT/MT 컨트랙트 함수의 실행이기 때문이며 transfer는 토큰 전송 함수를 실행하는 트랜잭션에 대응하는 KlayTransfer를 응답에 포함합니다. 컨트랙트 함수를 실행하는 트랜잭션들은 대체로 KAIA(=KLAY)를 전송하지 않기 때문에 FT, NFT, MT 전송을 실행한 KlayTransfer의 value는 0일 수 있습니다. exclude-zero-klay=true 쿼리를 통해 KlayTransfer를 제외할 수 있습니다.

거래유형

  • kind 파라메터를 설정하여 KAIA(=KLAY), FT, NFT, MT 중 한 가지 유형을 골라 거래내역을 조회할 수 있습니다
  • kind가 설정되지 않으면 모든 유형의 거래내역이 조회됩니다


조회기간

  • range의 경우 range={from},{to} 포맷으로 질의합니다
  • {from}과 {to}가 정수일 경우 Unix time으로, 16진수 문자열일 경우 블록 번호로 간주합니다
  • {to}값이 없는 경우 현재 시간 또는 최신 블록 번호가 사용됩니다
  • 한 번에 불러올 수 있는 거래내역은 최대 과거 6개월 분량입니다(Unix time, 블록 두 경우 모두 해당)


Preset

Preset은 EOA, FT, NFT, MT 컨트랙트 주소들의 집합입니다. 반복적으로 특정 어카운트들의 거래내역만을 쉽고 빠르게 조회할 때 사용할 수 있습니다.

  • presets 쿼리 파라미터는 필수 파라미터입니다
  • Preset은 KAS Console에서 사전에 생성되어 있어야 합니다
  • Preset ID는 KAS Console에서 확인하실 수 있습니다


Size

  • size 쿼리 파라미터는 선택 파라미터입니다 (최소값 = 1, 최대값 = 1000, 기본값 = 100)
  • 음수를 입력하면 오류를 반환합니다
  • 0을 입력하면 기본값(size=100)을 사용합니다
  • 최대값보다 큰 값을 입력하면 최대값을 사용합니다
Request
Security:
basic
query Parameters
kind
string

(csv) [“klay”, “ft”, “nft”, “mt”] 중 포함 할 유형, 지정안될 경우 모든 유형을 조회. 호환성을 위해 기존의 klay 용어를 유지하고 있습니다.

Example: kind=klay,ft,nft,mt
range
string

조회 범위 지정 (블록번호 또는 Unix time)

Example: range=0x1,0x2
size
integer <int64>

응답 아이템 개수 (min=1, max=1000, default=100)

Example: size=100
cursor
string

응답 오프셋

exclude-zero-klay
string

0 KAIA (=KLAY) 전송 제외 여부 (default=false). 호환성을 위해 기존의 klay 용어를 유지하고 있습니다.

Example: exclude-zero-klay=true
presets
required
string

(csv) 검색에 사용할 Preset ID들, Preset ID는 KAS Console에서 확인

Example: presets=65,68
header Parameters
x-chain-id
required
string

Kaia 네트워크 체인 ID (1001 또는 8217)

Responses
200
400
404
get/v2/transfer
Request samples
curl -i -X GET \
  -u <username>:<password> \
  'https://th-api.klaytnapi.com/v2/transfer?kind=string&range=string&size=0&cursor=string&exclude-zero-klay=string&presets=string' \
  -H 'x-chain-id: string'
Response samples
application/json
{
  • "items": [
    ],
  • "cursor": "KGvdzQDxL2AYZzAMk1dLK6g9OrJN02G7aqwaNpWkPJlL07V51MZ8xmBOR17GPp1KDXE5bKhYnv93XgGbrz6EdAKeoQ2Y4Dq3peQV45vDPWmoXxlYB8wbEVPXBb9a7Z6O"
}