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"
    }
  }
]
Endpoint cost: CUs. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
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.