The SimpleHash API returns NFT data in a standard format. The following are the fields included in the response (or as a list of NFT objects).

Field

Description

Type(s)

nft_id

Unique identifier for an NFT (chain.contract.token_id for EVM chains, chain.token_id for Solana)

string

chain

Name of the blockchain (e.g., ethereum)

string

contract_address

Address of the NFT's contract (hex format for EVM compatible chains). For Solana, this is a Base58-encoded string uniquely representing the NFT itself.

string

token_id

Token ID (usually numeric) of the NFT on its contract. Not applicable for Solana.

string

name

Name of the NFT derived from its metadata

string, null

description

Description of the NFT derived from its metadata

string, null

image_url

URL to cached image file on the SimpleHash CDN if available

string, null

video_url

URL to cached video file on the SimpleHash CDN if available

string, null

audio_url

URL to cached audio file on the SimpleHash CDN if available

string, null

model_url

URL to cached 3D model file on the SimpleHash CDN if available

string, null

previews

Set of URLs to resized preview images of the media, including an opengraph image, and blurhash, where available. Previews are sized to fit the maximum dimension in pixels as follows: (small: 250px, medium: 512px, large: 1000px)

{
image_small_url:string,
image_medium_url:string,
image_large_url:string,
image_opengraph_url:string,
blurhash: string,
}
(each may be null)

background_color

Background color of the NFT derived from its metadata

string, null

external_url

External URL derived from the NFT's metadata, often with more information (such as about the project), where available

string, null

created_date

NFT minting datetime if known in timestamp format (e.g., 2021-07-03T23:45:00)

string, null

status

NFT status, one of minted, or burned

string

token_count

Known quantity of this NFT

int

owner_count

Known number of owners of this NFT

int

owners

Array of known owners of this NFT (limited to top 50 owners)

{
owner_address:string,
quantity: int,
first_acquired_date: string,
last_acquired_date: string
}[]

last_sale

Detail on the most recent sale involving this NFT

last_sale, null

contract

Contract type info for this NFT (type is usually the standard for the contract, such as ERC721)

{
type:string,
name:string,
symbol:string
}

collection

The associated collection information for this NFT

Collection model

extra_metadata

JSON field containing the additional custom metadata fields for the NFT added by the creator. Often includes fields such as attributes or traits. Where available, also includes the image_original_url and / or animation_original_url links to the original media source

json, null