---
title: "Get NFT metadata"
method: GET
path: "/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}"
tags: ["NFT (ERC-721 or compatible)"]
---

# Get NFT metadata

`GET /v3/nft/metadata/{chain}/{contractAddress}/{tokenId}`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}`
- Auth: API key in header `x-api-key`

/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}

**1 credit per API call**

Get metadata of an NFT.

This API is supported for the following blockchains:

*   Algorand
*   BNB Smart Chain
*   Celo
*   Ethereum
*   Harmony
*   Klaytn
*   KuCoin Community Chain
*   Polygon
*   Solana
*   TRON
*   Flare
*   Cronos
*   Base
*   Avalanche
*   Fantom
*   Optimism

## Path parameters

- `chain` 'BSC' | 'CELO' | 'ETH' | 'KCS' | 'KLAY' | 'MATIC' | 'ONE' | 'SOL' | 'TRON' | 'ALGO' | 'FLR' | 'CRO' | 'BASE' | 'AVAX' | 'FTM' | 'OPTIMISM', required
- `contractAddress` string, required
- `tokenId` string, uint256, required

## Query parameters

- `testnetType` 'ethereum-sepolia' | 'flare-coston' | 'flare-coston2' | 'flare-songbird': Specifies the testnet type. The default is ethereum-sepolia for Ethereum (ETH) currency and flare-coston for Flare (FLR) currency. Valid testnet types depend on the specified currency.

## Headers

- `x-testnet-type` Schema (unresolved $ref)

## Response `200`

OK

- union
  - NftMetadataErc721
    - `data` string: Metadata associated with token.
  - NftMetadataErc721OnchainSolana
    - `onchainData` object: (Solana) Metadata associated with token.
      - `name` string
      - `symbol` string
      - `uri` string
  - NftMetadataErc721OnchainAlgo
    - `onchainData` string: (ALGO) Metadata associated with token.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/smart-contracts.md) - [All operations](https://skmtc.dev/tatum/apis/smart-contracts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/smart-contracts/revisions/c0146043bb37?raw)