Skip to main content
GET
/
nft
/
{address}
/
{token_id}
Get NFT metadata
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/nft/{address}/{token_id} \
  --header 'X-API-Key: <api-key>'
{
  "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
  "token_id": "15",
  "contract_type": "ERC721",
  "name": "CryptoKitties",
  "symbol": "RARI",
  "possible_spam": "false",
  "owner_of": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b",
  "token_hash": "502cee781b0fb40ea02508b21d319ced",
  "block_number": "88256",
  "block_number_minted": "88256",
  "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>",
    "category": "image",
    "status": "success",
    "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>"
      }
    }
  },
  "minter_address": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b",
  "last_token_uri_sync": "<string>",
  "last_metadata_sync": "<string>",
  "amount": "1",
  "verified_collection": "false",
  "rarity_rank": 21669,
  "rarity_percentage": 98,
  "rarity_label": "Top 98%",
  "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"
  },
  "list_price": {
    "listed": true,
    "price": "27008",
    "price_currency": "eth",
    "price_usd": "13.61",
    "marketplace": "opensea"
  },
  "floor_price": "12345",
  "floor_price_usd": "12345.4899",
  "floor_price_currency": "eth"
}
Endpoint cost: CUs. Learn more about compute units.

Authorizations

X-API-Key
string
header
default:test
required

Path Parameters

address
string
required

The address of the NFT contract

Example:

"0x524cab2ec69124574082676e6f654a18df49a048"

token_id
string
required

The ID of the token

Example:

"1"

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"

format
enum<string>
default:decimal

The format of the token ID

Available options:
decimal,
hex
Example:

"decimal"

normalizeMetadata
boolean
default:true

Should normalized metadata be returned?

media_items
boolean
default:false

Should preview media data be returned?

include_prices
boolean
default:false

Should NFT last sale prices be included in the result?

Response

200 - application/json

Returns the specified NFT.

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"

name
string
required

The name of the NFT contract

Example:

"CryptoKitties"

symbol
string
required

The symbol of the NFT contract

Example:

"RARI"

possible_spam
boolean
required

Indicates if a contract is possibly a spam contract

Example:

"false"

owner_of
string

The wallet address of the owner of the NFT

Example:

"0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b"

token_hash
string

The token hash

Example:

"502cee781b0fb40ea02508b21d319ced"

block_number
string

The block number when the amount or owner changed

Example:

"88256"

block_number_minted
string

The block number when the NFT was minted

Example:

"88256"

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

minter_address
string

The address that minted the NFT

Example:

"0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b"

last_token_uri_sync
string

When the token_uri was last updated

last_metadata_sync
string

When the metadata was last updated

amount
string

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

Example:

"1"

verified_collection
boolean

Indicates if a contract is verified

Example:

"false"

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%"

last_sale
object

Details about the most recent sale involving this token.

list_price
object
floor_price
string

The floor price of collection the NFT belongs to

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"