Nft service

The NFT API provides endpoints for managing and retrieving NFTs (Non-Fungible Tokens). You can retrieve a list of requested NFTs, retrieve specific NFTs by address and ID, and access user-specific NFTs such as created, mobile, liked, and wished tokens.

Swagger docs link:

https://api.metaproprotocol.com/ms/nft/docs/#/

NFT

---

Returns a Nft

GET..//v1/tokens/{address}/id/{id}

Path parameters

address*string

id*number

Response

200400404

Body

application/json

address*string

createdBy*string

contractAddress*string

standard*enum

erc1155erc721

protocol*string

network*enum

bnb-chainethereumpolygon

chainId*number

creationBlock*number

version*number

isListed*boolean

isAsset*boolean

createdAt*string (date-time)

token*NftToken (object)

Request

JavaScriptCurl

const response = await fetch('..//v1/tokens/{address}/id/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "standard": "erc1155",
  "protocol": "text",
  "network": "bnb-chain",
  "chainId": 56,
  "creationBlock": 18504697,
  "version": 2,
  "isListed": true,
  "isAsset": true,
  "createdAt": "2022-05-25T16:17:01.797Z",
  "token": {
    "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
    "_tokenId": 1,
    "creationBlock": 21592868,
    "_quantity": 20,
    "image": "http://image.com",
    "description": "My description",
    "tokenName": "Best token name",
    "burn": false,
    "symbol": "NFT-Symbol",
    "properties": {
      "item_experience": [
        {
          "key": "asset_size",
          "value": 123,
          "value_type": "integer"
        }
      ],
      "common": {
        "standard": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "2d_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "3d_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "sound_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ]
      }
    },
    "favorites": 20,
    "wishes": 20,
    "isBlacklisted": false,
    "extraFiles": [
      "https://extra-file.com/file1"
    ],
    "minifiedImage": "https://extra-file.com/file1",
    "createdAt": "2022-05-25T16:17:01.797Z",
    "updatedAt": "2022-05-25T16:17:01.797Z"
  }
}

User NFTs

---

Returns user created Nft tokens

GET..//v1/user/{address}/tokens/created

Path parameters

address*string

Query parameters

Response

200400404

Body

application/json

results*array of Nft (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/user/{address}/tokens/created', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      }
    }
  ],
  "count": 0
}

Returns user Nft tokens

GET..//v1/user/{address}/tokens/mobile

Path parameters

address*string

Query parameters

Response

200400404

Body

application/json

address*string

createdBy*string

contractAddress*string

standard*enum

erc1155erc721

protocol*string

network*enum

bnb-chainethereumpolygon

chainId*number

creationBlock*number

version*number

isListed*boolean

isAsset*boolean

createdAt*string (date-time)

token*NftToken (object)

Request

JavaScriptCurl

const response = await fetch('..//v1/user/{address}/tokens/mobile', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "standard": "erc1155",
    "protocol": "text",
    "network": "bnb-chain",
    "chainId": 56,
    "creationBlock": 18504697,
    "version": 2,
    "isListed": true,
    "isAsset": true,
    "createdAt": "2022-05-25T16:17:01.797Z",
    "token": {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
      "_tokenId": 1,
      "creationBlock": 21592868,
      "_quantity": 20,
      "image": "http://image.com",
      "description": "My description",
      "tokenName": "Best token name",
      "burn": false,
      "symbol": "NFT-Symbol",
      "properties": {
        "item_experience": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "common": {
          "standard": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "2d_spec": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "3d_spec": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "sound_spec": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ]
        }
      },
      "favorites": 20,
      "wishes": 20,
      "isBlacklisted": false,
      "extraFiles": [
        "https://extra-file.com/file1"
      ],
      "minifiedImage": "https://extra-file.com/file1",
      "createdAt": "2022-05-25T16:17:01.797Z",
      "updatedAt": "2022-05-25T16:17:01.797Z"
    }
  }
]

Returns user Nft tokens

GET..//v1/user/{address}/tokens

Path parameters

address*string

Query parameters

Response

200400404

Body

application/json

results*array of Nft (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/user/{address}/tokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      }
    }
  ],
  "count": 0
}

Returns user's liked Nft tokens

GET..//v1/user/{address}/liked-tokens

