Mint NFT (fungible and non-fungible)

Create NFTs based on a predefined NFT template (token-type)

Endpoint: POST

Requires Authority: mint:tokens

POSThttps://nft-api.venly.io/api/minter/contracts/{contractId}/types/{typeId}/tokens

Authorization

OAuth2

Path parameters

contractId*integer

typeId*integer

Body

application/json

destinations*array of TokenDestination (object)

Response

200400401403404405415500

OK

Body

*/*

metadataMetadataDto (object)

mintedTokensarray of MintedTokenDestination (object)

Request

JavaScriptCurl

const response = await fetch('https://nft-api.venly.io/api/minter/contracts/{contractId}/types/{typeId}/tokens', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "destinations": [
        {}
      ]
    }),
});
const data = await response.json();

Response

[
  {
    "mintedTokens": [
      {
        "destination": "text",
        "txHash": "text"
      }
    ]
  }
]

Body

Minting non-fungile tokens

{
  "destinations": [
    {
      "address": "0xe3A801b655dCe11CCfD5EF7aF9EC4EEAB62d3A04"
    }
  ]
}

Minting fungible tokens

Use this, when you have defined fungible: true in the token type

In this case, the amount of tokens to be minted needs to be specified.

{
  "destinations": [
    {
      "address": "0xe3A801b655dCe11CCfD5EF7aF9EC4EEAB62d3A04",
      "amount": 3
    }
  ]
}

Since destinations is an array it is possible to provide a list of addresses, this will result in minting one NFT for each address.

🧙 The "address" of a transfer is not limited to a blockchain address, we also support email addresses.

Returns

[
    {
        "transactionHash": "0x60d6e420d33e8192e0735852384f16e393fe87516a167af67cfac0006ce67cbe",
        "metadata": {
            "name": "Chuck The Rooster",
            "description": "Chuck is a Male Tall Chicken Who is the Leader of The Chicken Siblings. He is Cool, Daring and Wacky. He can be Selfish and Stubborn When it Comes To Challenges, But he is An True Softie when it Comes To His Siblings. In Rebel to the Beak, It revealed that He is Allergic to Monstonuts and In The Good, The Bad and The Clucky, It also Revealed that He Used to Be one Of the Scouts from Slurp,s Little Cowboys Scout Camp along With Finley, Ainta and Hugo. He is the youngest of the three.",
            "image": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
            "imagePreview": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
            "imageThumbnail": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
            "backgroundColor": "#eeeeee",
            "background_color": "#eeeeee",
            "externalUrl": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
            "external_url": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
            "animationUrls": [],
            "attributes": [
                {
                    "type": "property",
                    "name": "Talent",
                    "value": "Leadership",
                    "traitType": "Talent",
                    "trait_type": "Talent"
                },
                {
                    "type": "property",
                    "name": "Allergic",
                    "value": "Monstonuts",
                    "traitType": "Allergic",
                    "trait_type": "Allergic"
                },
                {
                    "type": "property",
                    "name": "Hobby",
                    "value": "Scouts",
                    "traitType": "Hobby",
                    "trait_type": "Hobby"
                }
            ],
            "contract": {
                "address": "0xd3343d667d8d2c1c9dc6fe36d2b3f6b569e4d08b",
                "name": "Space Chickens",
                "symbol": "SPACECHICKS",
                "image": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "imageUrl": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "image_url": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "description": "Space Chickens in Space is an American-Australian-Mexican-British-Irish animated television series produced by Ánima Estudios in Mexico, Studio Moshi in Australia. A trio of chickens—Chuck, Starley and Finley—are taken from their home and mistakenly enrolled in an elite intergalactic former military academy. It would take all their strength, and teamwork, to survive every escapade they have.",
                "externalLink": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "external_link": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "externalUrl": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "external_url": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "media": [
                    {
                        "type": "image",
                        "value": "https://dg31sz3gwrwan.cloudfront.net/fanart/355763/1357791-0-q80.jpg"
                    }
                ],
                "type": "ERC_1155"
            },
            "asset_contract": {
                "address": "0xd3343d667d8d2c1c9dc6fe36d2b3f6b569e4d08b",
                "name": "Space Chickens",
                "symbol": "SPACECHICKS",
                "image": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "imageUrl": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "image_url": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
                "description": "Space Chickens in Space is an American-Australian-Mexican-British-Irish animated television series produced by Ánima Estudios in Mexico, Studio Moshi in Australia. A trio of chickens—Chuck, Starley and Finley—are taken from their home and mistakenly enrolled in an elite intergalactic former military academy. It would take all their strength, and teamwork, to survive every escapade they have.",
                "externalLink": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "external_link": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "externalUrl": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "external_url": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
                "media": [
                    {
                        "type": "image",
                        "value": "https://dg31sz3gwrwan.cloudfront.net/fanart/355763/1357791-0-q80.jpg"
                    }
                ],
                "type": "ERC_1155"
            },
            "fungible": false
        },
        "destinations": [
            "0xe3A801b655dCe11CCfD5EF7aF9EC4EEAB62d3A04"
        ],
        "tokenIds": [
            51
        ]
    }
]