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

Path parameters

addressstring · min: 42 · max: 42RequiredExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

idnumberRequired

Responses

200Success

application/json

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/tokens/{address}/id/{id}

HTTPcURLJavaScriptPython

GET /v1/tokens/{address}/id/{id} HTTP/1.1
Accept: */*

{
  "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",
    "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": true,
    "extraFiles": [
      "https://extra-file.com/file1"
    ],
    "minifiedImage": "https://extra-file.com/file1",
    "standard": "erc1155",
    "protocol": "text",
    "network": "bnb-chain",
    "chainId": 1,
    "isAsset": true,
    "qrDescription": "Description for QR code",
    "createdAt": "2022-05-25T16:17:01.797Z",
    "updatedAt": "2022-05-25T16:17:01.797Z"
  },
  "name": "Metaprotocol Factory"
}

User NFTs

---

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

Authorizations

Authorization

AuthorizationstringRequired

Query parameters

skipnumberOptionalExample: 2

limitnumber · min: 1OptionalExample: 2

addressstring · min: 42 · max: 42OptionalExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

standardstring · enumOptionalPossible values:

protocolstring · min: 1 · max: 20Optional

networkstring · enumOptionalPossible values:

_tokenIdnumberOptionalExample: 1

creationBlocknumber · min: 1OptionalExample: 21592868

tokenNamestring · min: 3 · max: 100OptionalExample: Best token name

categoryIdnumber · min: 1OptionalExample: 55

tagIdnumber · min: 1OptionalExample: 55

categoryIdsnumber[] · min: 1Optional

tokenIdsnumber[]Optional

tagIdsnumber[] · min: 1Optional

asset_categorystring · min: 1 · max: 20Optional

asset_subcategoriesstring · min: 1 · max: 20Optional

asset_tagsstring · min: 1 · max: 20Optional

tokensstringOptional

Stringified array of tokens with chain ID (optional), contract address, and token ID

Example: [{"chainId":11155111,"contractAddress":"0x91945DCD15b44eB33dE4D00897843C1Ee524fA88","tokenId":3},{"chainId":80002,"contractAddress":"0x91945DCD15b44eB33dE4D00897843C1Ee524fA88","tokenId":1234}]

showBlacklistedbooleanOptional

contractAddressesstring[]Optional

protocolsstring[]Optional

excludeCollectionsbooleanOptional

Header parameters

AuthorizationstringRequired

asduf823hf-sa98ehf938rh

x-account-walletstringRequired

0xd1afbab5cacb45491ce002a6026c1401340eae6a

x-account-useridstringRequired

5a945f88-1de8cb-c6a1b4-1314ebac6bd1

Responses

200Success

application/json

400

Incorrect data requested

application/json

401

Unouthorized access!

application/json

403

Not allowed to process this request!

application/json

404

Entity not found

application/json

get

/v1/internal/tokens/rich

HTTPcURLJavaScriptPython

GET /v1/internal/tokens/rich HTTP/1.1
Authorization: text
x-account-wallet: text
x-account-userid: text
Accept: */*

{
  "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",
        "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": true,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "standard": "erc1155",
        "protocol": "text",
        "network": "bnb-chain",
        "chainId": 1,
        "isAsset": true,
        "qrDescription": "Description for QR code",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      },
      "name": "Metaprotocol Factory"
    }
  ],
  "count": 1
}

Returns a Nft

get

Authorizations

Authorization

AuthorizationstringRequired

Path parameters

addressstring · min: 42 · max: 42RequiredExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

idnumberRequired

chainIdnumberRequired

Header parameters

AuthorizationstringRequired

asduf823hf-sa98ehf938rh

x-account-walletstringRequired

0xd1afbab5cacb45491ce002a6026c1401340eae6a

x-account-useridstringRequired

5a945f88-1de8cb-c6a1b4-1314ebac6bd1

Responses

200Success

application/json

400

Incorrect data requested

application/json

401

Unouthorized access!

application/json

403

Not allowed to process this request!

application/json

404

Entity not found

application/json

get

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

HTTPcURLJavaScriptPython

