Skip to main content
GET
/
nft
/
{address}
Get NFTs by contract address
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/nft/{address} \
  --header 'X-API-Key: <api-key>'
{
  "result": [
    {
      "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"
    }
  ],
  "page": "2",
  "page_size": "100",
  "cursor": "<string>"
}
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:

"0x306b1ea3ecdf94aB739F1910bbda052Ed4A9f949"

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"

​
limit
integer

The desired page size of the result.

Required range: x >= 0
​
totalRanges
integer

The number of subranges to split the results into

Required range: x >= 1
​
range
integer

The desired subrange to query

Required range: x >= 1
​
cursor
string

The cursor returned in the previous response (used for getting the next page).

​
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 a collection of NFTs

​
result
object[]
required
​
page
integer

The current page of the result

Example:

"2"

​
page_size
integer

The number of results per page

Example:

"100"

​
cursor
string

The cursor to get to the next page