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

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

거래유형

  • 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:
basic
path Parameters
address
required
string

조회할 EOA 주소

query Parameters
kind
string

(csv) [“klay”, “ft”, “nft”,"mt"] 중 포함 할 유형, 지정안될 경우 모든 유형을 조회

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 klay 전송 제외 여부(default=false)

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

Klaytn 체인 네트워크 ID (1001 or 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"
}