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
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
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.
2
2
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
1
21592868
Best token name
55
55
Stringified array of tokens with chain ID (optional), contract address, and token ID
[{"chainId":11155111,"contractAddress":"0x91945DCD15b44eB33dE4D00897843C1Ee524fA88","tokenId":3},{"chainId":80002,"contractAddress":"0x91945DCD15b44eB33dE4D00897843C1Ee524fA88","tokenId":1234}]
asduf823hf-sa98ehf938rh
0xd1afbab5cacb45491ce002a6026c1401340eae6a
5a945f88-1de8cb-c6a1b4-1314ebac6bd1
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
}
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
asduf823hf-sa98ehf938rh
0xd1afbab5cacb45491ce002a6026c1401340eae6a
5a945f88-1de8cb-c6a1b4-1314ebac6bd1
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.
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
1
Sort by..
desc
Possible values: Sort by..
desc
Possible values: Sort by..
desc
Possible values: 2
2
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.
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
1
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.
2
2
1
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
}
asduf823hf-sa98ehf938rh
0xd1afbab5cacb45491ce002a6026c1401340eae6a
5a945f88-1de8cb-c6a1b4-1314ebac6bd1
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.
2
2
1
/^([-\w]+ )+[-\w]+$|^[-\w]+$/
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.
2
2
0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377
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