Get Multiple NFTs

POSThttps://deep-index.moralis.io/api/v2/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

eth0x1goerli0x5sepolia0xaa36a7polygon0x89mumbai0x13881bsc0x38bsc testnet0x61avalanche0xa86afantom0xfapalm0x2a15c308dcronos0x19arbitrum0xa4b1

BODY PARAM

tokensarrayrequired

The tokens to be fetched (max 25 tokens)

normalizeMetadataboolean

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

falsetrue

media_itemsboolean

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

falsetrue

Responses

200 Returns a collection of NFTsarray

token_addressstringrequired

The address of the NFT contract

token_idstringrequired

The token ID of the NFT

contract_typestringrequired

The type of NFT contract standard

owner_ofstringrequired

The wallet address of the owner of the NFT

block_numberstringrequired

The block number when the amount or owner changed

block_number_mintedstringrequired

The block number when the NFT was minted

token_uristring

The URI to the metadata of the token

metadatastring

The metadata of the token

normalized_metadata

A normalized metadata version of the NFT's metadata.

namestring

The name or title of the NFT

descriptionstring

A detailed description of the NFT

imagestring

The URL of the NFT's image

external_linkstring

A link to additional information

animation_urlstring

An animated version of the NFT's image

attributesarray

trait_typestring

The trait title or descriptor

value

The value of the attribute

display_typestring

The type the attribute value should be displayed as

max_valuenumber

For numeric values, the upper range

trait_countnumber

The number of possible values for this trait

ordernumber

Order the trait should appear in the attribute list.

amountstring

The number of this item the user owns (used by ERC1155)

namestringrequired

The name of the NFT contract

symbolstringrequired

The symbol of the NFT contract

token_hashstringrequired

The token hash

last_token_uri_syncstringrequired

When the token_uri was last updated

last_metadata_syncstringrequired

When the metadata was last updated

API KEY

Node.js

import Moralis from 'moralis';

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

  const response = await Moralis.EvmApi.nft.getMultipleNFTs({
    "chain": "0x1"
  });

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

Python

from moralis import evm_api

api_key = "YOUR_API_KEY"

body = {
  "tokens": [],
  "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

curl --request POST \
     --url 'https://deep-index.moralis.io/api/v2/nft/getMultipleNFTs?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "normalizeMetadata": false,
  "media_items": true
}
'

Go

package main

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

func main() {

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

  payload := strings.NewReader("{\"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

<?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/nft/getMultipleNFTs?chain=eth', [
  'body' => '{"normalizeMetadata":false,"media_items":true}',
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns a collection of NFTs

[
  {
    "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "token_id": "15",
    "contract_type": "ERC721",
    "owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    "block_number": "88256",
    "block_number_minted": "88256",
    "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"
  }
]