토큰 거래내역

개요

해당 계정의 토큰 거래내역을 조회합니다. from, to, transactionHash 등의 트랜잭션 내용을 반환합니다.

해당 트랜잭션의 블록체인 탐색기(ex: etherscan) url을 포함합니다.

Android

Parameters

Name	Type	Explane	참조
network	String	네트워크	required
owner	String	계정	required
token_id	String	토큰 아이디 (컨트랙트 주소)	(select) if token_id=empty, 0x0000000...0000000000 (메인넷 코인) required
sort	String	정렬 (asc, desc)	(select) default: desc
limit	Int	수량 (0: 전체)	(select) default: 0
page_number	Int	페이지 넘버	(select) if limit=not empty, select (default: 1) else if limit=empty, error

Response

이름	타입	설명
result	String	호출 결과 성공여부 (성공: OK, 실패: FAIL)
sum	int	호출 결과 카운터
sort	String	정렬

value (array of object)

Name	Type	Explane
network	String	네트워크
token_id	String	토큰 아이디 (컨트랙트 주소)
block_number	String	블록 번호
timestamp	String	트랜잭션 시간
transaction_hash	String	트랜잭션 해시 값
from	String	보내는 계정
to	String	받는 계정
symbol	String	토큰 심볼
amount	String	이동한 수량 (wei)
decimals	String	토큰 소수점 자리수
gas_used	String	수수료 (wei)

Example

// parameters
val network = "cypress"
val owner = "0x..."
val token_id = "0x..."
val sort = "desc"
val limit = 0
val getTokenHistory = getTokenHistoryAsync(network, 
     owner, 
     token_id, 
     sort, 
     limit)
println(getTokenHistory)

// getTokenHistory result log
/*
  {
      "result": "OK",
      "sum": "3",
      "sort": "desc",
      "value": [
          {
            "network": "ethereum",
            "token_id": "0x...",
            "block_number": "16500012",
            "timestamp": "1674844979",
            "transaction_hash": "0x...",
            "from": "0x...",
            "to": "0x...",
            "symbol": "USDT",
            "amount": "38517813190125303766", // wei
            "decimals": "18",
            "gas_used": "152837" // wei
          },
          {
            "network": "ethereum",
            "token_id": "0x...",
            "block_number": "16500008",
            "timestamp": "1674844931",
            "transaction_hash": "0x...",
            "from": "0x...",
            "to": "0x...",
            "symbol": "USDT",
            "amount": "1413152143", // wei
            "decimals": "18",
            "gas_used": "736607" // wei
          }
      ]
  }
*/

Ios

Parameters

Name	Type	Explane	참조
network	String	네트워크	required
owner	String	계정	required
token_id	String	토큰 아이디 (컨트랙트 주소)	(select) if token_id=empty, 0x0000000...0000000000 (메인넷 코인) required
sort	String	정렬 (asc, desc)	(select) default: desc
limit	Int	수량 (0: 전체)	(select) default: 0

Response

이름	타입	설명
result	String	호출 결과 성공여부 (성공: OK, 실패: FAIL)
sum	int	호출 결과 카운터
sort	String	정렬
page_count	int	페이지 수

value (array of object)

Name	Type	Explane
network	String	네트워크
token_id	String	토큰 아이디 (컨트랙트 주소)
block_number	String	블록 번호
timestamp	String	트랜잭션 시간
transaction_hash	String	트랜잭션 해시 값
from	String	보내는 계정
to	String	받는 계정
symbol	String	토큰 심볼
amount	String	이동한 수량 (wei)
decimals	String	토큰 소수점 자리수
gas_used	String	수수료 (wei)

Example

// parameters
let network = "cypress"
let owner = "0x..."
let token_id = "0x..."
let sort = "desc"
let limit = 1
let getTokenHistory = try await getTokenHistoryAsync(network: network, 
   owner: owner, 
   token_id: token_id, 
   sort: sort, 
   limit: limit)
print(getTokenHistory)

// getTokenHistory result log
/*
  {
      "result": "OK",
      "sum": "3",
      "sort": "desc",
      "value": [
          {
            "network": "ethereum",
            "token_id": "0x...",
            "block_number": "16500008",
            "timestamp": "1674844931",
            "transaction_hash": "0x...",
            "from": "0x...",
            "to": "0x...",
            "symbol": "USDT",
            "amount": "1413152143", // wei
            "decimals": "18",
            "gas_used": "736607" // wei
          },
          {
            "network": "ethereum",
            "token_id": "0x...",
            "block_number": "16500001",
            "timestamp": "1674844847",
            "transaction_hash": "0x...",
            "from": "0x...",
            "to": "0x...",
            "symbol": "USDT",
            "amount": "20115660308317876961540", // wei
            "decimals": "18",
            "gas_used": "472518" // wei
          }
      ]
  }
*/

Web