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.

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
get
GET /tokens/{address}/id/{id} HTTP/1.1
Host: v1
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
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
get
GET /internal/tokens/rich HTTP/1.1
Host: v1
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
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
get
GET /internal/tokens/{address}/id/{id}/rich HTTP/1.1
Host: v1
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
get
GET /owners/{address}/id/{_tokenId} HTTP/1.1
Host: v1
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:
get
GET /minting-status/{address}/id/{_tokenId} HTTP/1.1
Host: v1
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
get
GET /tags HTTP/1.1
Host: v1
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
Header parameters
AuthorizationstringRequired

asduf823hf-sa98ehf938rh

x-account-walletstringRequired

0xd1afbab5cacb45491ce002a6026c1401340eae6a

x-account-useridstringRequired

5a945f88-1de8cb-c6a1b4-1314ebac6bd1

Body
tagNamestring · max: 20Required
Responses
201Success
application/json
post
POST /tags HTTP/1.1
Host: v1
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
get
GET /categories HTTP/1.1
Host: v1
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
get
GET /nft-search/{searchText} HTTP/1.1
Host: v1
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
}

Last updated