Skip to main content
POST
/
nft
/
metadata
Get metadata for multiple NFT contracts
curl --request POST \
  --url https://deep-index.moralis.io/api/v2.2/nft/metadata \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "addresses": [
    "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
  ]
}
'
[
  {
    "token_address": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
    "name": "KryptoKitties",
    "symbol": "RARI",
    "contract_type": "ERC721",
    "possible_spam": "false",
    "verified_collection": "false",
    "synced_at": "<string>",
    "collection_logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "collection_banner_image": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
    "collection_category": "Art",
    "project_url": "https://www.cryptokitties.co/",
    "wiki_url": "https://en.wikipedia.org/wiki/CryptoKitties",
    "discord_url": "https://discord.com/invite/cryptokitties",
    "telegram_url": "https://t.me/cryptokitties",
    "twitter_username": "CryptoKitties",
    "instagram_username": "cryptokitties",
    "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
​
include_prices
boolean
default:false

Should NFT last sale prices be included in the result?

Body

application/json

Body

​
addresses
string[]
required
Required array length: 1 - 25 elements

Response

200 - application/json

Returns the metadata for the requested NFT collections.

​
token_address
string
required

The address of the token contract

Example:

"0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09"

​
name
string
required

The name of the token contract

Example:

"KryptoKitties"

​
symbol
string
required

The symbol of the NFT contract

Example:

"RARI"

​
contract_type
string
required

The type of NFT contract

Example:

"ERC721"

​
possible_spam
boolean
required

Indicates if a contract is possibly a spam contract

Example:

"false"

​
verified_collection
boolean
required

Indicates if a contract is verified

Example:

"false"

​
synced_at
string

Timestamp of when the contract was last synced with the node

The logo of the collection

Example:

"https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png"

​
collection_banner_image
string

The banner image of the collection

Example:

"https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png"

​
collection_category
string

The category of the collection

Example:

"Art"

​
project_url
string

The project url of the collection

Example:

"https://www.cryptokitties.co/"

​
wiki_url
string

The wiki url of the collection

Example:

"https://en.wikipedia.org/wiki/CryptoKitties"

​
discord_url
string

The discord url of the collection

Example:

"https://discord.com/invite/cryptokitties"

​
telegram_url
string

The telegram url of the collection

Example:

"https://t.me/cryptokitties"

​
twitter_username
string

The twitter username of the collection

Example:

"CryptoKitties"

​
instagram_username
string

The instagram username of the collection

Example:

"cryptokitties"

​
floor_price
string

The floor price of the contract

Example:

"12345"

​
floor_price_usd
string

The floor price of the contract 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.