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_address.token_id for EVM chains & Flow, chain.mint_address for Solana, chain.inscription_id for Bitcoin) |
|
chain | Name of the blockchain (e.g., |
|
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. For Bitcoin, this is the inscription ID. |
|
token_id | Token ID (usually numeric) of the NFT on its contract. Will be |
|
name | Name of the NFT derived from its metadata |
|
description | Description of the NFT derived from its metadata |
|
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). These may be derived from images, videos, or 3D models. | { |
image_url | URL to cached image file on the SimpleHash CDN if available |
|
image_properties | Image properties if available | { |
video_url | URL to cached video file on the SimpleHash CDN if available |
|
video_properties | Video properties if available | { |
audio_url | URL to cached audio file on the SimpleHash CDN if available |
|
audio_properties | Audio properties if available | { |
model_url | URL to cached 3D model file on the SimpleHash CDN if available |
|
model_properties | Model properties if available | { |
other_url | URL to cached file on the SimpleHash CDN if available for other media types such as PDFs |
|
other_properties | File properties if available | { |
background_color | Background color of the NFT derived from its metadata |
|
external_url | External URL derived from the NFT's metadata, often with more information (such as about the project), where available |
|
created_date | NFT minting datetime if known in timestamp format (e.g., |
|
status | NFT status, one of |
|
token_count | Known quantity of this NFT |
|
owner_count | Known number of owners of this NFT |
|
owners | Array of 0-50 top owners of this NFT (sorted by quantity desc). Dates are supplied in the | [{ |
last_sale | Detail on the most recent sale involving this NFT | last_sale / |
primary_sale | Detail on the original sale (during the mint) for this NFT | primary_sale / |
first_created | First creation NFT details | { |
contract | Contract type info for this NFT (type is usually the standard for the contract, such as | { |
collection | The associated collection information for this NFT | |
rarity | The associated rarity information for this NFT | |
royalty | Array of 0 or more royalty details, by source. Different marketplaces allow for different royalty amounts, so we show a list of the available information. When there are multiple sources, we list them from highest to lowest Current sources are: The list of recipients can have 0 or more wallets, as applicable. Amounts are shown in both Note that for the recipients list, OpenSea natively uses | [{ |
extra_metadata | JSON field containing the additional custom metadata fields for the NFT added by the creator. Includes the | { |