GET /v1/internal/tokens/{address}/id/{id}/rich HTTP/1.1
Authorization: text
x-account-wallet: text
x-account-userid: text
Accept: */*

{
  "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",
    "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": true,
    "extraFiles": [
      "https://extra-file.com/file1"
    ],
    "minifiedImage": "https://extra-file.com/file1",
    "standard": "erc1155",
    "protocol": "text",
    "network": "bnb-chain",
    "chainId": 1,
    "isAsset": true,
    "qrDescription": "Description for QR code",
    "createdAt": "2022-05-25T16:17:01.797Z",
    "updatedAt": "2022-05-25T16:17:01.797Z"
  },
  "name": "Metaprotocol Factory"
}

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

Path parameters

addressstring · min: 42 · max: 42RequiredExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

_tokenIdnumberRequiredExample: 1

Query parameters

_tokenIdstring · enumOptional

Sort by..

Example: descPossible values:

createdAtstring · enumOptional

Sort by..

Example: descPossible values:

_quantitystring · enumOptional

Sort by..

Example: descPossible values:

skipnumberOptionalExample: 2

limitnumber · min: 1OptionalExample: 2

Responses

200Success

application/json

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

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

HTTPcURLJavaScriptPython

GET /v1/owners/{address}/id/{_tokenId} HTTP/1.1
Accept: */*

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

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

Path parameters

addressstring · min: 42 · max: 42RequiredExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

_tokenIdnumberRequiredExample: 1

Responses

200Success

application/json

Responseundefined · enumPossible values:

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

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

HTTPcURLJavaScriptPython

GET /v1/minting-status/{address}/id/{_tokenId} HTTP/1.1
Accept: */*

{
  "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

Query parameters

skipnumberOptionalExample: 2

limitnumber · min: 1OptionalExample: 2

usagenumber · min: 1OptionalExample: 1

tagIdsnumber[] · min: 1Optional

parentIdsnumber[] · min: 1Optional

tagNamestring · max: 20Optional

Responses

200Success

application/json

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/tags

HTTPcURLJavaScriptPython

GET /v1/tags HTTP/1.1
Accept: */*

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

Create Tag

post

Authorizations

Authorization

AuthorizationstringRequired

Header parameters

AuthorizationstringRequired

asduf823hf-sa98ehf938rh

x-account-walletstringRequired

0xd1afbab5cacb45491ce002a6026c1401340eae6a

x-account-useridstringRequired

5a945f88-1de8cb-c6a1b4-1314ebac6bd1

Body

application/json

tagNamestring · max: 20Required

Responses

201Success

application/json

400

Incorrect data requested

application/json

401

Unouthorized access!

application/json

403

Not allowed to process this request!

application/json

404

Entity not found

application/json

post

/v1/tags

HTTPcURLJavaScriptPython

POST /v1/tags HTTP/1.1
Authorization: text
x-account-wallet: text
x-account-userid: text
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "tagName": "text"
}

{
  "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

Query parameters

skipnumberOptionalExample: 2

limitnumber · min: 1OptionalExample: 2

usagenumber · min: 1OptionalExample: 1

categoryIdsnumber[] · min: 1Optional

parentIdsnumber[] · min: 1Optional

categoryNamestring · min: 2 · max: 20OptionalPattern: /^([-\w]+ )+[-\w]+$|^[-\w]+$/

Responses

200Success

application/json

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/categories

HTTPcURLJavaScriptPython

GET /v1/categories HTTP/1.1
Accept: */*

{
  "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": 1
}

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

Path parameters

searchTextstringRequired

Query parameters

skipnumberOptionalExample: 2

limitnumber · min: 1OptionalExample: 2

addressstring · min: 42 · max: 42OptionalExample: 0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377

Responses

200Success

application/json

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/nft-search/{searchText}

HTTPcURLJavaScriptPython

GET /v1/nft-search/{searchText} HTTP/1.1
Accept: */*

{
  "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",
        "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": true,
        "extraFiles": [
          "https://extra-file.com/file1"
        ],
        "minifiedImage": "https://extra-file.com/file1",
        "standard": "erc1155",
        "protocol": "text",
        "network": "bnb-chain",
        "chainId": 1,
        "isAsset": true,
        "qrDescription": "Description for QR code",
        "createdAt": "2022-05-25T16:17:01.797Z",
        "updatedAt": "2022-05-25T16:17:01.797Z"
      },
      "name": "Metaprotocol Factory"
    }
  ],
  "count": 1
}