Quickstart ⚡

In this quickstart, you will create a new wallet for your users, and then showcase the NFTs inside it, all in under 5 minutes.

​

1. Create a Developer Account

To get started, create an developer account in the staging Crossmint Console. Open that link, sign in, and accept the dialog to continue.

​

2. Get an API key

Once you log in to the console, the next step is to create an API key: a secret credential required to call the API.

Go to the API Keys tab, click on New API Key, and select the scopes wallets.read, wallets.create, and wallets:nfts.read. Once you’re done, copy your API KEY. You will need it in the next step.

​

3. Create a wallet

Once you have your API key, you’re ready to create your first wallet via API.

The API takes the following parameters:

• email: User’s email address. Contact us if you wish to pass an arbitrary string as a UUID instead of an email.
• chain: The blockchain in which you want to create the wallet. This example uses “polygon” (or its testnet, “amoy” in staging).

Copy the following code and fill in the client-secret and project-id headers with the information from the API keys you just created:

curl --request POST \
  --url https://staging.crossmint.com/api/v1-alpha1/wallets \
  --header 'X-API-KEY: <YOUR_API_KEY>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '
{
  "chain": "polygon",
  "email": "youremailhere@gmail.com"
}'

That’s it! Once you’ve run this, your new wallet will be created. You can enter that wallet’s public address into a block explorer (for the example above, that will be the Sepolia block explorer: https://sepolia.etherscan.io/) to see transactions as you make them. 🎉

​

4. [Optional] Show the NFTs to your users

The following code retrieves the NFTs on the wallet and renders a grid with the assets so you can display them on your site.

Pre-requisite: You’ll need to send an NFT to this newly created wallet in the same chain you create the wallet on - in this case, “polygon”. You can send one using Crossmint’s Minting API in under 5 minutes.

To get started:

1. First, add the Crossmint Client SDK to your project

yarn add @crossmint/client-sdk-react-ui

2. Render a grid with all the NFTs

Use the CrossmintNFTCollectionView component:

curl --request GET \
  --url 'https://staging.crossmint.com/api/v1-alpha1/wallets?email=youremailhere%40gmail.com' \
  --header 'X-API-KEY: <YOUR_API_KEY>' \
  --header 'accept: application/json'

import { CrossmintNFTCollectionView } from "@crossmint/client-sdk-react-ui";

const wallets = [
    {
        chain: "solana",
        publicKey: "<SOL_ADDRESS>",
    },
    {
        chain: "ethereum",
        publicKey: "<ETH_ADDRESS>",
    },
];

export default function yourPage() {
    return (
        <div style={{ height: "100vh" }}>
            <CrossmintNFTCollectionView wallets={wallets} />
        </div>
    );
}