getNFTMetadata - NFT API

get https://{network}.unifra.io/v1/{your-api-key}/nft-api/getNFTMetadata

Gets the metadata associated with a given NFT.

This endpoint is supported on the following chains and networks:

Conflux Core: cfx-core
Conflux eSpace: cfx-espace

Parameters

contractAddress: [string] address of NFT contract
tokenId: [integer or hexadecimal] Id for NFT

Returns

JSON Object containing the following fields and potentially more fields.
- contract: contract for returned NFT
  - address: address of NFT contract
- id
  - tokenId: Id for NFT (integer or hexadecimal, depending on parameter tokenId type)
  - tokenMetadata
    - tokenType: "CRC-721" or "CRC-1155" or "ERC-721" or "ERC-1155"
- tokenUri:
  - raw: Uri representing the location of the NFT's original metadata blob. This is a backup for you to parse when the metadata field is not automatically populated.
  - gateway: Public gateway uri for the raw uri above.
- metadata: Relevant metadata for NFT contract. This is useful for viewing image url, traits, etc. without having to follow the metadata url in tokenUri to parse manually.
  - nameName of the NFT asset.
  - description: Human-readable description of the NFT asset. (Markdown is supported/rendered on OpenSea and other NFT platforms)
  - image: URL to the NFT asset image. Can be standard URLs pointing to images on conventional servers, IPFS or Arweave. Most types of images (SVGs, PNGs, JPEGs, etc.) are supported by NFT marketplaces.
- timeLastUpdated: ISO timestamp of the last cache refresh for the information returned in the metadata field.

Example

Conflux Core

Request

curl 'https://cfx-core.unifra.io/v1/cf455a9802364d88b8f87b5273d9ddbb/nft-api/getNFTMetadata?contractAddress=cfx:acff8dvjv6pys2ws19dhx753h1h00sum6yhu3m188h&tokenId=0x2713'

Response

{
    "contract": {
        "address": "cfx:acff8dvjv6pys2ws19dhx753h1h00sum6yhu3m188h"
    },
    "id": {
        "tokenId": "10003",
        "tokenMetadata": {
            "tokenType": "CRC-721"
        }
    },
    "title": "敦煌57窟如意美女菩萨-红光",
    "description": "代表2022年，你将需要红色能量守护，敦煌57窟如意美女菩萨祝福你鸿运当头，有如神助般顺顺利",
    "tokenUri": {
        "raw": "https://nft.taopainft.com/v1/token/metadata/8a5f0e288f1947624ebfc679f7793dcf6b3a0ae5/2713.json",
        "gateway": "https://nft.taopainft.com/v1/token/metadata/8a5f0e288f1947624ebfc679f7793dcf6b3a0ae5/2713.json"
    },
    "metadata": {
        "name": "敦煌57窟如意美女菩萨-红光",
        "description": "代表2022年，你将需要红色能量守护，敦煌57窟如意美女菩萨祝福你鸿运当头，有如神助般顺顺利",
        "image": "https://taopainft.oss-cn-hangzhou.aliyuncs.com/%E4%B8%9D%E9%81%93%E5%A5%87%E5%8D%8Ecfx%3Aacff8dvjv6pys2ws19dhx753h1h00sum6yhu3m188h/%E8%A7%86%E9%A2%91%E6%A0%BC%E5%BC%8F%E4%BF%AE%E6%94%B90107/10001-14500_%E5%A6%82%E6%84%8F%E7%BE%8E%E5%A5%B3%E8%8F%A9%E8%90%A8-%E7%BA%A2%E5%85%89.mp4"
    },
    "timeLastUpdated": "2022-07-11T13:09:04.784001Z"
}

Conflux eSpace

Request

curl 'https://cfx-espace.unifra.io/v1/4bd2d1249e644ae288dbfd4e076f0141/nft-api/getNFTMetadata?contractAddress=0x324021590bbdd427f104953bb06999d55f230c64&tokenId=22059'

Response

{
    "contract": {
        "address": "0x324021590bbdd427f104953bb06999d55f230c64"
    },
    "id": {
        "tokenId": "0x000000000000000000000000000000000000000000000000000000000000562b",
        "tokenMetadata": {
            "tokenType": "ERC-721"
        }
    },
    "title": "HONG KONG DIRL PASS",
    "description": "A pass that connects ditital to IRL in Hong Kong. Check hongkongdirl.domin.foundation for more experiences.",
    "tokenUri": {
        "raw": "https://cdn.redreamer.review/HongKongDirlPass/metadata.json",
        "gateway": "https://cdn.redreamer.review/HongKongDirlPass/metadata.json"
    },
    "metadata": {
        "description": "A pass that connects ditital to IRL in Hong Kong. Check hongkongdirl.domin.foundation for more experiences.",
        "image": "https://cdn.redreamer.review/HongKongDirlPass/HKDP.webp",
        "name": "HONG KONG DIRL PASS"
    },
    "timeLastUpdated": "2024-04-16T12:08:21.904482Z"
}