NFT Marketplace and Royalty Setup

When selling NFTs on secondary markets, you can configure royalties to receive a percentage of each sale and optimize your collection’s marketplace profile to attract buyers.

Sell Tokens

The minting guide showed you how to create NFTs. In this guide you will learn how to enable Crossmint’s Checkout so you can sell them to your customers using cryptocurrency or credit card.

How It Works

You can set a price in crypto (ETH, MATIC, SOL or USDC).
For imported and secondary collections, payouts arrive instantly. For managed collections, payouts arrive after a 24-hour withholding period.
Your customers can pay with crypto or credit card.
You pay credits for NFT gas, user pays only for the item.

Configure a Collection for Sale

Create an NFT collection and navigate to it in the console.
Upload NFT “templates” for all the NFTs you wish to list for sale. You can do so from the “NFTs” tab in the console, or by using the API.
Navigate to the Checkout entry on the navbar in the collections page. Follow the wizard to enable payments.
(Production only) Verify your account and collection. Not required in staging.
Share the url or QR code with your users.

Create an NFT collection and navigate to it in the console.
Upload NFT “templates” for all the NFTs you wish to list for sale. You can do so from the “NFTs” tab in the console, or by using the API.
Navigate to the Checkout entry on the navbar in the collections page. Follow the wizard to enable payments.
(Production only) Verify your account and collection. Not required in staging.
Share the url or QR code with your users.

Enable at collection creation time

Pass a payments object to the Collection Creation API with the, and . You can optionally set up a to cap the collection supply.

See example

The following snippet creates a new sales-enabled collection:

curl --request POST \
    --url https://staging.crossmint.com/api/2022-06-09/collections/ \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: <api-key>' \
    --data '{
    "chain": "polygon",
    "fungibility": "non-fungible",
    "metadata": {
    "description": "This is a sample NFT collection",
    "imageUrl": "https://www.crossmint.com/assets/crossmint/logo.png",
    "name": "Sample NFT Collection",
    },
    "payments": {
    "price": "<string>",
    "recipientAddress": "<string>",
    "currency": "usdc"
    },
    "supplyLimit": 123
}'

Enable on an existing collection

If you had already created a collection, use the Update Collection API to enable sales on it.

Enabling sales in production requires verifying your account.

Set Up a Checkout

Now that your collection accepts payments, the next step is to integrate one of Crossmint’s Checkout variants into your app or website, and start accepting sales.

There are two ways to integrate:

Hosted Checkout

Add a button to your site which opens a checkout in a pop-up or new tab.

Embedded Checkout

Insert a checkout inside your site for maximum control over the user experience.

Set Collection Royalties

With royalties, you can receive revenue when your NFTs are traded on secondary markets. Crossmint allows you to configure royalties for a collection via API and (soon) directly from the console. You just have to specify the % of royalties and where you want those funds to be sent.

Royalties are defined at the collection level, not at the NFT level. Updating the royalties of a collection will update all NFTs, including the ones which have already been minted.

This API follows royalty standards compatible with virtually all marketplaces. However, note that some marketplaces have determined to not honor royalties, so transactions occuring there may not generate additional revenue.

Available self-serve for ERC-721 collections in EVM chains. Please contact us for ERC-1155 or Solana support.

Endpoint	Description
Add / Edit Royalties	Add or edit royalties
Get Royalty Information	Get royalty information
Disable Royalties	Disable royalties

Add / Edit Royalties

To add or edit royalties for a collection, use the following API endpoint:

cURL

curl --request POST \
  --url https://staging.crossmint.com/api/v1-alpha1/minting/collections/{collectionId}/royalties \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "recipients": [
    {
      "address": "0x123...",
      "percentage": 5
    }
  ]
}'

Get Royalty Information

To retrieve the current royalty configuration for a collection:

cURL

curl --request GET \
  --url https://staging.crossmint.com/api/v1-alpha1/minting/collections/{collectionId}/royalties \
  --header 'X-API-KEY: <api-key>'

Disable Royalties

To disable royalties for a collection:

cURL

curl --request DELETE \
  --url https://staging.crossmint.com/api/v1-alpha1/minting/collections/{collectionId}/royalties \
  --header 'X-API-KEY: <api-key>'

Implementation Examples

Setting up royalties for a new collection

// Example: Setting up royalties for a new collection
const apiKey = "YOUR_API_KEY";
const collectionId = "your-collection-id";
const env = "staging"; // or "www" for production

// Define royalty recipients
const royaltyRecipients = [
  {
    address: "0x123abc...", // Creator wallet
    basisPoints: 5 // 5% royalty
  },
  {
    address: "0x456def...", // Community fund wallet
    basisPoints: 2.5 // 2.5% royalty
  }
];

// Set up royalties
const url = `https://${env}.crossmint.com/api/v1-alpha1/minting/collections/{collectionId}/royalties`;
const options = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": apiKey
  },
  body: JSON.stringify({
    recipients: royaltyRecipients
  })
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log("Royalties configured:", data))
  .catch(error => console.error("Error configuring royalties:", error));

Marketplace Profile

Optimizing your collection’s profile on marketplaces like OpenSea, Rarible, and others can significantly impact your NFT sales and visibility.

At this time, updating your collection profile on OpenSea, Rarible, and other marketplaces requires manual work and is limited to enterprise clients.

Key Marketplace Profile Elements

When working with our enterprise team to configure your marketplace profile, consider these important elements:

Collection Banner: A high-quality banner image that represents your brand
Collection Logo: A distinctive logo that’s recognizable at small sizes
Collection Description: A compelling description of your project and its value
External Links: Links to your website, social media, and community channels
Category Tags: Appropriate categories that help collectors discover your NFTs

FAQs

How are royalties enforced on different marketplaces?

Can I set different royalty percentages for different NFTs in the same collection?

How quickly do royalty changes take effect?

What's the maximum royalty percentage I can set?

Introduction

Wallets

Authentication

Tokenization (Minting)

Verifiable Credentials

Checkout

List for Sale

Sell Tokens

How It Works

Configure a Collection for Sale

Set Up a Checkout

Hosted Checkout

Embedded Checkout

Set Collection Royalties

Add / Edit Royalties

Get Royalty Information

Disable Royalties

Implementation Examples

Marketplace Profile

Key Marketplace Profile Elements

FAQs

Introduction

Wallets

Authentication

Tokenization (Minting)

Verifiable Credentials

Checkout

​Sell Tokens

​How It Works

​Configure a Collection for Sale

​Set Up a Checkout

Hosted Checkout

Embedded Checkout

​Set Collection Royalties

​Add / Edit Royalties

​Get Royalty Information

​Disable Royalties

​Implementation Examples

​Marketplace Profile

​Key Marketplace Profile Elements

​FAQs

Sell Tokens

How It Works

Configure a Collection for Sale

Set Up a Checkout

Set Collection Royalties

Add / Edit Royalties

Get Royalty Information

Disable Royalties

Implementation Examples

Marketplace Profile

Key Marketplace Profile Elements

FAQs