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) | 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. Will be null for Solana NFTs, which are identified by their mint address (contract_address ) | string / null |
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). These may be derived from images, videos, or 3D models. | {image_small_url :string / null ,image_medium_url :string / null ,image_large_url :string / null ,image_opengraph_url :string / null ,blurhash : string / 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 / null |
owner_count | Known number of owners of this NFT | int / null |
owners | Array of 0-50 top owners of this NFT (sorted by quantity desc). Dates are supplied in the yyyy-MM-dd'T'HH:mm:ss format | [{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 / null ,symbol :string / null } |
collection | The associated collection information for this NFT | Collection model |
rarity | The associated rarity information for this NFT | Rarity model |
extra_metadata | JSON field containing the additional custom metadata fields for the NFT added by the creator. Includes the image_original_url and animation_original_url links to the original media source (where available), and passes through other fields not standardized above (such as attributes or traits) | {... ,image_original_url :string / null ,animation_original_url :string / null } |