Get NFT Transfers By Account

post https://web3.nodit.io/v1/{protocol}/{network}/nft/getNftTransfersByAccount

특정 주소가 전송 혹은 수신한 NFT 전송 목록을 조회합니다. 조회 결과에는 컨트랙트 메타데이터와 NFT 메타데이터가 포함됩니다.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

protocol

string

required

Defaults to luniverse

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

network

string

required

Defaults to mainnet

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

Body Params

accountAddress

string

required

Defaults to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

조회하고자 하는 계정의 주소를 지정하는 파라미터입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 입력할 수 있습니다.

relation

string

조회 대상 계정 주소가 송신자 또는 수신자에 속한 트랜잭션만 필터링하기 위한 파라미터입니다.

from: 송신자로만 필터링.
to: 수신자로만 필터링.
both(기본값): from과 to에 하나라도 포함된 모든 트랜잭션이 조회됩니다.

contractAddresses

array of strings

조회하고자 하는 컨트랙트 주소의 배열을 지정하는 파라미터입니다. 컨트랙트 주소는 0x로 시작하는 40자리의 16진수 문자열 형태로 입력할 수 있습니다.

contractAddresses

fromBlock

string

조회 시작 블록을 지정하는 파라미터입니다. 다음 형식 중 하나를 입력할 수 있습니다:

block number: 10진수 문자열로 블록 번호를 입력.
block hash: 64자리 16진수("0x" 포함).
block tag: "earliest" 또는 "latest"를 사용하여 첫 번째 블록 또는 최신 블록을 지정.

유의사항:

toBlock 없이 제공하면, 해당 블록부터 최신 블록까지 결과를 조회합니다.
fromBlock 값은 toBlock 값보다 클 수 없습니다.
fromBlock과 toBlock에 동일한 값을 입력하면, 해당 블록만 조회됩니다.
fromBlock에 "latest"는 toBlock이 "latest"일 때만 허용됩니다.

toBlock

string

조회 종료 블록을 지정하는 파라미터입니다. 다음 형식 중 하나를 입력할 수 있습니다:

block number: 10진수 문자열로 블록 번호를 입력.
block hash: 64자리 16진수("0x" 포함).
block tag: "earliest" 또는 "latest"를 사용하여 첫 번째 블록 또는 최신 블록을 지정.

유의사항:

fromBlock 없이 제공하면, genesis block부터 해당 블록까지 결과를 조회합니다.
toBlock 값은 fromBlock 값보다 작을 수 없습니다.
fromBlock과 toBlock에 동일한 값을 입력하면, 해당 블록만 조회됩니다.
toBlock에 "earliest"는 fromBlock이 "earliest"일 때만 허용됩니다.

fromDate

string

Defaults to 2025-01-01T00:00:00+00:00

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

유의사항:

toDate 없이 제공하면, 해당 날짜부터 최신 블록까지 결과를 조회합니다.
fromDate 값은 toDate 값과 같거나 더 과거의 값을 가져야 합니다.
fromDate와 toDate에 동일한 값을 입력하면, 해당 날짜에서 발생한 블록만 조회됩니다.
이 필드는 fromBlock, toBlock과 함께 사용할 수 없습니다.

toDate

string

Defaults to 2025-01-31T00:00:00+00:00

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

유의사항:

fromDate 없이 제공하면, genesis block부터 해당 날짜까지 결과를 조회합니다.
toDate 값은 fromDate 값과 같거나 더 미래의 값을 가져야 합니다.
fromDate와 toDate에 동일한 값을 입력하면, 해당 날짜에서 발생한 블록만 조회됩니다.
이 필드는 fromBlock, toBlock과 함께 사용할 수 없습니다.

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 필드가 포함되며 응답속도가 느려질 수 있습니다.

withMetadata

boolean

Defaults to false

응답에 NFT 토큰 메타데이터 관련 필드(rawMetadata, metadataSyncedAt)의 포함 여부를 지정하는 파라미터입니다. 이 파라미터에 true를 입력한 경우, 응답속도가 느려질 수 있습니다.

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

토큰이 전송된 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

string

required

토큰을 전송받은 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수 문자열 형태로 제공됩니다.

value

string

required

전송한 토큰의 수량을 나타내는 필드입니다. 10진수 문자열 형태로 제공됩니다.

timestamp

integer

required

토큰 전송이 발생한 시간을 나타내는 필드입니다. 이 필드는 UNIX 타임스탬프로 제공됩니다.

blockNumber

integer

required

토큰 전송이 발생한 블록 번호를 나타내는 필드입니다.

transactionHash

string

required

토큰 전송 트랜잭션의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.

logIndex

integer

required

토큰 전송 트랜잭션의 로그 인덱스를 나타내는 필드입니다. 트랜잭션에서 발생한 이벤트의 순서를 의미합니다.

batchIndex

integer

토큰 전송 트랜잭션의 배치 인덱스를 나타내는 필드입니다. 이 필드는 ERC1155 토큰 전송에 대한 응답에만 포함됩니다.

contract

object

nft

object

xxxxxxxxxx
curl --request POST \
     --url https://web3.nodit.io/v1/luniverse/mainnet/nft/getNftTransfersByAccount \
     --header 'X-API-KEY: nodit-demo' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "accountAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "fromDate": "2025-01-01T00:00:00+00:00",
  "toDate": "2025-01-31T00:00:00+00:00",
  "withCount": false,
  "withMetadata": false,
  "withZeroValue": false
}
'

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

429Too Many Requests