NFT Metadata (Batch)

Get Metadata for NFTs

curl --request POST \
  --url https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tokens": [
    {
      "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
      "token_id": "12"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "1"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "200"
    }
  ],
  "normalizeMetadata": false,
  "media_items": false
}
'

import requests

url = "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs"

payload = {
    "tokens": [
        {
            "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
            "token_id": "12"
        },
        {
            "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
            "token_id": "1"
        },
        {
            "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
            "token_id": "200"
        }
    ],
    "normalizeMetadata": False,
    "media_items": False
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tokens: [
      {token_address: '0xa4991609c508b6d4fb7156426db0bd49fe298bd8', token_id: '12'},
      {token_address: '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', token_id: '1'},
      {token_address: '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', token_id: '200'}
    ],
    normalizeMetadata: false,
    media_items: false
  })
};

fetch('https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tokens' => [
        [
                'token_address' => '0xa4991609c508b6d4fb7156426db0bd49fe298bd8',
                'token_id' => '12'
        ],
        [
                'token_address' => '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7',
                'token_id' => '1'
        ],
        [
                'token_address' => '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7',
                'token_id' => '200'
        ]
    ],
    'normalizeMetadata' => false,
    'media_items' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs"

	payload := strings.NewReader("{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}")

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

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}"

response = http.request(request)
puts response.read_body

[
  {
    "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "token_id": "15",
    "contract_type": "ERC721",
    "owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    "block_number": "88256",
    "block_number_minted": "88256",
    "name": "CryptoKitties",
    "symbol": "RARI",
    "token_hash": "502cee781b0fb40ea02508b21d319ced",
    "last_token_uri_sync": "2021-02-24T00:47:26.647Z",
    "last_metadata_sync": "2021-02-24T00:47:26.647Z",
    "possible_spam": "false",
    "token_uri": "<string>",
    "metadata": "<string>",
    "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",
      "external_url": "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": {
      "mimetype": "<string>",
      "original_media_url": "<string>",
      "updatedAt": "<string>",
      "parent_hash": "<string>",
      "media_collection": {
        "low": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "medium": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "high": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        }
      }
    },
    "amount": "1",
    "rarity_rank": 21669,
    "rarity_percentage": 98,
    "rarity_label": "Top 98%",
    "verified_collection": "false",
    "floor_price": "12345",
    "floor_price_usd": "12345.4899",
    "floor_price_currency": "eth",
    "last_sale": {
      "transaction_hash": "0x19e14f34b8f120c980f7ba05338d64c00384857fb9c561e2c56d0f575424a95c",
      "block_timestamp": "2023-04-04T15:59:11.000Z",
      "buyer_address": "0xcb1c1fde09f811b294172696404e88e658659905",
      "seller_address": "0x497a7dee2f13db161eb2fec060fa783cb041419f",
      "price": "7300000000000000",
      "price_formatted": "0.0073",
      "payment_token": {
        "token_name": "Ether",
        "token_symbol": "ETH",
        "token_logo": "https://cdn.moralis.io/eth/0x.png",
        "token_decimals": "18",
        "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      },
      "usd_price_at_sale": "13.61",
      "current_usd_value": "15.53",
      "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
      "token_id": "170"
    }
  }
]

POST

nft

getMultipleNFTs

Get Metadata for NFTs

curl --request POST \
  --url https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tokens": [
    {
      "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
      "token_id": "12"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "1"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "200"
    }
  ],
  "normalizeMetadata": false,
  "media_items": false
}
'

import requests

url = "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs"

payload = {
    "tokens": [
        {
            "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
            "token_id": "12"
        },
        {
            "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
            "token_id": "1"
        },
        {
            "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
            "token_id": "200"
        }
    ],
    "normalizeMetadata": False,
    "media_items": False
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    tokens: [
      {token_address: '0xa4991609c508b6d4fb7156426db0bd49fe298bd8', token_id: '12'},
      {token_address: '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', token_id: '1'},
      {token_address: '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7', token_id: '200'}
    ],
    normalizeMetadata: false,
    media_items: false
  })
};

fetch('https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'tokens' => [
        [
                'token_address' => '0xa4991609c508b6d4fb7156426db0bd49fe298bd8',
                'token_id' => '12'
        ],
        [
                'token_address' => '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7',
                'token_id' => '1'
        ],
        [
                'token_address' => '0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7',
                'token_id' => '200'
        ]
    ],
    'normalizeMetadata' => false,
    'media_items' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs"

	payload := strings.NewReader("{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}")

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

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"tokens\": [\n    {\n      \"token_address\": \"0xa4991609c508b6d4fb7156426db0bd49fe298bd8\",\n      \"token_id\": \"12\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"1\"\n    },\n    {\n      \"token_address\": \"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7\",\n      \"token_id\": \"200\"\n    }\n  ],\n  \"normalizeMetadata\": false,\n  \"media_items\": false\n}"

response = http.request(request)
puts response.read_body

