POST
/
api
/
v1
/
erc1155
/
create
curl 'https://groupos.xyz/api/v1/erc1155/create' \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
  "chainId": 5,
  "contractAddress": "0x67F4732266C7300cca593C814d46bee72e40659F",
  "metadata": {
    "name": "Participation Badge",
    "description": "You did great even if you didnt do well!"
  }
}'

{
  "success": true,
  "tokenId": "1",
}

​
How to create ERC-1155 NFTs

Once you have a ERC-1155 NFT smart contract, you can create any number of tokens. Each ERC-1155 token has a unique tokenId to identify it within the collection and all items of this tokenId share the same metadata. Many people can own the same token and multiple of each token.

After creating an ERC-1155 NFT, you can start distributing NFTs with the Mint ERC-1155 NFTs API.

​
Differences with ERC-721 NFTs

While minting ERC-721 NFTs, the unique tokenId associated with each NFT will auto-increment for you, but minting ERC-1155 NFTs requires an explicit argument for tokenId to indicate which NFT should be minted. For example, one may define NFT 1 as marking a donor, 2 for participating in last season, and 3 for being a attendee at the most recent event.

​
Updating ERC-1155 NFT Metadata

If you need to update the metadata for a particular ERC-1155 token, use the Update NFT Metadata API.

​
Body

chainId
number
required

The id of the chain supporting the NFT. This cannot be changed after creation.

contractAddress
string
required

The NFT smart contract address to mint with.

metadata
object
required

Metadata to associate with this NFT, which overrides any defaults set at the collection-level.

​
Response

success
boolean

Indicates whether the call was successful.

tokenId
string

The unique id for the NFT within the collection.

Query NFTsMint NFTs