NFT Ecosystem

Understand our process for building NFTs ecosystems completely through our API endpoints, from creation, minting, metadata creation, to advanced transfer features.

We built out this feature on the API to answer one question...

What if you could build your entire NFT ecosystem through an API?

Naturally, that would be really cool, we're not going to handle full blown image or media uploads by default, this is handled through the tools provided by, or using NFTup for directories.

But with that said, V2 of the API provided these additional features:

  • NFT creation, with automatic royalty fees of 5%

  • Simple NFT minting with batch built-in

  • Metadata generation with strict validation based on the HIP412 specification

  • Mirrornode compatibility, with retryable logic, in case nodes have throttled

  • NFT token transfers

  • Exclusive NFT pass claiming functionality, for ensuring that community members that own a pass can always claim their project tokens with no off-chain storage requirements

All this of course as a simple REST API developer tool for any developer, at any skill level.

For interrogating NFT data during development we recommend using Gomint's NFT explorer or Hashscan before viewing assets in Hashpack.

Understanding the basic flow

Below is the flow to take to start creating NFTs through the API, we will go into more details in the corresponding pages:

Note, that by using these tools for creating NFTs, we will add 5% to the current royalty structure for secondary sales we will receive.

As a developer or project owner, you may fork our repositories and remove this additional royalty, however, you probably will not receive any support from the team and it will make Matt sad...

Our royalty accounts are as follows:

Testnet: 0.0.34319163

Mainnet: 0.0.1119570

Create an NFT

An NFT can be created, before minting, to be viewable on hashgraph ledger.

Create an NFT Collection

Generate Metadata

Metadata is what we refer to a structure that conforms to HIP412, to ensure that it is processable for down-stream clients such as wallets like Hashpack. Upon successful validation you will be provided a CID as a unique reference to an IPFS pin for minting NFTs.

Generate Metadata

Based on feedback we might add metadata helpers for dealing with the output from mass images uploads through the tools provided through NFT storage.

Mint an NFT

Minting a token with an amount and a CID, see above, you may also batch mint 10 at a time if the CID you have used is the same

Mint an NFT

Transfer an NFT to an account

Lastly, you may transfer NFTs to an expected account, this is an attempted transfer and will check. If the treasury can send the NFT and will provide an additional general error if an account hasn't been associated with a given token.

Transfer an NFT

Claimable NFTs through Gated NFT passes

This is our exclusive functionality that enables projects to create NFT passes for their community and then automatically assign child tokens to their pool of NFT passes, through a fair claiming flow.

Claiming NFTs through Passes

Postman Documentation

As before see the documentation in your local postman

Last updated