[
  {
    "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "token_id": "15",
    "contract_type": "ERC721",
    "owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    "block_number": "88256",
    "block_number_minted": "88256",
    "name": "CryptoKitties",
    "symbol": "RARI",
    "token_hash": "502cee781b0fb40ea02508b21d319ced",
    "last_token_uri_sync": "2021-02-24T00:47:26.647Z",
    "last_metadata_sync": "2021-02-24T00:47:26.647Z",
    "possible_spam": "false",
    "token_uri": "<string>",
    "metadata": "<string>",
    "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",
      "external_url": "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": {
      "mimetype": "<string>",
      "original_media_url": "<string>",
      "updatedAt": "<string>",
      "parent_hash": "<string>",
      "media_collection": {
        "low": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "medium": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "high": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        }
      }
    },
    "amount": "1",
    "rarity_rank": 21669,
    "rarity_percentage": 98,
    "rarity_label": "Top 98%",
    "verified_collection": "false",
    "floor_price": "12345",
    "floor_price_usd": "12345.4899",
    "floor_price_currency": "eth",
    "last_sale": {
      "transaction_hash": "0x19e14f34b8f120c980f7ba05338d64c00384857fb9c561e2c56d0f575424a95c",
      "block_timestamp": "2023-04-04T15:59:11.000Z",
      "buyer_address": "0xcb1c1fde09f811b294172696404e88e658659905",
      "seller_address": "0x497a7dee2f13db161eb2fec060fa783cb041419f",
      "price": "7300000000000000",
      "price_formatted": "0.0073",
      "payment_token": {
        "token_name": "Ether",
        "token_symbol": "ETH",
        "token_logo": "https://cdn.moralis.io/eth/0x.png",
        "token_decimals": "18",
        "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      },
      "usd_price_at_sale": "13.61",
      "current_usd_value": "15.53",
      "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
      "token_id": "170"
    }
  }
]

Authorizations

X-API-Key

string

header

default:test

required

Query Parameters

chain

enum<string>

The chain to query

Available options:

eth,

0x1,

polygon,

0x89,

bsc,

0x38,

avalanche,

0xa86a,

cronos,

0x19,

arbitrum,

0xa4b1,

chiliz,

0x15b38,

gnosis,

0x64,

base,

0x2105,

optimism,

0xa,

linea,

0xe708,

moonbeam,

0x504,

moonriver,

0x505,

flow,

0x2eb,

ronin,

0x7e4,

lisk,

0x46f,

pulse,

0x171,

sei,

0x531,

monad,

0x8f

Body

application/json

Body

tokens

object[]

required

The tokens to be fetched (max 25 tokens)

Maximum array length: 25

Show child attributes

Example:

[
  {
    "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
    "token_id": "12"
  },
  {
    "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
    "token_id": "1"
  },
  {
    "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
    "token_id": "200"
  }
]

normalizeMetadata

boolean

Should normalized metadata be returned?

Example:

false

media_items

boolean

Should preview media data be returned?

Example:

false

Response

200 - application/json

Returns a collection of NFT owners

token_address

string

required

The address of the NFT contract

Example:

"0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB"

token_id

string

required

The token ID of the NFT

Example:

"15"

contract_type

string

required

The type of NFT contract standard

Example:

"ERC721"

owner_of

string

required

The wallet address of the owner of the NFT

Example:

"0x057Ec652A4F150f7FF94f089A38008f49a0DF88e"

block_number

string

required

The block number when the amount or owner changed

Example:

"88256"

block_number_minted

string

required

The block number when the NFT was minted

Example:

"88256"

name

string

required

The name of the NFT contract

Example:

"CryptoKitties"

symbol

string

required

The symbol of the NFT contract

Example:

"RARI"

token_hash

string

required

The token hash

Example:

"502cee781b0fb40ea02508b21d319ced"

last_token_uri_sync

string

required

When the token_uri was last updated

Example:

"2021-02-24T00:47:26.647Z"

last_metadata_sync

string

required

When the metadata was last updated

Example:

"2021-02-24T00:47:26.647Z"

possible_spam

boolean

required

Indicates if a contract is possibly a spam contract

Example:

"false"

token_uri

string

The URI to the metadata of the token

metadata

string

The metadata of the token

normalized_metadata

object

A normalized metadata version of the NFT's metadata.

Show child attributes

media

object

A set of links to 'thumbnail / preview' media files

Show child attributes

amount

string

The number of this item the user owns (used by ERC1155)

Example:

"1"

rarity_rank

number

The rarity rank

Example:

21669

rarity_percentage

number

The rarity percentage

Example:

98

rarity_label

string

The rarity label

Example:

"Top 98%"

verified_collection

boolean

Indicates if a contract is verified

Example:

"false"

floor_price

string

The floor price of the NFT

Example:

"12345"

floor_price_usd

string

The floor price of the NFT in USD

Example:

"12345.4899"

floor_price_currency

string

The currency of the floor price

Example:

"eth"

last_sale

object | null

Details about the most recent sale involving this token.

Show child attributes

NFT Metadata Collection Metadata

⌘I