Get Asset(TRC10) Transfers by Account

post https://web3.nodit.io/v1/{protocol}/{network}/asset/getAssetTransfersByAccount

특정 주소가 전송 혹은 수신한 Asset(TRC10) 전송 Transfer 리스트 조회합니다.

🚧
TRC10이란?
TRC10은 트론에서 지원하는 기본 토큰 표준입니다. 이 표준으로 발행된 토큰은 스마트 컨트랙트를 사용하지 않고, 트론 체인 자체에 내장된 규격에 따라 생성됩니다. 이런 구조적 특징 덕분에 복잡한 과정 없이도 손쉽게 토큰을 발행할 수 있으며, 각 토큰은 고유한 Asset ID로 식별됩니다.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to tron

조회 대상 체인의 프로토콜을 지정하기 위한 파라미터입니다.

network

string

required

Defaults to mainnet

조회 대상 체인의 네트워크를 지정하기 위한 파라미터입니다. 프로토콜에 따라 지원되는 네트워크가 다를 수 있습니다.

Body Params

accountAddress

string

required

Defaults to TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N

조회할 계정의 주소를 지정하는 파라미터입니다. 이 필드는 “T”로 시작하는 34자리 base58 문자열 형식을 가집니다.

assetIds

array of integers

조회할 Asset ID 목록을 입력합니다. Asset ID는 0보다 큰 정수여야 합니다.

assetIds

fromBlock

string

Defaults to 19415000

조회 시작 시점을 지정하는 파라미터입니다. block number, block hash 또는 block tag를 입력할 수 있으며, 기본 값은 0입니다.

block number: 10진수 문자열로 입력합니다.
block hash: 64자리 16진수 문자열로 입력하며, 0x 접두사는 제외해야 합니다.
block tag: fromBlock으로 "earliest"를 입력할 수 있습니다.

유의사항:

toBlock 없이 fromBlock만 제공되면, fromBlock에서 가장 최근 블록까지의 결과가 조회됩니다.
fromBlock의 block number는 toBlock의 block number보다 작거나 같아야 합니다.
toBlock과 fromBlock에 동일한 값을 입력하면, 해당 블록 하나의 결과만 조회됩니다.
fromBlock에는 "latest"를 입력할 수 없습니다.

toBlock

string

Defaults to latest

조회 종료 시점을 지정하는 파라미터입니다. block number, block hash 또는 block tag를 입력할 수 있으며, 기본 값은 “latest” 입니다.

block number: 10진수 문자열로 입력합니다.
block hash: 64자리 16진수 문자열로 입력하며, 0x 접두사는 제외해야 합니다.
block tag: "latest"를 입력할 수 있습니다.

유의사항:

입력한 toBlock에 해당하는 blockNumber는 입력한 fromBlock에 해당하는 blockNumber보다 크거나 같은 값을 입력해야 합니다.
toBlock와 fromBlock에 동일한 값이 입력된 경우, 입력된 블록 한 개의 결과만 조회됩니다.
fromBlock 없이 toBlock만 제공되는 경우, genesis block부터 toBlock에 입력한 시점까지의 결과가 조회됩니다.
toBlock에는 ”earliest”를 입력할 수 없습니다.

fromDate

string

조회 시작 시점을 지정하는 파라미터입니다. 날짜는 ISO 8601 형식(YYYY-MM-DDThh:mm:ss{time zone})을 따라야 하며, 시간은 항상 초단위까지 입력해야 합니다.

유의사항:

toDate 없이 fromDate만 제공되면, fromDate부터 최신 블록까지의 결과가 조회됩니다.
fromDate는 toDate보다 과거의 날짜여야 합니다.
해당 필드는 fromBlock 및 toBlock과 함께 사용할 수 없습니다.
fromDate와 toDate에 동일한 값을 입력하면, 해당 날짜에 생성된 블록의 결과가 조회됩니다.
toDate 없이 fromDate만 제공되면, 첫 번째 블록부터 fromDate까지의 결과가 조회됩니다.

toDate

string

조회 종료 시점을 지정하는 파라미터입니다. 날짜는 ISO 8601 형식(YYYY-MM-DDThh:mm:ss{time zone})을 따라야 하며, 시간은 항상 초단위까지 입력해야합니다.

유의사항:

toDate는 fromDate보다 미래의 날짜여야 합니다.
이 필드는 fromBlock 및 toBlock과 함께 사용할 수 없습니다.
fromDate와 toDate가 동일한 경우, 해당 날짜에 생성된 블록의 결과만 조회됩니다.
fromDate 없이 toDate만 제공되면, 첫 번째 블록부터 toDate까지의 결과가 조회됩니다.

page

integer

page 파라미터는 조회하려는 데이터 페이지를 지정하는 데 사용됩니다. 이 파라미터는 100 이하의 값을 받으며, 100을 초과하는 페이지가 필요한 경우 cursor 페이지네이션 방식을 사용해야 합니다.

