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": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "token_id": "15",
    "contract_type": "ERC721",
    "owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    "block_number": "88256",
    "block_number_minted": "88256",
    "token_uri": "",
    "metadata": "",
    "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",
      "animation_url": "https://giphy.com/gifs/food-design-donuts-o9ngTPVYW4qo8",
      "attributes": [
        {
          "trait_type": "Eye Color",
          "display_type": "string",
          "max_value": 100,
          "trait_count": 7,
          "order": 1
        }
      ]
    },
    "amount": "1",
    "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"
  }
]

Get Multiple NFTs

Don't have an API key yet?