Version: 2.2

Get Multiple NFTs

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

Returns an array of NFTs specified in the request.

Note that results will include all indexed NFTs
Any request that includes the token_address param will start the indexing process for that NFT collection the very first time it is requested.
Only 25 NFTs can be fetched in one API call.

QUERY PARAMS

chainstring

The chain to query

BODY PARAM

tokensarrayrequired

The tokens to be fetched (max 25 tokens)

tokens[0]

token_addressstring

The contract address

token_idstring

The id of the token

tokens[1]

token_addressstring

The contract address

token_idstring

The id of the token

tokens[2]

token_addressstring

The contract address

token_idstring

The id of the token

normalizeMetadataboolean

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

media_itemsboolean

Should preview media data be returned? Learn more about media items here.

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.getMultipleNFTs({
    "chain": "0x1",
    "tokens": [
      {
        "tokenAddress": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
        "tokenId": "12"
      },
      {
        "tokenAddress": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
        "tokenId": "1"
      },
      {
        "tokenAddress": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
        "tokenId": "200"
      }
    ]
  });

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

from moralis import evm_api

api_key = "YOUR_API_KEY"

body = {
  "tokens": [
    {
      "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
      "token_id": "12"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "1"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "200"
    }
  ],
  "media_items": True,
  "normalize_metadata": False
}

params = {
  "chain": "eth"
}

result = evm_api.nft.get_multiple_nfts(
  api_key=api_key,
  body=body,
  params=params,
)

print(result)

curl --request POST \
     --url 'https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "tokens": [
    {
      "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
      "token_id": "12"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "1"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "200"
    }
  ],
  "normalizeMetadata": false,
  "media_items": true
}
'

package main

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

func main() {

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

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

  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
// 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/getMultipleNFTs?chain=eth', [
  'body' => '{"tokens":[{"token_address":"0xa4991609c508b6d4fb7156426db0bd49fe298bd8","token_id":"12"},{"token_address":"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7","token_id":"1"},{"token_address":"0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7","token_id":"200"}],"normalizeMetadata":false,"media_items":true}',
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

[
  {
    "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
    "token_id": "12",
    "contract_type": "ERC721",
    "owner_of": "0x4de8d51b3f7439863868cc8418524db282c604f9",
    "block_number": "16076275",
    "block_number_minted": "16076275",
    "token_uri": "ipfs://QmfMD2ptdb2jMBgivvi64tyAtRPxH4m8XgpcgBrVAtS8Vd/1863.json",
    "metadata": "{\"description\":\"Dreamy is a central meeting place for all adventurers, where it all begins. Invoking the feelings of togetherness and familiarity, with a sense of tranquillity and calmness.\",\"image\":\"https://dreamy.mypinata.cloud/ipfs/QmVAsVNVBkmJpkNqsDXz65hf3x19KtZkGDBsJS9PjyDTKP/1863.png\",\"attributes\":[{\"trait_type\":\"Background\",\"value\":\"Autumn\"},{\"trait_type\":\"Skin\",\"value\":\"Human\"}]}",
    "normalized_metadata": {
      "name": "Dreamy #1863",
      "description": "Dreamy is a central meeting place for all adventurers, where it all begins. Invoking the feelings of togetherness and familiarity, with a sense of tranquillity and calmness. A place where there is no noise.",
      "image": "https://dreamy.mypinata.cloud/ipfs/QmVAsVNVBkmJpkNqsDXz65hf3x19KtZkGDBsJS9PjyDTKP/1863.png",
      "external_link": "https://dreamy.day/token/1863",
      "animation_url": "https://dreamy.mypinata.cloud/ipfs/QmVAsVNVBkmJpkNqsDXz65hf3x19KtZkGDBsJS9PjyDTKP/animation/1863.mp4",
      "attributes": [
        {
          "trait_type": "Background",
          "value": "Autumn",
          "display_type": "string",
          "max_value": 100,
          "trait_count": 7,
          "order": 1,
          "rarity_label": "Top 12% trait",
          "count": 648,
          "percentage": 11.67
        }
      ]
    },
    "amount": "1",
    "name": "Dreamy",
    "symbol": "DRMY",
    "token_hash": "560f2b25e17472857700fe257c9829eb",
    "minter_address": "0x88e83571fa2e76e05e3ab4ad38469290ef31b6f0",
    "rarity_rank": 345,
    "rarity_percentage": 6.21,
    "rarity_label": "Top 7%",
    "verified_collection": true,
    "possible_spam": "",
    "collection_logo": "https://i.seadn.io/gcs/files/41430968e84727ec2cbc2e41325f314e.png?w=500&auto=format",
    "collection_banner_image": "https://i.seadn.io/gcs/files/93fbc8c057b3ada3881445550f4f4ad5.png?w=500&auto=format",
    "collection_category": "pfps",
    "project_url": "https://dreamy.day",
    "wiki_url": "https://dreamy.wiki",
    "discord_url": "https://discord.gg/dreamy",
    "telegram_url": "https://t.me/dreamynft",
    "twitter_username": "dreamy",
    "instagram_username": "dreamy.nft",
    "list_price": {
      "listed": true,
      "price": "0.0075",
      "price_currency": "ETH",
      "price_usd": 13.58,
      "marketplace": "OpenSea"
    },
    "floor_price": "0.005399",
    "floor_price_usd": "9.772",
    "floor_price_currency": "eth",
    "last_token_uri_sync": "2025-02-12T09:29:03.902Z",
    "last_metadata_sync": "2025-02-12T09:30:43.918Z"
  }
]

Don't have an API key yet?

Get Multiple NFTs