Skip to main content
POST
/
nft
/
getMultipleNFTs
Get Metadata for NFTs
curl --request POST \
  --url https://deep-index.moralis.io/api/v2.2/nft/getMultipleNFTs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --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
}
'
[
  {
    "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
    "token_id": "15",
    "contract_type": "ERC721",
    "owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
    "block_number": "88256",
    "block_number_minted": "88256",
    "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",
    "possible_spam": "false",
    "token_uri": "<string>",
    "metadata": "<string>",
    "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",
          "value": "hazel",
          "display_type": "string",
          "max_value": 100,
          "trait_count": 7,
          "order": 1
        }
      ]
    },
    "media": {
      "mimetype": "<string>",
      "original_media_url": "<string>",
      "updatedAt": "<string>",
      "parent_hash": "<string>",
      "media_collection": {
        "low": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "medium": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        },
        "high": {
          "width": 123,
          "height": 123,
          "url": "<string>"
        }
      }
    },
    "amount": "1",
    "rarity_rank": 21669,
    "rarity_percentage": 98,
    "rarity_label": "Top 98%",
    "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",
      "payment_token": {
        "token_name": "Ether",
        "token_symbol": "ETH",
        "token_logo": "https://cdn.moralis.io/eth/0x.png",
        "token_decimals": "18",
        "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
      },
      "usd_price_at_sale": "13.61",
      "current_usd_value": "15.53",
      "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17",
      "token_id": "170"
    }
  }
]

Authorizations

X-API-Key
string
header
default:test
required

Query Parameters

chain
enum<string>

The chain to query

Available options:
eth,
0x1,
polygon,
0x89,
bsc,
0x38,
avalanche,
0xa86a,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
gnosis,
0x64,
base,
0x2105,
optimism,
0xa,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
flow,
0x2eb,
ronin,
0x7e4,
lisk,
0x46f,
pulse,
0x171,
sei,
0x531,
monad,
0x8f

Body

application/json

Body

tokens
object[]
required

The tokens to be fetched (max 25 tokens)

Maximum array length: 25
Example:
[
{
"token_address": "0xa4991609c508b6d4fb7156426db0bd49fe298bd8",
"token_id": "12"
},
{
"token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
"token_id": "1"
},
{
"token_address": "0x3c64dc415ebb4690d1df2b6216148c8de6dd29f7",
"token_id": "200"
}
]
normalizeMetadata
boolean

Should normalized metadata be returned?

Example:

false

media_items
boolean

Should preview media data be returned?

Example:

false

Response

200 - application/json

Returns a collection of NFT owners

token_address
string
required

The address of the NFT contract

Example:

"0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB"

token_id
string
required

The token ID of the NFT

Example:

"15"

contract_type
string
required

The type of NFT contract standard

Example:

"ERC721"

owner_of
string
required

The wallet address of the owner of the NFT

Example:

"0x057Ec652A4F150f7FF94f089A38008f49a0DF88e"

block_number
string
required

The block number when the amount or owner changed

Example:

"88256"

block_number_minted
string
required

The block number when the NFT was minted

Example:

"88256"

name
string
required

The name of the NFT contract

Example:

"CryptoKitties"

symbol
string
required

The symbol of the NFT contract

Example:

"RARI"

token_hash
string
required

The token hash

Example:

"502cee781b0fb40ea02508b21d319ced"

last_token_uri_sync
string
required

When the token_uri was last updated

Example:

"2021-02-24T00:47:26.647Z"

last_metadata_sync
string
required

When the metadata was last updated

Example:

"2021-02-24T00:47:26.647Z"

possible_spam
boolean
required

Indicates if a contract is possibly a spam contract

Example:

"false"

token_uri
string

The URI to the metadata of the token

metadata
string

The metadata of the token

normalized_metadata
object

A normalized metadata version of the NFT's metadata.

media
object

A set of links to 'thumbnail / preview' media files

amount
string

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

Example:

"1"

rarity_rank
number

The rarity rank

Example:

21669

rarity_percentage
number

The rarity percentage

Example:

98

rarity_label
string

The rarity label

Example:

"Top 98%"

verified_collection
boolean

Indicates if a contract is verified

Example:

"false"

floor_price
string

The floor price of the NFT

Example:

"12345"

floor_price_usd
string

The floor price of the NFT in USD

Example:

"12345.4899"

floor_price_currency
string

The currency of the floor price

Example:

"eth"

last_sale
object

Details about the most recent sale involving this token.