Path parameters

address*string

Query parameters

Response

200400404

Body

application/json

results*array of ApiNftUserFavorite (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/user/{address}/liked-tokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      },
      "favorite": {
        "favoriteId": "c409b3ae-3f5e-4b75-9c1a-5e12f92d7717",
        "userId": "7793599f1e-434e-e879-dd1bdee0f524",
        "userAddress": "0xd1afbab5cacb45491ce002a6026c1401340eae6b",
        "type": "nfts",
        "tokenAddress": "0xd1afbab5cacb45491ce002a6026c1401340aaa45",
        "_tokenId": 451,
        "createdAt": "2022-08-12T14:21:28.449Z",
        "updatedAt": "2022-08-12T14:21:28.449Z"
      }
    }
  ],
  "count": 0
}

Returns user's wished Nft tokens

GET..//v1/user/{address}/wished-tokens

Path parameters

address*string

Query parameters

Response

200400404

Body

application/json

results*array of ApiNftUserWish (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/user/{address}/wished-tokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      },
      "wish": {
        "wishId": "c409b3ae-3f5e-4b75-9c1a-5e12f92d7717",
        "userId": "7793599f1e-434e-e879-dd1bdee0f524",
        "userAddress": "0xd1afbab5cacb45491ce002a6026c1401340eae6b",
        "type": "nfts",
        "tokenAddress": "0xd1afbab5cacb45491ce002a6026c1401340aaa45",
        "_tokenId": 451,
        "createdAt": "2022-08-12T14:21:28.449Z",
        "updatedAt": "2022-08-12T14:21:28.449Z"
      }
    }
  ],
  "count": 0
}

Internal NFTs

The Internal API offers endpoints for internal purposes related to NFTs. You can retrieve a list of requested NFTs with rich data and access specific NFTs by address and ID with rich data.

---

Returns a list of requested Nft

GET..//v1/internal/tokens/rich

Authorization

Authorization

Query parameters

Header parameters

Response

200400401403404

Body

application/json

results*array of Nft (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/internal/tokens/rich', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      }
    }
  ],
  "count": 0
}

Returns a Nft

GET..//v1/internal/tokens/{address}/id/{id}/rich

Authorization

Authorization

Path parameters

address*string

id*number

Header parameters

Response

200400401403404

Body

application/json

address*string

createdBy*string

contractAddress*string

standard*enum

erc1155erc721

protocol*string

network*enum

bnb-chainethereumpolygon

chainId*number

creationBlock*number

version*number

isListed*boolean

isAsset*boolean

createdAt*string (date-time)

token*NftToken (object)

Request

JavaScriptCurl

const response = await fetch('..//v1/internal/tokens/{address}/id/{id}/rich', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
  "standard": "erc1155",
  "protocol": "text",
  "network": "bnb-chain",
  "chainId": 56,
  "creationBlock": 18504697,
  "version": 2,
  "isListed": true,
  "isAsset": true,
  "createdAt": "2022-05-25T16:17:01.797Z",
  "token": {
    "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
    "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
    "_tokenId": 1,
    "creationBlock": 21592868,
    "_quantity": 20,
    "image": "http://image.com",
    "description": "My description",
    "tokenName": "Best token name",
    "burn": false,
    "symbol": "NFT-Symbol",
    "properties": {
      "item_experience": [
        {
          "key": "asset_size",
          "value": 123,
          "value_type": "integer"
        }
      ],
      "common": {
        "standard": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "2d_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "3d_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ],
        "sound_spec": [
          {
            "key": "asset_size",
            "value": 123,
            "value_type": "integer"
          }
        ]
      }
    },
    "favorites": 20,
    "wishes": 20,
    "isBlacklisted": false,
    "extraFiles": [
      "https://extra-file.com/file1"
    ],
    "minifiedImage": "https://extra-file.com/file1",
    "createdAt": "2022-05-25T16:17:01.797Z",
    "updatedAt": "2022-05-25T16:17:01.797Z"
  }
}

Owners

The Owners API allows you to retrieve a list of owners associated with a specific NFT token by address and ID.

---

Returns a list of owners

GET..//v1/owners/{address}/id/{_tokenId}

Path parameters

address*string

_tokenId*number

