🔃Evolve NFTs

Generate multiple NFTs for an existing SmartContract.

Endpoint

POST /v1/nft/generate-nft/:smartContractId?evolveNFT=true

Authentication

API key is required in the headers.

Path Parameters

Parameter	Type	Description
smartContractId	string	The unique identifier of the SmartContract.

Request Body

The request body should be an array of objects, each containing the following parameters: Note that at least one of those fields userWallet or email should be present in the request.

Parameter	Type	Description	Required
metadata	object[]	An array of NFT metadata objects containing image, name, description, and attributes.

NFT Metadata Object:

Parameter	Type	Description	Required
image	string	The image URL for the NFT.
name	string	The name of the NFT.
idToEnvolve	string	Id (0,1,2...) Of NFT
description	string	The description of the NFT.
attributes	object[]	An array of attribute objects containing key-value pairs describing the NFT.

Attribute Object:

Parameter	Type	Description
key	string	The key or name of the attribute.
value	string	The value or description of the attribute.

Example

RAW

POST /v1/nft/generate-nft/12345?evolveNFT=true

Headers:
API_KEY: YOUR_API_KEY
Content-Type: application/json

Body:
[
  {
    "metadata": [
      {
        "image": "<SOME_IMAGE URL>", // imageName (if use upload-image)
        "name": "First NFT evolved",
        "description": "This is the first NFT evolved",
        "idToEvolve" : 0,
        "attributes": [
          {
            "key": "Characteristic evolved",
            "value": "Characteristic Value evolved"
          },
          {
            "key": "Characteristic 2",
            "value": "Characteristic Value 2"
          }
        ]
      },
      {
        "image": "<SOME_IMAGE URL>",
        "name": "Second NFT evolved",
        "idToEvolve" : 1,
        "description": "This is the second NFT evolved",
        "attributes": [
          {
            "key": "Characteristic evolved ",
            "value": "Characteristic Value 1"
          },
          {
            "key": "Characteristic 2",
            "value": "Characteristic Value 2"
          }
        ]
      }
    ]
  }
]

Response

• result: Response data

  • totalToMint: Total NFTs to mint at this moment

  • addresses: NFT sending address

  • amounts: Number of NFTs to mint for each address

  • uris: IPFS urls for each NFT

  • ids: ids NFT in Backend

  • smartContractAddress: Smart Contract Address

  • blockchain: Blockchain

  • blockchainId: Decimal chain id

• error: Error data if request fail

Status: 200 OK

{
    "result": {
        "totalToMint": 6,
        "addresses": [
            "0x11112222333344445555666677778888",
            "0x88887777666655554444333322221111"
        ],
        "amounts": [
            1,
            1
        ],
        "uris": [
            "XXXX",
            "YYYY",
        ],
        "ids": [
            0,
            1,
        ],
        "_ids": [
            "660e02406878e6ef809b9667",
            "660e02406878e6ef809b9668"
        ],
        "smartContractAddress": "Ox...",
        "smartContractId": "<smartContract_id>",
        "typeBlockchain": 4,
        "blockchainId": "80001",
        "nftsCreated": [
            {
                "smartContractId": "660d6e384c23124d6a0653ad",
                "ipfsUrl": "QmVmSzvth73L4xeYS7CZXSusWyeUTRsPPHxDLioY9pm3JF",
                "path": "6dcc04e9-61a0-4e04-8e0a-b579c8e7462b.png",
                "json": "6fb00a0c04a05ed646438a38ef7c83c1.json",
                "idNFT": 0,
                "name": "NFT Evolved",
                "description": "Tests",
                "ipfsImage": "ipfs://QmU5YHNmQn3dNsrGXKMfCBWpNbY63dJUvk9RWu3XNkMtmd",
                "wallet": "020361b86e8e6cbd50a9d2589b9d8de43565f32bfa4439ef41cd78a9054caed63979",
                "contentType": "image/png",
                "status": 0,
                "type": 1,
                "isEvolution": true,
                "attributes": [
                    {
                        "key": "Version",
                        "value": "2.0"
                    },
                    {
                        "key": "Test",
                        "value": "1"
                    }
                ],
                "includeMint": true,
                "paid": false,
                "_id": "660e02406878e6ef809b9667",
                "__v": 0,
                "createdAt": "2024-04-04T01:28:32.486Z",
                "updatedAt": "2024-04-04T01:28:32.486Z"
            },
            {
                "smartContractId": "660d6e384c23124d6a0653ad",
                "ipfsUrl": "QmVmSzvth73L4xeYS7CZXSusWyeUTRsPPHxDLioY9pm3JF",
                "path": "6dcc04e9-61a0-4e04-8e0a-b579c8e7462b.png",
                "json": "6fb00a0c04a05ed646438a38ef7c83c1.json",
                "idNFT": 1,
                "name": "NFT Evolved 2",
                "description": "Tests 2",
                "ipfsImage": "ipfs://QmU5YHNmQn3dNsrGXKMfCBWpNbY63dJUvk9RWu3XNkMtmd",
                "wallet": "020361b86e8e6cbd50a9d2589b9d8de43565f32bfa4439ef41cd78a9054caed63979",
                "contentType": "image/png",
                "status": 0,
                "type": 1,
                "isEvolution": true,
                "attributes": [
                    {
                        "key": "Version",
                        "value": "2.0"
                    },
                    {
                        "key": "Test",
                        "value": "2"
                    }
                ],
                "includeMint": true,
                "paid": false,
                "_id": "660e02406878e6ef809b9667",
                "__v": 0,
                "createdAt": "2024-04-04T01:28:32.486Z",
                "updatedAt": "2024-04-04T01:28:32.486Z"
            }
        ]
    },
    "error": null
}

