Retrieve NFT details

get https://api.nftport.xyz/v0/nfts/{contract_address}/{token_id}

Returns details for a given NFT. These include metadata_url, metadata such as name, description, attributes, etc., file_url, cached_file_url and mint_date. Ethereum, Polygon and Goerli are supported.

Useful for:

For easily getting all the necessary information about a given NFT.

For a quick start, see the List of sample addresses and token IDs to copy.
To get all NFTs per contract, see Retrieve contract NFTs.
To get NFTs that a given account owns, see Retrieve NFTs owned by an account.

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

contract_address

string

required

Defaults to 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d

The contract address of the NFT.

token_id

string

required

Defaults to 567

A unique uint256 ID inside the contract. The contract address and token ID pair is a globally unique and fully-qualified identifier for a specific NFT on chain.

Query Params

chain

string

required

Defaults to ethereum

Blockchain from which to query NFTs.

refresh_metadata

boolean

Defaults to false

Queues and refreshes the metadata of the token if it has changed since the updated_date. Useful for example, when NFT collections are revealed.

include

array of strings

[BETA] Available only for Ethereum. Include optional data in the response. rarity includes NFT rarity data. attributes includes NFT attributes (traits)

include

Response

`nft` property that contains details for a single NFT.

Response body

object

response

string

required

Response status, either OK or NOK.

nft

object

Details of the NFT.

chain

string

required

Defaults to ethereum

An enumeration.

ethereum polygon goerli

contract_address

string

required

The contract address of the NFT.

token_id

string

required

A unique uint256 ID inside the contract. The contract address and token ID pair is a globally unique and fully-qualified identifier for a specific NFT on chain.

metadata_url

string

Metadata URL inside the contract for a given token, also known as the token URI. For ERC-721 it is the token_uri() function and for ERC-1155 it is the uri() function in the smart contract.

metadata

object

Raw NFT metadata downloaded from the metadata_url i.e. token URI. It usually includes the name, description and attributes along with any other data added by the creator.

Has additional fields

file_information

object

Extra information of the NFT’s file.

file_url

string

Original file (image, video, etc) URL of the NFT.

animation_url

string

URL of multi-media file set in the NFT metadata. Most commonly used file types are GLTF, GLB, WEBM, MP4, M4V, OGV, OGG, along with audio MP3, WAV, and OGA. Also HTML pages, allowing to build rich experiences and interactive NFTs using JavaScript canvas, WebGL, and more.

cached_file_url

string

Cached file (image, video, etc) in NFTPort's cloud with no access restrictions, low latency and high availability.

cached_animation_url

string

Cached URL of animated file (video, gif, etc) as set in the NFT metadata. This URL points to a file cached in NFTPort's cloud storage with no access restrictions, low latency and high availability.

creator_address

string

NFT creator address.

mint_date

string

Date when the NFT was minted (ISO).

updated_date

string

Date when the NFT’s metadata was last downloaded or updated/refreshed.

rarity

object

Rarity data of the NFT. Included only if rarity value provided for the include parameter.

attributes

array of objects

A list of NFT attributes (traits). Included only if rarity value provided for the include parameter.

Attributes

object

trait_type

string

required

Trait type.

display_type

string

Display type.

value

string

required

Attribute value.

statistics

object

required

Attribute statistics.

owner

string

Current owner of the NFT.

contract

object

Information of the NFT’s contract.

name

string

Name of the contract.

symbol

string

Symbol of the contract.

type

string

Contract type.

ERC721 ERC1155 CRYPTO_PUNKS

metadata

object

Metadata about the collection.

status

string

Status of the contract tokens in the metadata refresh queue.

ADDED PROCESSING PENDING REFRESHED_RECENTLY

status_message

string

Detailed description of the status.

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.nftport.xyz/v0/nfts/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d/567?chain=ethereum&refresh_metadata=false' \
3
     --header 'accept: application/json'

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

application/json

200A JSON object with an nft property that contains details for a single NFT.

`nft` property that contains details for a single NFT.