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} |