CURL

curl --location --request POST 'https://api-testnet.minteando.me/v1/nft/generate-nft/62e6cb8cece6b853fb6db8b4' \
--header 'API_KEY: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "metadata": [
      {
        "image": "<SOME_IMAGE URL>", // imageName (if use upload-image)
        "name": "First NFT evolved",
        "description": "This is the first NFT evolved",
        "idToEvolve" : 0,
        "attributes": [
          {
            "key": "Characteristic evolved",
            "value": "Characteristic Value evolved"
          },
          {
            "key": "Characteristic 2",
            "value": "Characteristic Value 2"
          }
        ]
      },
      {
        "image": "<SOME_IMAGE URL>",
        "name": "Second NFT evolved",
        "idToEvolve" : 1,
        "description": "This is the second NFT evolved",
        "attributes": [
          {
            "key": "Characteristic evolved ",
            "value": "Characteristic Value 1"
          },
          {
            "key": "Characteristic 2",
            "value": "Characteristic Value 2"
          }
        ]
      }
    ]
  }
]'

Example Typescript (axios)

import axios, { AxiosResponse } from 'axios';

interface Attribute {
  key: string;
  value: string;
}

interface NFTMetadata {
  image?: string;
  name: string;
  description: string;
  attributes?: Attribute[];
}

interface NFTGenerationRequest {
  userWallet?: string;
  email?: string;
  metadata: NFTMetadata[];
}

interface GeneratedNFT {
  tokenId: string;
  userWallet: string;
}

const API_KEY = 'YOUR_API_KEY';
const smartContractId = '12345';
const endpoint = `https://api-testnet.minteando.me/v1/nft/generate-nft/${smartContractId}`;

// Set request headers
const headers = {
  API_KEY,
  'Content-Type': 'application/json',
};

// Request body
const requestBody: NFTGenerationRequest[] = [
  {
    metadata: [
      {
        image: '<SOME_IMAGE>',
        name: 'First NFT evolved',
        idToEvolve : 1,
        description: 'This is the first NFT evolved',
        attributes: [
          { key: 'Characteristic 1', value: 'Characteristic Value 1' },
          { key: 'Characteristic 2', value: 'Characteristic Value 2' },
        ],
      },
      {
        image: '<SOME_IMAGE>',
        name: 'Second NFT evolved',
        description: 'This is the second NFT evolved',
        idToEvolve : 1,
        attributes: [
          { key: 'Characteristic 1', value: 'Characteristic Value 1' },
          { key: 'Characteristic 2', value: 'Characteristic Value 2' },
        ],
      },
    ],
  },
];

// Make the request
axios
  .post(endpoint, requestBody, { headers })
  .then((response: AxiosResponse) => {
    const responseData = response.data;
    // Process the response data
    console.log(responseData);
  })
  .catch((error) => {
    console.error('Error:', error.message);
  });

Example PHP

<?php

$apiKey = 'YOUR_API_KEY';
$smartContractId = '12345';
$endpoint = "https://api-testnet.minteando.me/v1/nft/generate-nft/{$smartContractId}";

// Request data
$requestData = [
    [
        "userWallet" => "0x11112222333344445555666677778888",
        "metadata" => [
            [
                "image" => "<SOME_IMAGE>",
                "name" => "First NFT",
                "description" => "This is the first NFT",
                "attributes" => [
                    [
                        "key" => "Characteristic 1",
                        "value" => "Characteristic Value 1"
                    ],
                    [
                        "key" => "Characteristic 2",
                        "value" => "Characteristic Value 2"
                    ]
                ]
            ]
        ]
    ],
    [
        "userWallet" => "0x88887777666655554444333322221111",
        "metadata" => [
            [
                "image" => "<SOME_IMAGE>",
                "name" => "Second NFT",
                "description" => "This is the second NFT",
                "attributes" => [
                    [
                        "key" => "Characteristic 1",
                        "value" => "Characteristic Value 1"
                    ],
                    [
                        "key" => "Characteristic 2",
                        "value" => "Characteristic Value 2"
                    ]
                ]
            ]
        ]
    ]
];

// Create request headers
$headers = [
    'API_KEY: ' . $apiKey,
    'Content-Type: application/json'
];

// Initialize cURL
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $endpoint);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestData));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Execute the request
$response = curl_exec($ch);

// Check for errors
if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    // Process the response
    $responseData = json_decode($response, true);
    // Do something with the response data
    var_dump($responseData);
}

// Close cURL
curl_close($ch);
?>