EOA로 토큰 송/수신 기록 조회

특정 EOA의 토큰 거래내역을 조회합니다. 기능적으로 GET /v2/transfer와 같습니다. 단, 결과로 반환된 Transfer 객체에서 이 EOA가 토큰을 받았다면 to가, 토큰을 보냈다면 from이 EOA와 같습니다. 거래내역은 KAIA (=KLAY) 전송 (KlayTransfer), FT 전송 (FtTransfer), NFT 전송 (NftTransfer), MT 전송 (MtTransfer)으로 나뉘며 FT, NFT, MT 전송의 경우 토큰 전송을 실행한 KlayTransfer 전송내역이 조회 결과에 포함됩니다. FT, NFT, MT 전송을 실행한 KlayTransfervalue는 0일 수 있습니다. exclude-zero-klay=true 쿼리를 통해 KlayTransfer를 제외할 수 있습니다. 이와 관련된 자세한 설명은 GET /v2/transfer를 참조하여 주시기 바랍니다. 호환성을 위해 기존의 klay 용어를 유지하고 있습니다.

거래유형

  • kind 파라메터를 설정하여 여러 유형의 거래내역을 조회할 수 있습니다
  • kind가 설정되지 않으면 모든 유형의 거래내역이 조회됩니다


조회기간

  • range의 경우 range={from},{to} 포맷으로 질의합니다
  • {from}{to}가 정수일 경우 Unix time으로, 16진수 문자열일 경우 블록 번호로 간주합니다
  • {to}값이 없는 경우 현재 시간 또는 최신 블록 번호가 사용됩니다
  • 최대 검색기간은 6개월로 제한됩니다 (Unix time, 블록 두 경우 모두 해당)


Size

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

조회할 EOA 주소

query Parameters
kind
string

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

Example: kind=klay,ft,nft,mt
ca-filter
string

조회할 FT 또는 NFT, MT 컨트랙트의 주소, 설정될 경우 transferType이 "ft" 또는 "nft","mt"인 것들 중 ca-filter 값과 같은 것들만 결과물로 반환.

Example: ca-filter=0xc7565d24af561fe783aa73747ca0eda1f09f1118
range
string

(csv) 조회 범위 지정 (블록번호 또는 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=false
from-only
string

받은 내역만 포함할 지 여부 (default=false)

Example: from-only=false
to-only
string

보낸 내역만 포함할 지 여부 (default=false)

Example: to-only=false
header Parameters
x-chain-id
required
string

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

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