page 파라미터와 cursor 파라미터는 동시에 사용할 수 없습니다. page와 cursor에 모두 빈 값을 입력한 경우, cursor 페이지네이션을 사용하는 것으로 간주합니다.

rpp

integer

rpp는 results per page의 약자로, 한 페이지의 사이즈를 지정하는 파라미터입니다. 0보다 크고 1000 이하의 숫자를 지정할 수 있습니다.

cursor

string

cursor 파라미터는 페이지네이션을 위한 파라미터로, 이전 페이지와 다음 페이지 간의 데이터 이동을 지원합니다. 이전 페이지에서 얻은 cursor 값을 다음 요청에 제공하면 다음 페이지의 데이터를 로드할 수 있습니다.

withCount

boolean

Defaults to false

응답에 count 필드의 포함 여부를 지정하는 파라미터이며, count 필드는 요청한 데이터의 총 개수를 나타냅니다. 이 파라미터에 true를 입력한 경우, 응답에 count 필드가 포함되며 응답속도가 느려질 수 있습니다.

withZeroValue

boolean

Defaults to false

응답에 value가 0인 결과를 포함하는지 여부를 지정하는 파라미터입니다. 더 빠른 응답을 원한다면 이 파라미터를 true로 설정하세요.

Responses

Response body

object

page

integer

page 파라미터에 지정된 페이지 번호를 나타내는 필드입니다. 이 필드는 page 파라미터에 0보다 큰 값을 입력한 경우에만 응답에 포함됩니다.

rpp

integer

rpp 파라미터에 지정된 페이지당 결과 수를 나타내는 필드입니다.

cursor

string

cursor 페이지네이션을 위한 필드로, 다음 페이지의 데이터를 로드하기 위해 다음 요청에 제공해야 하는 값입니다.

count

integer

요청한 데이터의 총 개수를 나타내는 필드입니다. 이 필드는 withCount 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.

items

array of objects

required

조회된 데이터의 목록을 나타내는 필드입니다.

items*

object

from

string

required

트랜잭션을 발생시킨 주소를 나타냅니다. 이 주소는 자산을 받는 계정이나 스마트 컨트랙트의 주소를 의미합니다. 이 필드는 “T”로 시작하는 34자리 base58 문자열 형식을 가집니다.

string

required

트랜잭션의 수신자 주소를 나타냅니다. 이 주소는 자산을 받는 계정이나 스마트 컨트랙트의 주소를 의미합니다. 이 필드는 “T”로 시작하는 34자리 base58 문자열 형식을 가집니다.

value

string

required

전송된 자산의 양 또는 데이터를 나타냅니다. TRC10, TRC20의 경우 전송된 금액을 의미합니다.

blockTimestamp

integer

required

트랜잭션이 포함된 블록이 생성된 시간을 나타냅니다. 밀리초 단위의 UNIX 타임스탬프 형식으로 기록되며, 이를 통해 트랜잭션 발생 시점을 확인할 수 있습니다.

blockNumber

integer

required

트랜잭션이 포함된 블록의 번호를 나타냅니다. 블록체인 상에서 해당 트랜잭션을 추적하는 데 사용되며, 특정 블록 내에서 트랜잭션의 위치를 식별합니다.

transactionHash

string

required

트랜잭션의 고유 해시 값을 나타냅니다. 트랜잭션의 식별자로 사용되며, 해당 트랜잭션과 관련된 모든 데이터를 추적할 수 있는 키 역할을 합니다.

transactionIndex

integer

required

트랜잭션이 포함된 블록 내에서의 위치를 나타냅니다. 여러 트랜잭션이 있는 블록에서 해당 트랜잭션의 순서를 식별하는 데 사용됩니다.

logIndex

integer

해당 Transfer 이벤트가 포함된 로그의 인덱스를 나타냅니다. 동일한 블록 내 여러 로그가 존재할 경우 특정 로그를 구분하는 데 사용됩니다.

internalTransactionIndex

integer

TRX 또는 TRC10 전송과 관련된 내부 트랜잭션의 인덱스를 나타냅니다. 블록 내에서 여러 내부 트랜잭션이 있는 경우 이를 구분하는 데 사용됩니다.
* 이 값이 "-1"인 경우, Root Transaction을 의미합니다.

exchangeId

integer

트론 네트워크에서 제공하는 탈중앙화 거래소(DEX)의 교환 거래(Swap)를 식별하는 고유 ID입니다. 이 ID를 통해 특정 교환 트랜잭션을 구분하고, 어떤 자산 페어에서 거래가 이루어졌는지 추적할 수 있습니다. 교환 거래로 인한 전송이 아닌 경우, null을 반환합니다.

asset

object

xxxxxxxxxx
curl --request POST \
     --url https://web3.nodit.io/v1/tron/mainnet/asset/getAssetTransfersByAccount \
     --header 'X-API-KEY: nodit-demo' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "accountAddress": "TT2T17KZhoDu47i2E4FWxfG79zdkEWkU9N",
  "fromBlock": "19415000",
  "toBlock": "latest",
  "withCount": false,
  "withZeroValue": false
}
'

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests