Get NFT Transfers Within Range

특정 기간동안 발생한 NFT 전송 목록을 조회합니다. 조회 결과에는 컨트랙트 메타데이터와 NFT 메타데이터가 포함됩니다.

📘

기간 설정 팁

설정한 기간이 길 경우 응답시간이 길어질 수 있습니다. 빠른 응답을 원한다면 필요한 기간만큼만 설정하는 것을 권장합니다.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Defaults to optimism

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

string
required
Defaults to mainnet

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

Body Params
string
Defaults to 19415000

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

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

유의사항:

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

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

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

유의사항:

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

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

유의사항:

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

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

유의사항:

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

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

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

integer

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

string

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

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

boolean
Defaults to false

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

boolean
Defaults to false

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

boolean
Defaults to false

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

Responses

Response body
object
integer

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

integer

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

string

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

integer

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

items
array of objects
required

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

items*
object
string
required

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

string
required

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

string
required

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

integer
required

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

integer
required

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

string
required

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

integer
required

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

integer

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

contract
object
nft
object

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json
English
Powered by Localize
한국어