getNFTsForCollection - NFT API

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

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
}