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>",
      "category": "image",
      "status": "success",
      "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>",
      "category": "image",
      "status": "success",
      "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

Introduction

Data Features

EVM API

Solana API

Bitcoin API

Universal API

Onchain Skills

NFT Metadata (Batch)

Authorizations

Query Parameters

Body

Response