Get Metadata for Multiple NFT Contracts

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

Retrieve metadata (name, symbol) for up to 25 NFT contracts in one call. Also returns off-chain metadata, floor prices and more where available.

QUERY PARAMS

chainstring

The chain to query

include_pricesboolean

Should NFT last sale prices be included in the result?

BODY PARAM

Request Bodyjsonrequired

Body

{}

Responses

200Returns the metadata for the requested NFT collections.

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL
Node.js
Python
Go
PHP

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' 

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

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

# Dependencies to install:
# $ python -m pip install requests

import requests

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

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("POST", url, headers=headers)

print(response.text)

package main

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

func main() {

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

  req, _ := http.NewRequest("POST", 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, _ := io.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('POST', 'https://deep-index.moralis.io/api/v2.2/nft/metadata?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

[
  {
    "token_address": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
    "name": "KryptoKitties",
    "synced_at": "",
    "symbol": "RARI",
    "contract_type": "ERC721",
    "possible_spam": "false",
    "verified_collection": "false",
    "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",
    "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",
      "usd_price_at_sale": "13.61",
      "current_usd_value": "15.53",
      "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
      "token_id": "170"
    }
  }
]

Don't have an API key yet?

Get Metadata for Multiple NFT Contracts