Query parameters

Response

200400404

Body

application/json

results*array of NftOwner (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/owners/{address}/id/{_tokenId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "_tokenId": 20,
      "_quantity": 20,
      "userId": "text",
      "socialMedia": [],
      "createdAt": "2022-05-25T16:17:01.797Z",
      "updatedAt": "2022-05-25T16:17:01.797Z"
    }
  ],
  "count": 0
}

Minting Status

The Minting Status API enables you to check the minting status of a specific NFT token by address and ID.

---

Returns a token minting status

GET..//v1/minting-status/{address}/id/{_tokenId}

Path parameters

address*string

_tokenId*number

Response

200400404

Body

application/json

enum

[object Object]

Request

JavaScriptCurl

const response = await fetch('..//v1/minting-status/{address}/id/{_tokenId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "PENDING": "pending",
  "OK": "ok",
  "ERROR": "error"
}

NFT Tags

The Tags API allows you to create tags for categorizing and organizing NFTs within your application. You can create tags and retrieve a list of requested tags.

---

Returns a list of requested tags

GET..//v1/tags

Query parameters

Response

200400404

Body

application/json

results*array of Tag (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/tags', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "name": "Witcher",
      "tagId": 55,
      "usage": 2,
      "createdAt": "2022-08-12T14:21:28.449Z",
      "updatedAt": "2022-08-12T14:21:28.449Z"
    }
  ],
  "count": 0
}

Create Tag

POST..//v1/tags

Authorization

Authorization

Header parameters

Body

application/json

tagName*string

Response

201400401403404

Body

application/json

name*string

tagId*number

usage*number

createdAt*string (date-time)

updatedAt*string (date-time)

Request

JavaScriptCurl

const response = await fetch('..//v1/tags', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tagName": "text"
    }),
});
const data = await response.json();

Response

{
  "name": "Witcher",
  "tagId": 55,
  "usage": 2,
  "createdAt": "2022-08-12T14:21:28.449Z",
  "updatedAt": "2022-08-12T14:21:28.449Z"
}

NFT Categories

The Categories API provides endpoints for retrieving a list of requested categories for classifying NFTs.

---

Returns a list of requested categories

GET..//v1/categories

Query parameters

Response

200400404

Body

application/json

results*array of Category (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/categories', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "name": "Real estate",
      "categoryId": 55,
      "parentId": 55,
      "usage": 1,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "updatedAt": "2022-05-25T16:17:01.797Z"
    }
  ],
  "count": 0
}

NFT Search

The Search API allows you to search for NFTs based on specific search criteria. You can retrieve a list of requested NFTs matching the search text, facilitating efficient discovery of relevant NFTs.

---

Returns a list of requested Nft

GET..//v1/nft-search/{searchText}

Path parameters

searchText*string

Query parameters

Response

200400404

Body

application/json

results*array of Nft (object)

count*number

Request

JavaScriptCurl

const response = await fetch('..//v1/nft-search/{searchText}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "results": [
    {
      "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "contractAddress": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
      "standard": "erc1155",
      "protocol": "text",
      "network": "bnb-chain",
      "chainId": 56,
      "creationBlock": 18504697,
      "version": 2,
      "isListed": true,
      "isAsset": true,
      "createdAt": "2022-05-25T16:17:01.797Z",
      "token": {
        "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "owner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "createdBy": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "initialOwner": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "_bucketHash": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
        "transactionHash": "0xad2d281e499c6349ac590eb77695852b2ccbc9e5251c3f0531ad6075c7e530b6",
        "_tokenId": 1,
        "creationBlock": 21592868,
        "_quantity": 20,
        "image": "http://image.com",
        "description": "My description",
        "tokenName": "Best token name",
        "burn": false,
        "symbol": "NFT-Symbol",
        "properties": {
          "item_experience": [
            {
              "key": "asset_size",
              "value": 123,
              "value_type": "integer"
            }
          ],
          "common": {
            "standard": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "2d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "3d_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ],
            "sound_spec": [
              {
                "key": "asset_size",
                "value": 123,
                "value_type": "integer"
              }
            ]
          }
        },
        "favorites": 20,
        "wishes": 20,
        "isBlacklisted": false,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      }
    }
  ],
  "count": 0
}