Get Multiple NFTs

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

Get NFT metadata for one or many NFTs. Accepts an array of up to 25 tokens, each requiring token_address and token_id. Each NFT returned includes on-chain metadata as well as off-chain metadata, floor prices, rarity and more where available.

QUERY PARAMS

chainstring

The chain to query

eth0x1sepolia0xaa36a7polygon0x89bsc0x38bsc testnet0x61avalanche0xa86afantom0xfacronos0x19arbitrum0xa4b1chiliz0x15b38chiliz testnet0x15b32gnosis0x64gnosis testnet0x27d8base0x2105base sepolia0x14a34optimism0xapolygon amoy0x13882linea0xe708moonbeam0x504moonriver0x505moonbase0x507linea sepolia0xe705flow0x2ebflow-testnet0x221ronin0x7e4ronin-testnet0x7e5lisk0x46flisk-sepolia0x106apulse0x171sei-testnet0x530sei0x531monad0x8f

BODY PARAM

Request Bodyobjectrequired

Body

{ "tokens": [ { "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8", "token_id": "12" }, { "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7", "token_id": "1" }, { "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7", "token_id": "200" } ], "normalizeMetadata": false, "media_items": false }

Responses

200Returns a collection of NFT owners

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

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": false
}
'

Node.js

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

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    "tokens": [
      {
        "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
        "token_id": "12"
      },
      {
        "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
        "token_id": "1"
      },
      {
        "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
        "token_id": "200"
      }
    ],
    "normalizeMetadata": false,
    "media_items": false
  })
};

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

Python

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

import requests

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

payload = {
  "tokens": [
    {
      "token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
      "token_id": "12"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "1"
    },
    {
      "token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
      "token_id": "200"
    }
  ],
  "normalizeMetadata": false,
  "media_items": false
}
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

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

print(response.text)

Go

package main

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

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\":false}")

  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, _ := io.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/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":false}',
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns a collection of NFT owners

[
  {
    "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",
      "external_url": "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
        }
      ]
    },
    "media": {
      "mimetype": "",
      "category": "",
      "status": "",
      "original_media_url": "",
      "updatedAt": "",
      "parent_hash": "",
      "media_collection": {
        "low": {
          "width": "",
          "height": "",
          "url": ""
        },
        "medium": {
          "width": "",
          "height": "",
          "url": ""
        },
        "high": {
          "width": "",
          "height": "",
          "url": ""
        }
      }
    },
    "amount": "1",
    "name": "CryptoKitties",
    "symbol": "RARI",
    "token_hash": "502cee781b0fb40ea02508b21d319ced",
    "rarity_rank": 21669,
    "rarity_percentage": 98,
    "rarity_label": "Top 98%",
    "last_token_uri_sync": "2021-02-24T00:47:26.647Z",
    "last_metadata_sync": "2021-02-24T00:47:26.647Z",
    "possible_spam": "false",
    "verified_collection": "false",
    "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"
    }
  }
]