Get NFT metadata

GEThttps://deep-index.moralis.io/api/v2/nft/:address/:token_id

Get NFT data, including metadata (where available), for the given NFT token ID and contract address.

Requests for contract addresses not yet indexed will automatically start the indexing process for that NFT collection

PATH PARAMS

addressstringrequired

The address of the NFT contract

token_idstringrequired

The ID of the token

QUERY PARAMS

chainstring

The chain to query

formatstring

The format of the token ID

normalizeMetadataboolean

The option to enable metadata normalization. Learn more about metadata normalization here.

media_itemsboolean

Should preview media data be returned?

Responses

API KEY

Node.js
Python
cURL
Go
PHP

import Moralis from 'moralis';

try {
  await Moralis.start({
    apiKey: "YOUR_API_KEY"
  });

  const response = await Moralis.EvmApi.nft.getNFTMetadata({
    "chain": "0x1",
    "format": "decimal",
    "mediaItems": false,
    "address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "tokenId": "1"
  });

  console.log(response.raw);
} catch (e) {
  console.error(e);
}

from moralis import evm_api

api_key = "YOUR_API_KEY"

params = {
  "chain": "eth",
  "format": "decimal",
  "media_items": false,
  "address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
  "token_id": "1"
}

result = evm_api.nft.get_nft_metadata(
  api_key=api_key,
  params=params,
)

print(result)

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth&format=decimal&media_items=false' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth&format=decimal&media_items=false"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth&format=decimal&media_items=false', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

{
  "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
  "token_id": "15",
  "owner_of": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b",
  "token_hash": "502cee781b0fb40ea02508b21d319ced",
  "block_number": "88256",
  "block_number_minted": "88256",
  "contract_type": "ERC721",
  "normalized_metadata": {
    "name": "Moralis Mug",
    "description": "Moralis Coffee nug 3D Asset that can be used in 3D worldspaces. This NFT is presented as a flat PNG, a Unity3D Prefab and a standard fbx.",
    "image": "https://arw2wxg84h6b.moralishost.com:2053/server/files/tNJatzsHirx4V2VAep6sc923OYGxvkpBeJttR7Ks/de504bbadadcbe30c86278342fcf2560_moralismug.png",
    "external_link": "https://giphy.com/gifs/loop-recursion-ting-aaODAv1iuQdgI",
    "animation_url": "https://giphy.com/gifs/food-design-donuts-o9ngTPVYW4qo8",
    "attributes": [
      {
        "trait_type": "Eye Color",
        "value": "hazel",
        "display_type": "string",
        "max_value": 100,
        "trait_count": 7,
        "order": 1
      }
    ]
  },
  "media": {
    "media_collection": {
      "original": {
        "width": "",
        "height": ""
      },
      "low": {
        "width": "",
        "height": ""
      },
      "medium": {
        "width": "",
        "height": ""
      },
      "high": {
        "width": "",
        "height": ""
      }
    }
  },
  "minter_address": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b",
  "amount": "1",
  "name": "CryptoKitties",
  "symbol": "RARI"
}