v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

NFT API

Get token metadata

/v4/data/metadata

10 credits per API call

> 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/metadata. Users can refer to GET /v4/data/metadata for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.

Get metadata of NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) by IDs for a given token address! Our API lets you search for all tokens on:

Ethereum - ethereum-mainnet / ethereum-sepolia
Base - base-mainnet / base-sepolia
Arbitrum - arb-one-mainnet / arb-testnet
BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet
Polygon - polygon-mainnet
Optimism - optimism-mainnet / optimism-testnet
Berachain - berachain-mainnet
Unichain - unichain-mainnet / unichain-sepolia
Monad - monad-testnet
Celo - celo-mainnet / celo-testnet
Chiliz - chiliz-mainnet
Avalanche - avax-mainnet / avax-testnet
Gnosis - gno-mainnet / gno-testnet
zkSync - zksync-mainnet / zksync-testnet
Rootstock - rsk-mainnet / rsk-testnet

To get started:

Provide a chain name, token address and comma-separated list of IDs. Our API will return relevant metadata about each specified token, including its name, description, image, and more.
Aside from the metadata information, the response also contains token types and metadata url minted in each token.

get/v4/data/metadata

Query parameters

Example:ethereum-mainnet

The blockchain to work with.

tokenAddressstring required

Contract address of the token.

Example:0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623

The blockchain address of the NFT to get metadata for.

tokenIdsstring uint256 required

IDs of the token.

Example:3,4

The IDs of the tokens to get metadata for. It is possible to enter list of multiple IDs as a comma separated string.

Response

chainstring

Name of the chain.

tokenIdstring uint256

ID of the token.

tokenAddressstring

Contract address of the token.

tokenType'native' | 'fungible' | 'nft' | 'multitoken'

Enum representing the type of token.

metadataURIstring

Metadata URL of the token. This data doesn't have to be present. The safest way to obtain them in that case is from the NFT Contract.tokenURI() method call.

metadataNftMetadata

Metadata scheme obtained from the url. This data don't have to be present. The safest way to obtain them in that case is from the NFT Contract.tokenURI() method call.

Example response

[
  {
    "chain": "ethereum",
    "tokenId": "3",
    "tokenAddress": "0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623",
    "tokenType": "nft",
    "metadataURI": "ipfs://QmTDcCdt3yb6mZitzWBmQr65AW6Wska295Dg9nbEYpSUDR/3",
    "metadata": {
      "image": "ipfs://QmamEqaaVttv9AvfgM4Wa7d9Ettonep1NBQSDCtM7THUSX",
      "attributes": [
        {
          "trait_type": "Background",
          "value": "Club Exterior"
        },
        {
          "trait_type": "Fur",
          "value": "Radioactive"
        },
        {
          "trait_type": "Back",
          "value": "Beer Kegs"
        },
        {
          "trait_type": "Mouth",
          "value": "Goofball"
        },
        {
          "trait_type": "Eyes",
          "value": "Closed"
        }
      ]
    }
  }
]