Create an NFT

Create an NFT

This endpoint allows you to create a new NFT.

post

/v1/nfts

Authorizations

Body

namestringrequired

Name for you NFT

descriptionstring

Description for your NFT

imagestringrequired

URL pointing to an image for your NFT

managedboolean

Mints the NFT in a Token Manager

upsertboolean

Allows updating an NFT if one already exists with the same owner and collection address

ownerAddressstring

Wallet Address of the owner of the NFT

collectionAddressstring

Mint address for the NFT Collection

attributesobject

Key-value pairs where the key is the attribute name and the value is the attribute value.

Example: {"Overall":"0","Clout":"0","Credibility":"0"}

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.underdogprotocol.com/v1/nfts' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "description": "text",
    "image": "text",
    "managed": true,
    "upsert": true,
    "ownerAddress": "text",
    "collectionAddress": "text",
    "attributes": {
      "Overall": "0",
      "Clout": "0",
      "Credibility": "0"
    }
  }'

200

202

401

403

404

200

{
  "name": "NFT #1",
  "symbol": "NFT",
  "description": "This is my first NFT",
  "image": "https://example.com/image.png",
  "animationUrl": "https://example.com/animation.mp4",
  "id": 1,
  "projectId": 1,
  "transferable": true,
  "mintAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp",
  "ownerAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp",
  "claimerAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp",
  "status": "text",
  "attributes": {
    "Points": "40000",
    "Nickname": "LeGoat"
  }
}

Returns the upserted NFT

Example

cURL

curl --request POST \
  --url https://api.underdogprotocol.com/v1/nfts \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer {token}" \
  --data '
{
        "collectionAddress": "6TpvoRVJfJe6VdqfML4yjvp9Qc49LuVNb7uzWtPRZzVV",
        "name": "Degenerate Ape",
        "image": "https://arweave.net/6TnZgDc7xDFV_0UFyPgfq2wn6UfRv8-DJgwVwoHfLG4"
}'

JavaScript

import axios from 'axios';

const createNft = async () => {
  try {
    const response = await axios.post('https://api.underdogprotocol.com/v1/nfts', {
      collectionAddress: '6TpvoRVJfJe6VdqfML4yjvp9Qc49LuVNb7uzWtPRZzVV',
      name: 'Degenerate Ape',
      image: 'https://arweave.net/6TnZgDc7xDFV_0UFyPgfq2wn6UfRv8-DJgwVwoHfLG4'
    }, {
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${token}`
      }
    });

    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Response

{
    "mintAddress": "DBqMFAaE8rxJ5emotUywQLWJStGMgGRo3vH52dcKApe6",
    "transactionId": "2eebff8e-67a6-4a30-b7e3-7cec2d3f2160"
}