ERC1155 NFT Tokens
Create a new ERC1155 NFT Token
POST
https://api.nfty.dev/v1/nfts
This endpoint creates and mints a new NFT from the given hosted ERC1155 Collection to a destination wallet address. It allows you to optionally specify a custom metadata URI for just this token_id
, so it will not follow the scheme defined for the rest of the Collection. The address can be an NFT Wallet that you created using the APIs or any external address/wallet that supports ERC1155 NFTs.
NFTYverse will handle uploading and hosting all the metadata and optionally the images and media as well. This API should only be used on hosted ERC1155 Collections. If you prefer to host the metadata yourself, you can create a "Self-Hosted" ERC1155 Collection and use the "Self-Hosted" version of the API below.
When using this API, the token_id
cannot already be created. So you need to call this API first and only once for a given token_id
.
Headers
Name | Type | Description |
---|---|---|
Authorization | string | Your authorization token |
Request Body
Name | Type | Description |
---|---|---|
uri | string | A custom URI for this token's metadata. If set, this token will not follow the scheme defined for the rest of the Collection. |
token_id | integer | For ERC1155 NFTs, you need to specify an ID for each token that you mint. They don't have to be sequential. If you later call mint with a previously created |
initial_supply | integer | The initial number of identical tokens you want to create for this |
collection_address | string | The address of the collection you created using the Create NFT Collection API. |
initial_owner | string | The destination address for the newly created NFT. It can be an NFT Wallet or any external address that supports ERC1155 NFTs. |
image | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
external_url | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
description | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards Note: you can add the string |
name | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards Note: you can add the string |
attributes | array | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
background_color | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
animation_url | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
youtube_url | string | NFT metadata as defined here: https://docs.opensea.io/docs/metadata-standards |
copy_media | boolean | Set this to true if you would like NFTYverse to copy and upload your |
unlockable_content | string | This optional string represents "unlockable content" that only the NFT token holder should be able to view. You can use it to create hidden text or links that are attached to this NFT, such as passwords or special access codes to your content - turning your NFT into a digital key and proof of ownership. The string is stored in the NFTYverse database off-chain. It is then returned by the API when listing NFT Wallet contents for the user who owns this NFT. |
Example Request:
Example Response:
Create a new ERC1155 NFT Token (Self-Hosted)
POST
https://api.nfty.dev/v1/nfts
This endpoint creates and mints a new NFT from the given "Self-Hosted" ERC1155 Collection to a destination wallet address. It allows you to optionally specify a custom metadata URI for just this token_id
, so it will not follow the base_uri
scheme defined for the Collection. The address can be an NFT Wallet that you created using the APIs or any external address/wallet that supports ERC1155 NFTs.
"Self-Hosted" means that you will be hosting the metadata and optionally the media yourself. This API should only be used on "Self-Hosted" ERC1155 Collections. If you prefer to have NFTYverse handle and host the metadata, please create a hosted ERC1155 Collection and check out the regular hosted API above.
When using this API, the token_id
cannot already be created. So you need to call this API first and only once for a given token_id
.
Headers
Name | Type | Description |
---|---|---|
Authorization | string | Your authorization token |
Request Body
Name | Type | Description |
---|---|---|
uri | string | A custom URI for this token's metadata. If set, this token will not follow the |
token_id | integer | For ERC1155 NFTs, you need to specify an ID for each token that you mint. They don't have to be sequential. If you call mint again with a previously created |
initial_supply | integer | The initial number of identical tokens you want to create for this |
collection_address | string | The address of the collection you created using the Create NFT Collection API. |
initial_owner | string | The destination address for the newly minted NFT. It can be an NFT Wallet or any external address that supports ERC1155 NFTs. |
Example Request:
Example Response:
Mint additional ERC1155 NFT Tokens
POST
https://api.nfty.dev/v1/nfts
This endpoint mints additional NFT tokens for a token_id
from the given hosted ERC1155 Collection and sends them to the destination wallet address. The token_id
must already exist and should be created via the create APsI above. The quantity of that token_id will increase by quantity
. The address can be an NFT Wallet that you created using the APIs or any external address/wallet that supports ERC1155 NFTs.
This API can be used for both hosted and "Self-Hosted" ERC1155 Collections.
When using this API, the token_id
must already be created using the create API above. So you can only call this API after you have already created the token_id
already.
Headers
Name | Type | Description |
---|---|---|
Authorization | string | Your authorization token |
Request Body
Name | Type | Description |
---|---|---|
token_id | integer | Specify the existing ID for each token that you mint. When you call mint with a previously created |
quantity | integer | The additional number of identical tokens you want to create for this |
collection_address | string | The address of the collection you created using the Create NFT Collection API. |
to_address | string | The destination address for the newly created NFT. It can be an NFT Wallet or any external address that supports ERC1155 NFTs. |
Example Request:
Example Response:
Last updated