Mint Tokens

To mint and airdrop unique digital assets, you can follow the guide on the Quickstart. For more detail, please check the API reference. You can watch a quick video tutorial for this here.

SFTs (semifungible tokens) follow the ERC-1155 standard. Each token is a replica of a predefined template. Each collection (smart contract) can contain multiple templates, which can contain many tokens.

To get started, it’s recommended to read the Introduction for general information on how the minting product works.

​

1. Create an SFT collection to hold your templates

  curl --request POST \
    --url https://staging.crossmint.com/api/2022-06-09/collections \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --header 'x-api-key: YOUR_API_KEY' \
    --data '
{
    "chain": "polygon",
    "fungibility": "semi-fungible",
    "metadata": {
      "name": "My New Collection",
      "imageUrl": "https://www.crossmint.com/assets/crossmint/logo.png",
      "description": "A new collection with its own dedicated smart contract"
    }
}'

​

2. Create a template within that collection

curl --request POST \
  --url https://staging.crossmint.com/api/2022-06-09/collections/{COLLECTION_ID}/templates \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '
  {
    "onChain": {
      "tokenId": "2"
    },
    supply: {
      limit: 10
    },
    "metadata": {
      "name": "My template",
      "image": "https://www.crossmint.com/assets/crossmint/logo.png",
      "description": "A new token template for my ERC1155 collection"
    }
  }'

​

3. Mint an SFT from a template

Mint SFTs from the template and send them to wallets or email addresses.

  curl --request POST \
    --url https://staging.crossmint.com/api/2022-06-09/collections/{COLLECTION_ID}/sfts \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --header 'x-api-key: YOUR_API_KEY' \
    --data '
    {
      "templateId": "58b0c1aa-e457-48dd-bb55-5a27e6a92f74",
      "recipient": "email:user@example.com:polygon",
      "amount": 1
    }'

All set!

To confirm delivery, use the transaction status API or set up a webhook.

​

What are Compressed NFTs?

Compressed NFTs are a new standard on the Solana blockchain, for minting NFTs with the lowest cost amongst L1 and L2 blockchains, and the highest throughput (thousands of NFTs per second). Read more details about how it works here.

Using this standard to mint NFTs is extremely complicated if you manage everything on your own. On top of the intrinsic complexity usually required to mint a regular NFT, compressed NFTs require deploying and managing Merkle trees, batching, and dealing with nascent infrastructure. Crossmint also supports updating the NFT metadata after minting. Please refer to this doc page.

Here’s where Crossmint can help: we’ve done all the hard work so that minting compressed NFTs is no harder than minting regular ones: all it takes is a single API call, and you can even use one of Crossmint’s no-code tools to do so.

​

Current Protocol Limitations

• There’s a 10-30 second delay between when an NFT is minted and it shows in wallets.

​

How to use the Minting API with Compressed NFTs

The Minting API for Compressed NFTs is exactly the same as for regular NFTs, but it only works on the Solana blockchain.

POST https://staging.crossmint.com/api/2022-06-09/collections/<collection-id>/nfts

curl --request POST \
  --url https://staging.crossmint.com/api/2022-06-09/collections/default-solana/nfts \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
    "recipient": "solana:VALID_SOLANA_WALLET_ADDRESS",
    "metadata": {
      "name": "Crossmint Example NFT",
      "image": "https://www.crossmint.com/assets/crossmint/logo.png",
      "description": "My NFT created via the mint API!"
    },
    "compressed": true,
    "reuploadLinkedFiles": false
  }'

The above will return an NFT ID. Use it in the next call to retrieve the mint status.

curl --request GET \
  --url https://staging.crossmint.com/api/2022-06-09/collections/{COLLECTION_ID}/nfts/{YOUR_NFT_ID} \
  --header 'X-API-KEY: X_API_KEY'

Be sure to replace:

• X_API_KEY, {COLLECTION_ID} and {YOUR_NFT_ID}
• Recipient: change VALID_WALLET_ADDRESS with the wallet you want to send the NFT to
• Metadata: add the name, image, and description.

There are two ways to set the transferrability of NFTs:

1. Defining it at the smart contract level
2. If you are using custodial wallets, enabling or disabling transfers from the frontend

If you want to configure it at the smart contract level, see the following endpoints: