Get Metadata for Multiple NFT Contracts

POSThttps://deep-index.moralis.io/api/v2.2/nft/metadata

Get the collection / contract level metadata for a given list of contract addresses (name, symbol). Supports batching up to 25 addresses.

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

QUERY PARAMS

chainstring

The chain to query

eth0x1sepolia0xaa36a7holesky0x4268polygon0x89polygon amoy0x13882bsc0x38bsc testnet0x61avalanche0xa86afantom0xfacronos0x19arbitrum0xa4b1gnosis0x64gnosis testnet0x27d8chiliz0x15b38chiliz testnet0x15b32base0x2105base sepolia0x14a34optimism0xalinea0xe708linea sepolia0xe705moonbeam0x504moonriver0x505moonbase0x507flow0x2ebflow-testnet0x221ronin0x7e4ronin-testnet0x7e5lisk0x46flisk-sepolia0x106a

include_pricesboolean

Should NFT last sale prices be included in the result?

falsetrue

BODY PARAM

jsonrequired

Body

{"addresses":["0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"]}

Responses

API KEY

Node.js

import Moralis from 'moralis';

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

  const response = await Moralis.EvmApi.nft.getNFTBulkContractMetadata({
    "chain": "0x1",
    "addresses": [
      "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
    ]
  });

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

Python

from moralis import evm_api

api_key = "YOUR_API_KEY"

params = {
  "chain": "eth"
}

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

print(result)

cURL

curl --request POST \
     --url 'https://deep-index.moralis.io/api/v2.2/nft/metadata?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "addresses": [
    "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
  ]
}
'

Go

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/nft/metadata?chain=eth"

  payload := strings.NewReader("{\"addresses\":[\"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d\"]}")

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

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "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

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

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://deep-index.moralis.io/api/v2.2/nft/metadata?chain=eth', [
  'body' => '{"addresses":["0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"]}',
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the metadata for the requested NFT collections.

[
  {
    "token_address": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
    "name": "KryptoKitties",
    "synced_at": "string",
    "symbol": "RARI",
    "contract_type": "ERC721",
    "possible_spam": "",
    "verified_collection": "",
    "collection_logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "collection_banner_image": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "collection_category": "Art",
    "project_url": "https://www.cryptokitties.co/",
    "wiki_url": "https://en.wikipedia.org/wiki/CryptoKitties",
    "discord_url": "https://discord.com/invite/cryptokitties",
    "telegram_url": "https://t.me/cryptokitties",
    "twitter_username": "CryptoKitties",
    "instagram_username": "cryptokitties"
  }
]