getNftMetadataByTokenId

post

https://web3.luniverse.io/v1/{protocol}/{network}/nft/getNftMetadataByTokenId

TokenId를 이용하여 특정 NFT의 메타데이터를 조회합니다.

Path Params

protocol

string

required

Defaults to ethereum

조회 대상 Chain 프로토콜을 지정하기 위한 파라미터입니다. 지원되는 프로토콜에 대한 정보는 Supported Chains 페이지를 참고하거나, Protocol 조회 API를 활용하세요.

network

string

required

Defaults to mainnet

조회 대상 Chain 네트워크를 지정하기 위한 파라미터입니다. mainnet 또는 테스트넷을 지정할 수 있습니다. 지원되는 네트워크에 대한 정보는 Supported Chains 페이지를 참고하거나 Network 조회 API를 활용하세요.

Body Params

contractAddress

string

required

특정 컨트랙트의 주소를 지정하기 위한 파라미터입니다.

tokenId

string

required

특정 NFT를 지정하기 위한 파라미터 입니다.

resync

boolean

cache된 메타데이터 확인을 위한 파라미터. true로 설정 시 on-chain에 tokenURI를 조회하여 응답값을 반환합니다. false 설정 시 on-chain에 데이터 조회를 요청하지 않아 빠른 응답이 가능합니다. Default는 false 입니다.

timeoutSeconds

int32

metadata를 조회할 때, 사용자 편의를 위해 응답 시간을 조정할 수 있는 파라미터. 세팅한 시간 내에 응답이 오지 않을 경우, 408 response를 반환하나 내부적으로 data caching 작업은 지속됩니다. Default는 55초이며 최소 1초, 최대 55초까지 입력 가능합니다.

Responses

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400