getNFTsForCollection - NFT API

Queries NFT high-level collection/contract level information

This endpoint is supported only on the following chains and networks:

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

Parameters

  • contractAddress: [string hexadecimal] - contract address for the NFT collection
  • page [number] page number
  • limit [number] max number of results Max limit 200

Returns

  • address: [string hexadecimal] contract address for the queried NFT collection
  • id: [object]
    • tokenId:[string]
    • tokenMetadata
      • tokenType [string] "CRC-721" or "ERC-721" NFT token type
  • title:[string]
  • description:[string]
  • tokenUri: [object]
    • raw: [string]
    • gateway: [string]
  • contractMetadata: [object]
    • name: [string] NFT contract name
    • description: [string] NFT description
    • image: [string] storage
  • timeLastUpdated: [string]

NOTE:


Example

Conflux Core

Request

curl 'https://cfx-core.unifra.io/v1/cf455a9802364d88b8f87b5273d9ddbb/nft-api/getNFTsForCollection?contractAddress=cfx:acff8dvjv6pys2ws19dhx753h1h00sum6yhu3m188h&page=1&limit=1'

Response


{
    "nfts": [
        {
            "contract": {
                "address": "cfx:acff8dvjv6pys2ws19dhx753h1h00sum6yhu3m188h"
            },
            "id": {
                "tokenId": "0x0000000000000000000000000000000000000000000000000000000000001001",
                "tokenMetadata": {
                    "tokenType": "CRC-721"
                }
            },
            "tokenUri": {
                "raw": "https://nft.taopainft.com/v1/token/metadata/8a5f0e288f1947624ebfc679f7793dcf6b3a0ae5/0000000000000000000000000000000000000000000000000000000000001001.json",
                "gateway": "https://nft.taopainft.com/v1/token/metadata/8a5f0e288f1947624ebfc679f7793dcf6b3a0ae5/0000000000000000000000000000000000000000000000000000000000001001.json"
            },
            "timeLastUpdated": "2022-09-23T08:58:13.144172Z"
        }
    ],
    "totalCount": 39018
}

Conflux eSpace

Request

curl 'https://cfx-espace.unifra.io/v1/4bd2d1249e644ae288dbfd4e076f0141/nft-api/getNFTsForCollection?contractAddress=0x324021590bbdd427f104953bb06999d55f230c64&page=1&limit=1'

Response

{
    "nfts": [
        {
            "contract": {
                "address": "0x324021590bbdd427f104953bb06999d55f230c64"
            },
            "id": {
                "tokenId": "0x0000000000000000000000000000000000000000000000000000000000000010",
                "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:10.523619Z"
        }
      ,,,
    ],
    "totalCount": 140259
}

Language
URL
Click Try It! to start a request and see the response here!